Console Logging to STDOUT in Django

Problem

Solution

For Python 2.6, use the following LOGGING config in your settings to specify a different output stream:

import sys
LOGGING = {
    'handlers': {
        'console':{
            'level':'INFO',
            'class':'logging.StreamHandler',
            'strm': sys.stdout
        },
        ...
    }
}

For Python 2.7+, the keyword argument to the constructor of logging.StreamHandler is stream rather than strm. Ensure you use the right version.

Discussion

Django's logging docs detail the following logging configuration for a console handler:

LOGGING = {
    ...
    'handlers': {
        'console':{
            'level':'DEBUG',
            'class':'logging.StreamHandler',
            'formatter': 'simple'
        },
    },
    ...
}

...however, the default output stream for logging.StreamHandler is STDERR. The extra keyword argument in the solution alter this behaviour to use STDOUT.

Logging to STDERR means that any output from cron jobs is emailed to root. A more desirable behaviour is for only genuine errors to trigger emails, while normal output can be logged to file. Hence, a sensible cronjob file would look something like:

SHELL=/bin/bash
MAILTO=alerts.someproject@yourcompany.co.uk

*/10 * * * * app source /venv/bin/activate && /app/manage.py do_something > /dev/null