[1.6.x] Fixed #19395 -- Added a simple example logging config.

Thanks ken.nelson at maclaren.com.

Backport of 69f0249d7b from master
This commit is contained in:
Tim Graham 2013-12-31 10:20:44 -05:00
parent f82eb49301
commit a05ca51c08
1 changed files with 33 additions and 6 deletions

View File

@ -237,15 +237,40 @@ use in your project code.
.. _dictConfig format: http://docs.python.org/library/logging.config.html#configuration-dictionary-schema
.. _a third-party library: http://bitbucket.org/vinay.sajip/dictconfig
An example
----------
Examples
--------
The full documentation for `dictConfig format`_ is the best source of
information about logging configuration dictionaries. However, to give
you a taste of what is possible, here is an example of a fairly
complex logging setup, configured using :func:`logging.config.dictConfig`::
you a taste of what is possible, here are a couple examples.
First, here's a simple configuration which writes all request logging from the
:ref:`django-request-logger` logger to a local file::
LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'handlers': {
'file': {
'level': 'DEBUG',
'class': 'logging.FileHandler',
'filename': '/path/to/django/debug.log',
},
},
'loggers': {
'django.request': {
'handlers': ['file'],
'level': 'DEBUG',
'propagate': True,
},
},
}
If you use this example, be sure to change the ``'filename'`` path to a
location that's writable by the user that's running the Django application.
Second, here's an example of a fairly complex logging setup, configured using
:func:`logging.config.dictConfig`::
LOGGING = {
'version': 1,
@ -405,6 +430,8 @@ Django provides four built-in loggers.
``django`` is the catch-all logger. No messages are posted directly to
this logger.
.. _django-request-logger:
``django.request``
~~~~~~~~~~~~~~~~~~