CKTIS / Python
Записване на предупреждения с контекст за екипа чрез `LoggerAdapter`
Обвий съществуващ логър с `logging.LoggerAdapter` и поле `team`, така че извикванията на `info`, `warning` и `error` да носят един и същ контекст за екипа.
Версия: Python 3.12
Синтаксис
adapter = logging.LoggerAdapter(logger, {"team": "Platform"})
adapter.info(msg, *args, **kwargs)
adapter.warning(msg, *args, **kwargs)
adapter.error(msg, *args, **kwargs)В Python 3.12 logging.LoggerAdapter(logger, {"team": "Platform"}) обвива съществуващ логър и препраща извикванията към него с контекст за екипа. Използвай adapter.warning(...) за събитие с ниво WARNING, когато се случи нещо неочаквано или има риск от проблем. adapter.info(...) отбелязва нормален ход на работа (INFO), а adapter.error(...) — неуспешна операция (ERROR). Функциите на модула logging.info, logging.warning и logging.error използват кореновия логър и не получават автоматично контекста на адаптера.
Стандартната реализация на process() в Python 3.12 оставя съобщението непроменено и предава структурата от ключове и стойности от конструктора като extra. Ако подадеш extra при отделно извикване на адаптера, тази стойност се заменя, а не се обединява с подаденото на конструктора. team става атрибут на LogRecord, затова Formatter може да го покаже чрез %(team)s. Ключовете в extra не трябва да съвпадат със запазени атрибути на записа.
Всеки запис, обработван от този форматиращ обект, трябва да съдържа team; иначе форматирането се проваля. Настройките на логъра и обработчика продължават да определят дали съобщението ще бъде изведено. В примера прагът INFO пропуска и трите нива.
Примери
import logging
import sys
logger = logging.getLogger("ck tis.deployment".replace(" ", ""))
logger.setLevel(logging.INFO)
logger.propagate = False
handler = logging.StreamHandler(sys.stdout)
handler.setFormatter(logging.Formatter("%(levelname)s [%(team)s] %(message)s"))
logger.addHandler(handler)
adapter = logging.LoggerAdapter(logger, {"team": "Platform"})
adapter.info("Deployment started")
adapter.warning("Retrying health check")
adapter.error("Deployment failed")Резултат
INFO [Platform] Deployment started WARNING [Platform] Retrying health check ERROR [Platform] Deployment failed
Изпълни кода като самостоятелен скрипт с Python 3.12. Обработчикът пише на стандартния изход, а изключеното препращане не позволява на записите да достигат до по-горните логъри. Очакваният резултат е три реда, всеки с `[Platform]`.
Свързани уроци
- Python · Урок 27 · Напреднало · Версия: 5