331 of components: loggers, handlers, filters, and formatters.
334 * Handlers send the log records (created by loggers) to the appropriate
340 Log event information is passed between loggers, handlers, filters and
390 The flow of log event information in loggers and handlers is illustrated in the
402 objects pass along relevant log messages to all interested log handlers.
416   handler objects from the logger object.  Handlers are covered in more detail
460 determine whether the event is passed to the logger's handlers.
462 Child loggers propagate messages up to the handlers associated with their
464 handlers for all the loggers an application uses. It is sufficient to
465 configure handlers for a top-level logger and create child loggers as needed.
472 Handlers  section in Advanced Logging Tutorial
481 email address. This scenario requires three individual handlers where each
486 :ref:`useful-handlers`); the tutorials use mainly :class:`StreamHandler` and
492 custom handlers) are the following configuration methods:
497   determines which severity of messages it will pass to its handlers.  The level
504   configure and deconfigure filter objects on handlers.
508 defines the interface that all handlers should have and establishes some
555 1. Creating loggers, handlers, and formatters explicitly using Python
627     [handlers]
635     handlers=consoleHandler
639     handlers=consoleHandler
688 :class:`~logging.handlers.WatchedFileHandler` (relative to the logging module) or
712     handlers:
721         handlers: [console]
725       handlers: [console]
734 where a logging event needs to be output, but no handlers can be found to
744   'No handlers could be found for logger X.Y.Z' is printed once.
763 that configuration will add some handlers, and if levels are suitably
765 handlers, as normal.
782 .. note:: It is strongly advised that you *do not add any handlers other
784    because the configuration of handlers is the prerogative of the application
786    target audience and what handlers are most appropriate for their
787    application: if you add handlers 'under the hood', you might well interfere
829 :dfn:`handlers`, which are instances of subclasses of the :class:`Handler`
830 class. Handlers are responsible for ensuring that a logged message (in the form
833 support desk staff, system administrators, developers). Handlers are passed
835 can have zero, one or more handlers associated with it (via the
837 handlers directly associated with a logger, *all handlers associated with all
840 passing to ancestor handlers stops).
842 Just as for loggers, handlers can have levels associated with them. A handler's
863 .. _useful-handlers:
865 Useful Handlers
876 #. :class:`~handlers.BaseRotatingHandler` is the base class for handlers that
878    directly. Instead, use :class:`~handlers.RotatingFileHandler` or
879    :class:`~handlers.TimedRotatingFileHandler`.
881 #. :class:`~handlers.RotatingFileHandler` instances send messages to disk
884 #. :class:`~handlers.TimedRotatingFileHandler` instances send messages to
887 #. :class:`~handlers.SocketHandler` instances send messages to TCP/IP
890 #. :class:`~handlers.DatagramHandler` instances send messages to UDP
893 #. :class:`~handlers.SMTPHandler` instances send messages to a designated
896 #. :class:`~handlers.SysLogHandler` instances send messages to a Unix
899 #. :class:`~handlers.NTEventLogHandler` instances send messages to a
902 #. :class:`~handlers.MemoryHandler` instances send messages to a buffer
905 #. :class:`~handlers.HTTPHandler` instances send messages to an HTTP
908 #. :class:`~handlers.WatchedFileHandler` instances watch the file they are
915    handlers could be found for logger XXX' message which can be displayed if
923 classes are defined in the core logging package. The other handlers are
924 defined in a sub- module, :mod:`logging.handlers`. (There is also another
932 :class:`~handlers.BufferingFormatter` can be used. In addition to the format
939 Before deciding to process a message further, both loggers and handlers consult
985 :class:`~handlers.SocketHandler` emits an event by pickling it and sending it
1036 Also note that the core logging module only includes the basic handlers. If
1037 you don't import :mod:`logging.handlers` and :mod:`logging.config`, they won't
1048    Module :mod:`logging.handlers`
1049       Useful handlers included with the logging module.