Lines Matching full:logging
1 :mod:`logging.config` --- Logging configuration
4 .. module:: logging.config
5 :synopsis: Configuration of the logging module.
10 **Source code:** :source:`Lib/logging/config.py`
17 * :ref:`Basic Tutorial <logging-basic-tutorial>`
18 * :ref:`Advanced Tutorial <logging-advanced-tutorial>`
19 * :ref:`Logging Cookbook <logging-cookbook>`
23 This section describes the API for configuring the logging module.
30 The following functions configure the logging module. They are located in the
31 :mod:`logging.config` module. Their use is optional --- you can configure the
32 logging module using these functions or by making calls to the main API (defined
33 in :mod:`logging` itself) and defining handlers which are declared either in
34 :mod:`logging` or :mod:`logging.handlers`.
38 Takes the logging configuration from a dictionary. The contents of
39 this dictionary are described in :ref:`logging-config-dictschema`
49 corresponding to an actual logging level.
58 has a :meth:`configure` method. The :mod:`logging.config` module
82 Reads the logging configuration from a :mod:`configparser`\-format file. The
84 :ref:`logging-config-fileformat`.
116 in the logging configuration.
124 * Use of a configuration file where logging configuration is just part
141 :const:`DEFAULT_LOGGING_CONFIG_PORT` is used. Logging configurations will be
205 The logging configuration functionality tries to offer convenience, and in part this
207 objects used in logging configuration - for example, as described in
208 :ref:`logging-config-dict-userdef`. However, these same mechanisms (importing
221 Describing a logging configuration requires listing the various
225 These objects aren't limited to those provided by the :mod:`logging`
229 objects and connections is defined in :ref:`logging-config-dict-connections`
247 :ref:`logging-config-dict-userdef` below is used to create an instance;
254 configure the corresponding :class:`~logging.Formatter` instance.
258 :class:`~logging.Formatter` object:
267 arguments are as for :class:`~logging.Formatter`, thus this key is
269 :class:`~logging.Formatter`. For example, the alternative class
272 keys, you should use :ref:`logging-config-dict-userdef`.
279 empty string) and this is used to construct a :class:`logging.Filter`
309 class : logging.StreamHandler
315 class : logging.handlers.RotatingFileHandler
322 :class:`logging.StreamHandler`, using ``sys.stdout`` as the underlying
324 :class:`logging.handlers.RotatingFileHandler` with the keyword arguments
360 as described in the section on :ref:`logging-config-dict-incremental`.
394 over the wire as pickled dicts to a socket listener. Thus, the logging
403 The schema describes a set of logging objects - loggers,
467 which detail their configuration. In some places, the logging system
493 ``brief``, is a standard :class:`logging.Formatter` instance with the
496 result in a :class:`logging.Formatter` initialized with those two format
513 standard :class:`logging.Formatter` instances are created. The
634 automatically be converted to the value ``logging.DEBUG``, and the
639 objects which are not known to the :mod:`logging` module. For
640 example, consider :class:`logging.handlers.MemoryHandler`, which takes
670 class: logging.handlers.SMTPHandler
717 from logging.config import BaseConfigurator
746 not provide functionality to cover certain aspects of logging. For example,
747 you cannot configure :class:`~logging.Filter` objects, which provide for
749 If you need to have instances of :class:`~logging.Filter` in your logging
779 logged. Level values are :ref:`evaluated <func-eval>` in the context of the ``logging``
818 in the ``logging`` package's namespace). The ``level`` is interpreted as for
822 handler. If blank, a default formatter (``logging._defaultFormatter``) is used.
826 The ``args`` entry, when :ref:`evaluated <func-eval>` in the context of the ``logging``
833 ``logging`` package's namespace, is the keyword argument dict to the constructor
898 class=logging.Formatter
902 <logging-config-dictschema-formatters>`.
914 Module :mod:`logging`
915 API reference for the logging module.
917 Module :mod:`logging.handlers`
918 Useful handlers included with the logging module.