Python logging.config.dictConfig: логи из словаря
logging.config.dictConfig настраивает логирование из обычного словаря: форматтеры, обработчики, уровни и логгеры. Конфигурацию можно хранить в JSON/YAML и менять без правки кода. Это удобнее десятка вызовов addHandler, особенно когда обработчиков несколько.
Настроить консольный логгер
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 задаёт базовый уровень и обработчик; именованные логгеры наследуют настройки, пока не переопределены.
Добавить файл и уровень для модуля
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.