Various logging-related utilities for Django projects.
Project description
Various logging-related utilities for Django projects. For now, it provides a LoggingMiddleware class.
Quickstart
Install django-logutils:
pip install django-logutils
LoggingMiddleware
LoggingMiddleware is middleware class for Django, that logs extra request-related information. To use it in your Django projects, add it to your MIDDLEWARE_CLASSES setting:
MIDDLEWARE_CLASSES = ( ... 'django_logutils.middleware.LoggingMiddleware', ... )
The extra information consists of:
event (default: ‘request’, can be overridden by using the LOGUTILS_LOGGING_MIDDLEWARE_EVENT setting in your project
remote ip address: the remote ip address of the user doing the request.
user email: the email address of the requesting user, if available
request method: post or get
request url path
response status code
content length of the response body
request time
The log message itself is a string composed of the remote ip address, the user email, the request method, the request url, the status code, the content length of the body and the request time. Additionally, a dictionary with the log items are added as a extra keyword argument when sending a logging statement.
- If settings.DEBUG is True or the request time is more than 1 second, two
additional parameters are added to the logging dictionary: nr_queries that represents the number of queries executed during the request-response cycle and sql_time that represents the time it took to execute those queries.
Development
Install the test requirements:
$ pip install -r requirements/test.txt
Run the tests to check everything is fine:
$ make test
To run the tests and opening the coverage html in your browser:
$ make coverage
To run flake8 and pylint, do:
$ make lint
To generate the documentation, do:
$ make docs
History
0.3.0 (2015-08-04)
Add EventLogger class.
0.2.5 (2015-07-31)
Reach 100% test coverage.
0.2.4 (2015-07-31)
Improve project structure.
0.2.3 (2015-07-30)
Add log_event utility function for logging events.
0.2.2 (2015-07-29)
Add add_items_to_message utility function.
0.2.1 (2015-07-29)
More and better tests.
0.2.0 (2015-07-28)
Release replacing previous faulty dev release.
0.1.0 (2015-07-28)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_logutils-0.3.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ce3ced1cbd4126a4ef82a6c6b7f9480d84d0d766341dcd87b8cc9986772c09bc |
|
MD5 | b0ca90913b28cbdd764af11adda16897 |
|
BLAKE2b-256 | 131a9e2d2a74caf08148ac11b2f41b807857463f73ad8d97f419f0330f556c78 |