test0908
/
django
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

De-emphasized use of NullHandler in logging docs. 

NullHandler removed in 1.9; unused since Django 1.5.
This commit is contained in:
Neal Todd 2015-11-07 17:22:30 +01:00 committed by Tim Graham
parent 0a19f8d4fc
commit b3acdeee50
1 changed files with 23 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
docs/topics/logging.txt
View File

@ -315,15 +315,15 @@ Finally, here's an example of a fairly complex logging setup::
'special': { 'special': {
'()': 'project.logging.SpecialFilter', '()': 'project.logging.SpecialFilter',
'foo': 'bar', 'foo': 'bar',
} },
'require_debug_true': {
'()': 'django.utils.log.RequireDebugTrue',
},
}, },
'handlers': { 'handlers': {
'null': {
'level': 'DEBUG',
'class': 'logging.NullHandler',
},
'console': { 'console': {
'level': 'DEBUG', 'level': 'INFO',
'filters': ['require_debug_true'],
'class': 'logging.StreamHandler', 'class': 'logging.StreamHandler',
'formatter': 'simple' 'formatter': 'simple'
}, },
@ -335,9 +335,8 @@ Finally, here's an example of a fairly complex logging setup::
}, },
'loggers': { 'loggers': {
'django': { 'django': {
'handlers': ['null'], 'handlers': ['console'],
'propagate': True, 'propagate': True,
'level': 'INFO',
}, },
'django.request': { 'django.request': {
'handlers': ['mail_admins'], 'handlers': ['mail_admins'],
@ -371,17 +370,18 @@ This logging configuration does the following things:
message, plus the time, process, thread and module that message, plus the time, process, thread and module that
generate the log message. generate the log message.
* Defines one filter -- ``project.logging.SpecialFilter``, * Defines two filters:
using the alias ``special``. If this filter required additional
arguments at time of construction, they can be provided as
additional keys in the filter configuration dictionary. In this
case, the argument ``foo`` will be given a value of ``bar`` when
instantiating the ``SpecialFilter``.
* Defines three handlers: * ``project.logging.SpecialFilter``, using the alias ``special``. If this
filter required additional arguments, they can be provided as additional
keys in the filter configuration dictionary. In this case, the argument
``foo`` will be given a value of ``bar`` when instantiating
``SpecialFilter``.
* ``null``, a NullHandler, which will pass any ``DEBUG`` (or * ``django.utils.log.RequireDebugTrue``, which passes on records when
higher) message to ``/dev/null``. :setting:`DEBUG` is ``True``.
* Defines two handlers:
* ``console``, a StreamHandler, which will print any ``DEBUG`` * ``console``, a StreamHandler, which will print any ``DEBUG``
(or higher) message to stderr. This handler uses the ``simple`` output (or higher) message to stderr. This handler uses the ``simple`` output
@ -393,8 +393,7 @@ This logging configuration does the following things:
* Configures three loggers: * Configures three loggers:
* ``django``, which passes all messages at ``INFO`` or higher * ``django``, which passes all messages to the ``console`` handler.
to the ``null`` handler.
* ``django.request``, which passes all ``ERROR`` messages to * ``django.request``, which passes all ``ERROR`` messages to
the ``mail_admins`` handler. In addition, this logger is the ``mail_admins`` handler. In addition, this logger is
@ -546,6 +545,11 @@ specific logger following this example:
.. code-block:: python .. code-block:: python
'handlers': {
'null': {
'class': 'logging.NullHandler',
},
},
'loggers': { 'loggers': {
'django.security.DisallowedHost': { 'django.security.DisallowedHost': {
'handlers': ['null'], 'handlers': ['null'],