Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Merged documentation update from 3.3.

This commit is contained in:
Vinay Sajip 2013-01-22 13:13:43 +00:00
parent 2ba095c6c5 7f3e993a3a
commit be2795a6f9
2 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Doc/howto/logging.rst
View File

@ -330,6 +330,9 @@ of components: loggers, handlers, filters, and formatters.
to output. to output.
* Formatters specify the layout of log records in the final output. * Formatters specify the layout of log records in the final output.
Log event information is passed between loggers, handlers, filters and
formatters in a :class:`LogRecord` instance.
Logging is performed by calling methods on instances of the :class:`Logger` Logging is performed by calling methods on instances of the :class:`Logger`
class (hereafter called :dfn:`loggers`). Each instance has a name, and they are class (hereafter called :dfn:`loggers`). Each instance has a name, and they are
conceptually arranged in a namespace hierarchy using dots (periods) as conceptually arranged in a namespace hierarchy using dots (periods) as
@ -374,6 +377,13 @@ You can change this by passing a format string to :func:`basicConfig` with the
*format* keyword argument. For all options regarding how a format string is *format* keyword argument. For all options regarding how a format string is
constructed, see :ref:`formatter-objects`. constructed, see :ref:`formatter-objects`.
Logging Flow
^^^^^^^^^^^^
The flow of log event information in loggers and handlers is illustrated in the
following diagram.
.. image:: logging_flow.png
Loggers Loggers
^^^^^^^ ^^^^^^^

BIN
Doc/howto/logging_flow.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 48 KiB