Simple logging. Stored in database, accessed in Django admin.
Project description
Simple logging to the database for django projects. Log entries are viewed in admin.
Note: Be sparing with the number of messages logged to the database. It is convenient when you want events logged that can be viewed in the django admin, but logging excessively to the database can cripple performance.
Requirements
Django 1.7 or greater.
Install
Install package:
pip install django-lumberjack
Add 'lumberjack' to your INSTALLED_APPS:
# settings.py
INSTALLED_APPS = (
'django.contrib.admin',
'django.contrib.auth',
...
'lumberjack',
)
Add handler and logger configs:
# settings.py
LOGGING = {
...
'handlers': {
'lumberjack_handler': {
'level': 'DEBUG',
'class': 'lumberjack.handlers.DBHandler',
},
},
'loggers': {
'lumberjack': {
'handlers': ['lumberjack_handler'],
},
}
}
Create database tables:
$ ./manage.py migrate lumberjack
Usage
Example of logging in a view function:
# views.py
import logging
logger = logging.getLogger('lumberjack')
def someview(request):
logger.debug('someview was called', [__name__, 'sometag'])
...
try:
# some action
...
except:
logger.error('some action failed', [__name__, 'fml'])
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
