Python logging.config.dictConfig: логи из словаря

Категория: Python · Язык: Python · Обновлено:

logging.config.dictConfig настраивает логирование из обычного словаря: форматтеры, обработчики, уровни и логгеры. Конфигурацию можно хранить в JSON/YAML и менять без правки кода. Это удобнее десятка вызовов addHandler, особенно когда обработчиков несколько.

Настроить консольный логгер

Python
import logging.config

config = {
    "version": 1,
    "disable_existing_loggers": False,
    "formatters": {
        "default": {
            "format": "%(asctime)s %(levelname)s %(name)s: %(message)s",
        },
    },
    "handlers": {
        "console": {
            "class": "logging.StreamHandler",
            "formatter": "default",
        },
    },
    "root": {
        "level": "INFO",
        "handlers": ["console"],
    },
}

logging.config.dictConfig(config)
logging.getLogger("app").info("готово")

disable_existing_loggers: False сохраняет логгеры библиотек, созданные до вызова. Если оставить True, сторонние логгеры могут замолчать. root задаёт базовый уровень и обработчик; именованные логгеры наследуют настройки, пока не переопределены.

Добавить файл и уровень для модуля

Python
import logging.config

config = {
    "version": 1,
    "disable_existing_loggers": False,
    "formatters": {
        "default": {"format": "%(levelname)s %(name)s: %(message)s"},
    },
    "handlers": {
        "file": {
            "class": "logging.handlers.RotatingFileHandler",
            "filename": "app.log",
            "maxBytes": 1_000_000,
            "backupCount": 3,
            "formatter": "default",
        },
    },
    "loggers": {
        "app": {
            "level": "DEBUG",
            "handlers": ["file"],
            "propagate": False,
        },
    },
    "root": {"level": "WARNING", "handlers": ["file"]},
}

logging.config.dictConfig(config)
logging.getLogger("app").debug("отладка")

RotatingFileHandler ограничивает размер файла и число архивов. propagate: False не даёт сообщению продублироваться в root. Для нескольких процессов используйте QueueHandler/QueueListener или отдельный сборщик логов; запись в один файл из процессов может конфликтовать.

dictConfig заменяет существующие обработчики при повторном вызове. Настройте логирование один раз при старте приложения, до создания рабочих потоков. Не храните в конфиге пароли и токены; путь к файлу и уровень можно брать из переменных окружения.

Словарь можно загрузить из JSON (json.load) или YAML (с PyYAML). Схема чувствительна к опечаткам: неизвестный ключ вызовет ошибку. Проверьте конфигурацию в тесте, создав логгер и записав тестовое сообщение.

Документация: logging.config.dictConfig, logging handlers.