Функция exception() модуля logging в Python

Логирование перехваченных исключений

Синтаксис:

import logging

logging.exception(msg, *args, **kwargs)

Параметры:

• msg - строка формата сообщения,
• *args - аргументы, которые объединяются в msg,
• *kwargs - ключевые аргументы.

Возвращаемое значение:

• регистрирует сообщение с уровнем ERROR.

Описание:

Функция exception() модуля logging регистрирует сообщение с уровнем ERROR в корневом логгере.

Аргументы интерпретируются как для функции регистрации сообщений. Информация об перехваченном исключении добавляется в сообщение регистрации msg.

Функция logging.exception() должна вызываться только из обработчика исключений.

Примечание. Вспомогательная функция уровня модуля logging.exception() не должна использоваться в потоках в более ранних версиях, чем Python-3.2, если только не был добавлен хотя бы один обработчик в корневой регистратор до запуска потоков. В ранних версиях Python из-за недостатка безопасности потоков в logging.basicConfig(), в редких случаях, приводит к многократному добавлению обработчиков в корневой логгер, что, в свою очередь, может приводить к нескольким сообщениям для одного и того же события.

Примеры:

>>> import logging
>>> try:
...     1/0
... except Exception:
...     logging.exception('Фатальная ошибка')
... 
# ERROR:root:Фатальная ошибка
# Traceback (most recent call last):
#   File "<stdin>", line 2, in <module>
# ZeroDivisionError: division by zero