Сообщить об ошибке.

Краткий обзор раздела: Пакет logging, ведение журнала в Python.

Содержание с кратким описанием:

ОБЗОР: Пакет logging, ведение журнала в Python.
Пакет logging определяет функции и классы, которые реализуют гибкую систему регистраций событий для приложений и библиотек. Уровень по умолчанию - WARNING, что означает, что будут отслеживаться только события этого уровня и выше, если пакет регистрации не настроен на обратное.
Простое использование модуля logging в Python.
Разобраны следующие ситуации: логирование событий в файл, логирование событий из нескольких модулей, регистрация значений переменных, форматирование вида отображаемых сообщений, отображение даты и времени в сообщениях.
Продвинутое использование модуля logging в Python.
Пакет logging использует модульный подход и предлагает несколько категорий компонентов: регистраторы, обработчики, фильтры и форматеры.
Принцип работы пакета logging в Python.
В этом разделе рассмотрен принцип работы и связь основных элементов в процесса регистрации событий пакета `logging`
Функция getLogger() модуля logging в Python.
Функция getLogger() модуля logging возвращает регистратор с указанным именем name или, если имя отсутствует, то возвращает регистратор корневой root регистратор в иерархии.
Функции регистрации сообщений модуля logging в Python.
Функция `logging.debug` регистрируют сообщение с уровнем `DEBUG`, `logging.info` регистрируют сообщение с уровнем `INFO`, `logging.warning` регистрируют сообщение с уровнем `WARNING`, `logging.error` регистрирует сообщение с уровнем `ERROR`, `logging.critical` регистрирует уровень `CRITICAL`.
Функция exception() модуля logging в Python.
Функция `exception()` модуля `logging` регистрирует сообщение с уровнем ERROR в корневом логгере. Информация об перехваченном исключении добавляется в сообщение регистрации `msg`.
Функция log() модуля logging в Python.
Функция `log()` модуля `logging` регистрирует сообщение `msg` с уровнем `level` в корневом логгере.
Функция disable() модуля logging в Python.
Функция `disable()` модуля `logging` предоставляет приоритетный уровень логирования для всех регистраторов, который имеет приоритет над собственным уровнем.
Функция addLevelName() модуля logging в Python.
Функция `addLevelName()` модуля `logging` связывает уровень `level` с текстом `levelName` во внутреннем словаре, который используется для сопоставления числовых уровней с текстовым представлением.
Функция getLevelName() модуля logging в Python.
Функция `getLevelName()` модуля `logging` возвращает текстовое представление уровня `level` логирования ведения журнала.
Функция basicConfig() модуля logging в Python.
Функция `basicConfig()` модуля `logging` выполняет базовую настройку системы ведения журнала, создав `logging.StreamHandler()` с `logging.Formatter()` по умолчанию и добавив его в корневой регистратор.
Функция captureWarnings() модуля logging в Python.
Функция `captureWarnings()` модуля `logging` используется для включения захвата предупреждений путем входа и выключения. Функция `captureWarnings()` может использоваться для интеграции ведения журнала с модулем предупреждений.
Функция shutdown() модуля logging в Python.
Функция `shutdown()` модуля `logging` информирует систему регистрации о необходимости упорядоченного завершения работы путем сброса и закрытия всех обработчиков.
Объект LogRecord() модуля logging в Python.
Экземпляры `logging.LogRecord` создаются [`logging.Logger`] автоматически каждый раз, когда что-то регистрируется. Объект `logging.LogRecord` содержит всю информацию, относящуюся к регистрируемому событию.
Объект Logger модуля logging в Python.
Объекты регистраторов Logger никогда не должны создаваться напрямую, а должны всегда создаваться через функцию уровня модуля logging.getLogger(name). Многократные вызовы logging.getLogger() с одним и тем же именем всегда возвращают ссылку на один и тот же объект Logger.
Объект Handler модуля logging в Python.
Обработчики `logging.Handler` никогда не создается напрямую. Этот класс служит основой для более полезных подклассов. Пакет `logging` предоставляет несколько полезных обработчиков, созданных на основе базового обработчика `Handler`.
Класс Formatter() модуля logging в Python.
Класс Formatter() модуля logging возвращает новый экземпляр класса logging.Formatter. Экземпляр инициализируется строкой формата fmt для сообщения в целом, а также строкой формата datefmt для части даты/времени сообщения.
Класс Filter() модуля logging в Python.
Базовый класс `Filter()` модуля `logging` возвращает экземпляр класса `logging.Filter`. Если указано имя `name`, то это должно быть имя регистратора, которому вместе со своими дочерними элементами будут разрешены события через фильтр. Если имя - пустая строка, то разрешается каждое событие.
Класс LoggerAdapter() модуля logging в Python.
Изменяет аргументы сообщения и/или ключевые аргументы, передаваемые в журнал для того, чтобы вставить контекстную информацию.
Функция dictConfig() модуля logging.config в Python.
Настройка регистратора logger при помощи словаря конфигурации. Функция logging.config.dictConfig() принимает конфигурацию регистратора из словаря.
Функция fileConfig() модуля logging.config в Python.
Настройка регистратора logger при помощи файла конфигурации. Функция logging.config.fileConfig() читает конфигурацию, поддерживаемую модулем configparser из файла fname.
StreamHandler и FileHandler обработчики модуля logging в Python.
В разделе представлены стандартные, наиболее часто используемые обработчики logging.StreamHandler и logging.FileHandler пакета ведения журналов logging.
Класс WatchedFileHandler() модуля logging.handlers в Python.
Класс `WatchedFileHandler()`, расположенный в модуле logging.handlers но следит за файлом, в который он выводит события. Если файл изменяется, то он закрывается и снова открывается с использованием старого имени файла. Может использоваться с такими программами Unix как `newsyslog` и `logrotate`.
Класс RotatingFileHandler() модуля logging.handlers в Python.
Класс `RotatingFileHandler`, расположенный в модуле `logging.handlers`, поддерживает ротацию файлов журналов, расположенных на диске. Ротация логов основывается на заданном объеме файла.
Класс TimedRotatingFileHandler() модуля logging в Python.
Класс `TimedRotatingFileHandler()` поддерживает ротацию файлов журналов диска через определенные интервалы времени.
Класс SMTPHandler() модуля logging.handlers в Python.
Класс `SMTPHandler()` модуля logging.handlers поддерживает отправку сообщений регистратора на адрес электронной почты через SMTP сервер.
Класс HTTPHandler() модуля logging.handlers в Python.
Класс HTTPHandler() модуля logging.handlers поддерживает отправку сообщений регистратора на веб-сервер, используя семантику GET или POST запросов.