mirror of
https://github.com/django/django.git
synced 2024-12-23 01:25:58 +00:00
De-emphasized use of NullHandler in logging docs.
NullHandler removed in 1.9; unused since Django 1.5.
This commit is contained in:
parent
0a19f8d4fc
commit
b3acdeee50
@ -315,15 +315,15 @@ Finally, here's an example of a fairly complex logging setup::
|
||||
'special': {
|
||||
'()': 'project.logging.SpecialFilter',
|
||||
'foo': 'bar',
|
||||
}
|
||||
},
|
||||
'require_debug_true': {
|
||||
'()': 'django.utils.log.RequireDebugTrue',
|
||||
},
|
||||
},
|
||||
'handlers': {
|
||||
'null': {
|
||||
'level': 'DEBUG',
|
||||
'class': 'logging.NullHandler',
|
||||
},
|
||||
'console': {
|
||||
'level': 'DEBUG',
|
||||
'level': 'INFO',
|
||||
'filters': ['require_debug_true'],
|
||||
'class': 'logging.StreamHandler',
|
||||
'formatter': 'simple'
|
||||
},
|
||||
@ -335,9 +335,8 @@ Finally, here's an example of a fairly complex logging setup::
|
||||
},
|
||||
'loggers': {
|
||||
'django': {
|
||||
'handlers': ['null'],
|
||||
'handlers': ['console'],
|
||||
'propagate': True,
|
||||
'level': 'INFO',
|
||||
},
|
||||
'django.request': {
|
||||
'handlers': ['mail_admins'],
|
||||
@ -371,17 +370,18 @@ This logging configuration does the following things:
|
||||
message, plus the time, process, thread and module that
|
||||
generate the log message.
|
||||
|
||||
* Defines one filter -- ``project.logging.SpecialFilter``,
|
||||
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 two filters:
|
||||
|
||||
* 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
|
||||
higher) message to ``/dev/null``.
|
||||
* ``django.utils.log.RequireDebugTrue``, which passes on records when
|
||||
:setting:`DEBUG` is ``True``.
|
||||
|
||||
* Defines two handlers:
|
||||
|
||||
* ``console``, a StreamHandler, which will print any ``DEBUG``
|
||||
(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:
|
||||
|
||||
* ``django``, which passes all messages at ``INFO`` or higher
|
||||
to the ``null`` handler.
|
||||
* ``django``, which passes all messages to the ``console`` handler.
|
||||
|
||||
* ``django.request``, which passes all ``ERROR`` messages to
|
||||
the ``mail_admins`` handler. In addition, this logger is
|
||||
@ -546,6 +545,11 @@ specific logger following this example:
|
||||
|
||||
.. code-block:: python
|
||||
|
||||
'handlers': {
|
||||
'null': {
|
||||
'class': 'logging.NullHandler',
|
||||
},
|
||||
},
|
||||
'loggers': {
|
||||
'django.security.DisallowedHost': {
|
||||
'handlers': ['null'],
|
||||
|
Loading…
Reference in New Issue
Block a user