From f21915bb3ad73001b7d987332b2b4a0ae4ec288d Mon Sep 17 00:00:00 2001 From: Kim DoHyeon Date: Wed, 23 Aug 2017 05:24:18 +0900 Subject: [PATCH] Fixed #27931 -- Clarified the meaning of "django catch-all logger." --- docs/topics/logging.txt | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/topics/logging.txt b/docs/topics/logging.txt index d27d05fdfe..800be95885 100644 --- a/docs/topics/logging.txt +++ b/docs/topics/logging.txt @@ -456,8 +456,8 @@ Django provides several built-in loggers. ``django`` ~~~~~~~~~~ -``django`` is the catch-all logger. No messages are posted directly to -this logger. +The catch-all logger for messages in the ``django`` hierarchy. No messages are +posted using this name but instead using one of the loggers below. .. _django-request-logger: @@ -734,18 +734,19 @@ By default, Django configures the following logging: When :setting:`DEBUG` is ``True``: -* The ``django`` catch-all logger sends all messages at the ``INFO`` level or - higher to the console. +* The ``django`` logger sends messages in the ``django`` hierarchy (except + ``django.server``) at the ``INFO`` level or higher to the console. When :setting:`DEBUG` is ``False``: -* The ``django`` logger send messages with ``ERROR`` or ``CRITICAL`` level to +* The ``django`` logger sends messages in the ``django`` hierarchy (except + ``django.server``) with ``ERROR`` or ``CRITICAL`` level to :class:`AdminEmailHandler`. Independent of the value of :setting:`DEBUG`: -* The :ref:`django-server-logger` logger sends all messages at the ``INFO`` - level or higher to the console. +* The :ref:`django-server-logger` logger sends messages at the ``INFO`` level + or higher to the console. See also :ref:`Configuring logging ` to learn how you can complement or replace this default logging configuration.