Python Glossary English

все Python 3loggingфункция

logging.basicConfig()

настройка

Быстрая базовая настройка системы логирования: уровень, формат, файл или поток вывода. Вызывается один раз до первого log-вызова.

Синтаксис

logging.basicConfig(level=, format=, filename=, filemode=, encoding=)

Настройка срабатывает, только пока у корневого логгера нет обработчиков: второй вызов — и даже первый, если раньше в программе случайно проскочил logging.warning(), — молча ничего не изменит, пока не передать force=True (доступен с 3.8). Уровень по умолчанию WARNING, поэтому debug- и info-сообщения исчезают, пока явно не понизишь level. В библиотеках basicConfig не зовут: настройку вывода оставляют приложению.

Примеры

import logging
logging.basicConfig(
level=logging.DEBUG,
format='%(asctime)s %(levelname)s %(message)s'
)
logging.debug('старт')    # → в stderr: <дата время> DEBUG старт
logging.info('готово')    # → в stderr: <дата время> INFO готово

См. также

Открыть в полном глоссарииdocs.python.orgСообщить о неточности