mirror of https://github.com/django/django.git
Refs #32880 -- Improved some headings and text in logging topic.
This commit is contained in:
parent
27e156fa31
commit
64839512a6
|
@ -5,8 +5,8 @@ Logging
|
|||
.. module:: django.utils.log
|
||||
:synopsis: Logging tools for Django applications
|
||||
|
||||
A quick logging primer
|
||||
======================
|
||||
Overview
|
||||
========
|
||||
|
||||
Django uses Python's builtin :mod:`logging` module to perform system logging.
|
||||
The usage of this module is discussed in detail in Python's own documentation.
|
||||
|
@ -68,7 +68,7 @@ it is passed to a *Handler*.
|
|||
Handlers
|
||||
~~~~~~~~
|
||||
|
||||
The handler is the engine that determines what happens to each message
|
||||
The *handler* is the engine that determines what happens to each message
|
||||
in a logger. It describes a particular logging behavior, such as
|
||||
writing a message to the screen, to a file, or to a network socket.
|
||||
|
||||
|
@ -89,7 +89,7 @@ file for later analysis.
|
|||
Filters
|
||||
~~~~~~~
|
||||
|
||||
A filter is used to provide additional control over which log records
|
||||
A *filter* is used to provide additional control over which log records
|
||||
are passed from logger to handler.
|
||||
|
||||
By default, any log message that meets log level requirements will be
|
||||
|
@ -111,14 +111,14 @@ can be used in a chain to perform multiple filtering actions.
|
|||
Formatters
|
||||
~~~~~~~~~~
|
||||
|
||||
Ultimately, a log record needs to be rendered as text. Formatters
|
||||
Ultimately, a log record needs to be rendered as text. *Formatters*
|
||||
describe the exact format of that text. A formatter usually consists
|
||||
of a Python formatting string containing
|
||||
:ref:`LogRecord attributes <python:logrecord-attributes>`; however,
|
||||
you can also write custom formatters to implement specific formatting behavior.
|
||||
|
||||
Using logging
|
||||
=============
|
||||
How to use logging
|
||||
==================
|
||||
|
||||
Once you have configured your loggers, handlers, filters and
|
||||
formatters, you need to place logging calls into your code. Using the
|
||||
|
@ -492,11 +492,11 @@ 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
|
||||
===========================
|
||||
Django logging extension reference
|
||||
==================================
|
||||
|
||||
Django provides a number of utilities to handle the unique
|
||||
requirements of logging in Web server environment.
|
||||
requirements of logging in a web server environment.
|
||||
|
||||
Loggers
|
||||
-------
|
||||
|
|
Loading…
Reference in New Issue