Объект LogRecord модуля logging

Экземпляры logging.LogRecord создаются logging.Logger автоматически каждый раз, когда что-то регистрируется.

Объект logging.LogRecord содержит всю информацию, относящуюся к регистрируемому событию. Первичная информация передается в виде msg и args, которые объединяются с помощью msg % args для создания поля сообщения записи.

Атрибуты объекта LogRecord.

Объект LogRecord имеет ряд атрибутов, большинство из которых получены из параметров конструктора. Эти атрибуты можно использовать для объединения данных из записи в строку формата. В следующей таблице перечислены в алфавитном порядке имена атрибутов, их значения и соответствующий заполнитель при форматировании строки формата в стиле printf.

Если используется форматирование в стиле str.format(), то можно использовать фигурные скобки {attrname} в качестве заполнителя в строке формата. Если используется форматирование в стиле string.Template(), то можно использовать форму ${attrname}. В обоих случаях, заменяется attrname на фактическое имя атрибута, которое нужно использовать.

В случае форматирование в стиле str.format() можно указать флаги форматирования, поместив их после имени атрибута, отделенного от него двоеточием. Например: заполнитель {msecs: 03d} отформатирует значение миллисекунды, равное 4, как 004. Для получения полной информации о доступных опциях обратитесь к документации по функции str.format().

Примеры:

Больше примеров смотрите в разделе "Продвинутое использование модуля logging в Python".

import logging

# создаем регистратор
logger = logging.getLogger('logger')
logger.setLevel(logging.DEBUG)

# создаем обработчик для файла и 
# установим уровень отладки
ch = logging.FileHandler('example.log')
ch.setLevel(logging.DEBUG)

# строка формата сообщения
strfmt = '[%(asctime)s] [%(name)s] [%(levelname)s] > %(message)s'
# строка формата времени
datefmt = '%Y-%m-%d %H:%M:%S'
# создаем форматтер
formatter = logging.Formatter(fmt=strfmt, datefmt=datefmt)

# добавляем форматтер к 'ch'
ch.setFormatter(formatter)
# добавляем ch в регистратор
logger.addHandler(ch)

# вызов функций, регистрирующих 
# события в коде
logger.debug('debug message')
logger.info('info message')
logger.warning('warn message')
logger.error('error message')
logger.critical('critical message')

Запуск этого кода приведет к созданию файла 'example.log' с записями внутри:

[2020-06-08 07:42:59] [logger] [DEBUG] > debug message
[2020-06-08 07:42:59] [logger] [INFO] > info message
[2020-06-08 07:42:59] [logger] [WARNING] > warn message
[2020-06-08 07:42:59] [logger] [ERROR] > error message
[2020-06-08 07:42:59] [logger] [CRITICAL] > critical message