mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2024-12-22 17:16:24 +00:00
Code Issues 25 Releases Wiki Activity

Fixed #32016 -- Clarified manual logging config docs.

Browse Source
This commit is contained in:
Carlton Gibson 2020-09-22 09:52:15 +02:00
parent 9e4b1ad33e
commit 2a55431a56
1 changed files with 14 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
docs/topics/logging.txt
View File

@ -468,8 +468,15 @@ If you don't want to configure logging at all (or you want to manually
configure logging using your own approach), you can set
:setting:`LOGGING_CONFIG` to ``None``. This will disable the
configuration process for :ref:`Django's default logging
<default-logging-configuration>`. Here's an example that disables Django's
logging configuration and then manually configures logging:
<default-logging-configuration>`.
Setting :setting:`LOGGING_CONFIG` to ``None`` only means that the automatic
configuration process is disabled, not logging itself. If you disable the
configuration process, Django will still make logging calls, falling back to
whatever default logging behavior is defined.
Here's an example that disables Django's logging configuration and then
manually configures logging:
.. code-block:: python
:caption: settings.py
@ -479,10 +486,11 @@ logging configuration and then manually configures logging:
import logging.config
logging.config.dictConfig(...)
Setting :setting:`LOGGING_CONFIG` to ``None`` only means that the automatic
configuration process is disabled, not logging itself. If you disable the
configuration process, Django will still make logging calls, falling back to
whatever default logging behavior is defined.
Note that the default configuration process only calls
:setting:`LOGGING_CONFIG` once settings are fully-loaded. In contrast, manually
configuring the logging in your settings file will load your logging config
immediately. As such, your logging config must appear *after* any settings on
which it depends.
Django's logging extensions
===========================