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

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

Изменить уровень логирования всех регистраторов

Синтаксис:

import logging

logging.disable(level=logging.CRITICAL)

Параметры:

  • level=CRITICAL - приоритетный уровень логирования.

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

  • переопределяет уровень логирования для всех регистраторов.

Описание:

Функция disable() модуля logging предоставляет приоритетный уровень level логирования для всех регистраторов, который имеет приоритет над собственным уровнем.

Функция logging.disable() может быть полезна, когда возникает необходимость во временном сокращении выходных данных журнала во всем приложении. Его эффект заключается в отключении всех вызовов регистрации ниже переданного в функцию уровня логирования level. Так что если вызвать эту функцию со значением logging.INFO, то все события logging.INFO и logging.DEBUG будут отброшены, тогда как уровни логирования logging.WARNING и выше будут обрабатываться в соответствии с регистратором.

Если logging.disable() вызывается с аргументом logging.NOTSET, то она фактически удаляет этот переопределяющий уровень, так что вывод журнала снова зависит от эффективных уровней отдельных регистраторов.

Обратите внимание, что если определить какой-либо пользовательский уровень ведения журнала выше CRITICAL, что не рекомендуется, то нельзя полагаться на значение по умолчанию для параметра level, и придется явно указать подходящее значение.

Примеры:

>>> import logging
>>> logging.basicConfig(level=logging.DEBUG)
>>> logging.debug('This message DEBUG')
DEBUG:root:This message DEBUG
# отключаем вывод сообщений о событиях
>>> logging.disable(level=logging.CRITICAL)
>>> logging.info('This message INFO')
>>> logging.warning('This message WARNING')
>>> logging.error('This message ERROR')
>>> logging.critical('This message CRITICAL')
# включаем определенный ранее вывод 
# сообщений о событиях
>>> logging.disable(level=logging.NOTSET)
>>> logging.info('This message INFO')
INFO:root:This message INFO
>>> logging.warning('This message WARNING')
WARNING:root:This message WARNING
>>> logging.error('This message ERROR')
ERROR:root:This message ERROR
>>> logging.critical('This message CRITICAL')
CRITICAL:root:This message CRITICAL