Kaydet (Commit) b3acdeee authored tarafından Neal Todd's avatar Neal Todd Kaydeden (comit) Tim Graham

De-emphasized use of NullHandler in logging docs.

NullHandler removed in 1.9; unused since Django 1.5.
üst 0a19f8d4
...@@ -315,15 +315,15 @@ Finally, here's an example of a fairly complex logging setup:: ...@@ -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:: ...@@ -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: ...@@ -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: ...@@ -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: ...@@ -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'],
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment