resurfaceio-logger-python

Easily log API requests and responses to your own system of record.

Contents

• Dependencies
• Installing With pip
• Logging From AIOHTTP
• Logging From Django
• Logging From Flask
• Logging From Requests
• Logging With API
• Protecting User Privacy

Dependencies

Requires Python 3.7 or higher and a requests HTTP library. No other dependencies to conflict with your app.

Installing With pip

pip3 install --upgrade usagelogger

Logging From AIOHTTP

fromaiohttpimportwebfromusagelogger.aiohttpimportHttpLoggerForAIOHTTPasyncdeftest(request):
returnweb.Response(text="Hello")
app=web.Application(
middlewares=[
HttpLoggerForAIOHTTP(
url="http://localhost:4001/message", rules="include debug"
)
]
)
app.router.add_get("/", test)
web.run_app(app)

Logging From Django

First edit settings.py to register middleware, like this:

MIDDLEWARE= [
"django.middleware...",
"usagelogger.django.HttpLoggerForDjango",
]

Then add a new section to settings.py for logging configuration, like this:

USAGELOGGER= {
'url': 'http://localhost:4001/message',
'rules': 'include debug'
}

Logging From Flask

fromflaskimportFlaskfromusagelogger.flaskimportHttpLoggerForFlaskapp=Flask(__name__)
app.wsgi_app=HttpLoggerForFlask( # type: ignoreapp=app.wsgi_app, url="http://localhost:4001/message", rules="include debug"
)
@app.route("/")defhome():
return"This route works!"app.run(debug=True)

Logging From Requests

fromusageloggerimportresurfaces=resurface.Session(url="http://localhost:4001/message", rules="include debug")
s.get(...)

Logging With API

Loggers can be directly integrated into your application using our API. This requires the most effort compared with the options described above, but also offers the greatest flexibility and control.

API documentation

Protecting User Privacy

Loggers always have an active set of rules that control what data is logged and how sensitive data is masked. All of the examples above apply a predefined set of rules (include debug), but logging rules are easily customized to meet the needs of any application.

Logging rules documentation

---

© 2016-2021 Resurface Labs Inc.