Skip to content


Subversion checkout URL

You can clone with
Download ZIP
logging for django.
Pull request Compare This branch is 22 commits ahead, 152 commits behind dcramer:master.
Latest commit 9d12506 K. Noah remoivng a dstore thingy
Failed to load latest commit information.
.gitignore Fixed an issue where DEVSERVER_TRUNCATE_AGGREGATES was not respected.
README.rst making things work better out of the box and updating the dictconfig …
requirements.txt updated requirements to include pygments Initial working code including SQLModule



This is a logging server that tries to follow best practices with django and python.

It is highly customizable. All included modules are optional, and follow with best practices of established tools it utilizes. The entry-points for the loggers in django occur entirely through middlewares. The loggers are designed around python's feature rich logging system rather than built from scratch.

new support for arecibo.. woohoo!


To install the latest stable version:

pip install git+git://

django-lumberjack has some optional dependancies, which we highly recommend installing for development.

  • pip install sqlparse -- pretty SQL formatting
  • pip install pygments -- highlights tracebacks and sql
  • pip install werkzeug -- interactive debugger
  • pip install guppy -- tracks memory usage (required for MemoryUseModule)

You will need to include lumberjack in your INSTALLED_APPS:


Specify modules to load via the MIDDLEWARE_CLASSES setting:

# only available with DEBUG=True





500 Handler

Put this in your urls to get tracebacks to log. This is here rather than a middleware, so that you can log middleware exceptions. This only will work when DEBUG=False due to the way django handles exceptions.

handler500 = "lumberjack.views.server_error"


There is the same rundevserver command as available in the devserver app...

Though all of the middlewares will work regardless of which server you are running, the rundevserver command really only provides weurkzeug integration.

python rundevserver

Note: This will force settings.DEBUG to True.

This is necessary only if you want to use workzeug. All of the middlewares will work with the regular runserver.

Though with DEBUG = True you will lose the 500 handler.


The modules are the same as the devserver, only the have been implemented as middleware and simplified.

Outputs queries as they happen to the terminal, including time taken.
Outputs a summary of your SQL usage.
Outputs a summary of the request performance.
Outputs a notice when memory use is increased (at the end of a request cycle).
Outputs a summary of your cache calls at the end of the request.
Outputs the content of any AJAX responses
Outputs information about the current session and user.

Named Logging

This is really what lumberjack brings to the table. Let your imagination run wild with what the formatters and handlers will allow you to do... included are some simple examples. setting:

    'version': 1,
    'disable_existing_loggers': False,

    'formatters': {
        'error' : {
            '()': 'lumberjack.formatters.tb.TracebackFormatter',
            'format' : ('%(client_ip)s - [%(date_time)s] - "%(request_method)s"'
                        '%(content_length)s [%(url)s] \n %(exc_text)s' ),
        'sql' : {
            'format':'[%(name)s] %(levelname)s (%(duration)sms) %(message)s',
        'ajax' : {
            'format':'[%(name)s] %(levelname)s %(message)s',
        'default' : {
            'format' : '[%(name)s] %(levelname)s %(message)s',
    'handlers' : {
        'errorstream' : {
            'class' : 'logging.StreamHandler',
            'formatter' : 'error',
        'sqlstream' : {
            'class' : 'logging.StreamHandler',
            'formatter' : 'sql',
        'ajaxstream' : {
            'class' : 'logging.StreamHandler',
            'formatter' : 'ajax',
        'stream' : {
            'class' : 'logging.StreamHandler',
            'formatter' : 'default',
        #'errorarecibo' : {
        #    'class' : 'lumberjack.handlers.AreciboHandler',
        #    'server': '',
        #    'account': 'public_account_password',
        #    },
        # requires python-arecibo lib
    'loggers' : {
        'django.db' : {
            'level' : 'DEBUG',
            'handlers' : ['sqlstream'],
        'django.errors' : {
            'level' : 'DEBUG',
            'handlers' : ['errorstream'],
        'django.ajax' :{
            'level' : 'DEBUG',
            'handlers' : ['ajaxstream'],
        'django.profile' :{
            'level' : 'DEBUG',
            'handlers' : ['stream'],
        'django.cache' :{
            'level' : 'DEBUG',
            'handlers' : ['stream'],
        'django.request' :{
            'level' : 'DEBUG',
            'handlers' : ['stream'],

That seems pretty complex... but what it does is worth it.

Basically each middleware will write to its own named logger. If you include a middleware, but don't setup a logger for it or one of its parents it will write to a null logger.

Above, we have two loggers set-up. The 'django.db' logger will catch everything that falls into that set (ie: 'django.db.sql', 'django.db.summary').

The stream handler is built into python logging and will log to stderr... we are also using named handlers here for the purpose of setting a specific formatter for each.

Currently, lumberjack has the django specific handlers from jogging (which need testing and what-not).

It also includes two formatters that both will format either for terminal use, or as HTML.

Something went wrong with that request. Please try again.