Python Glossary English

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

logging.getLogger()

настройка

Возвращает именованный логгер. Логгеры образуют иерархию по точке в имени. Лучше создавать логгер на уровне модуля: getLogger(__name__).

Синтаксис

logger = logging.getLogger(name)

На одно и то же имя всегда возвращается один и тот же объект, поэтому логгер можно «получать» в любом месте программы, не протаскивая его через параметры. Запись поднимается вверх по точечной иерархии имён, и обработчики предков тоже срабатывают — отсюда классическое задвоение строк, когда handler повесили и на модульный логгер, и на корневой. Собственный уровень логгера по умолчанию NOTSET: он молча берёт уровень ближайшего предка, у которого уровень задан.

Примеры

import logging
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)
logger.info('сообщение из модуля')
import logging
# иерархия
parent = logging.getLogger('app')
child  = logging.getLogger('app.db')  # наследует настройки parent

См. также

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