CKTIS / Python
Beleženje opozoril s kontekstom ekipe z `LoggerAdapter`
Obdaj obstoječi zapisovalnik z `logging.LoggerAdapter` s poljem `team`, da imajo klici metod `info`, `warning` in `error` isti kontekst ekipe.
Različica: Python 3.12
Sintaksa
adapter = logging.LoggerAdapter(logger, {"team": "Platform"})
adapter.info(msg, *args, **kwargs)
adapter.warning(msg, *args, **kwargs)
adapter.error(msg, *args, **kwargs)V Pythonu 3.12 logging.LoggerAdapter(logger, {"team": "Platform"}) ovije obstoječi zapisovalnik in mu posreduje klice s kontekstom ekipe. Uporabi adapter.warning(...) za zapis ravni WARNING, ko se zgodi kaj nepričakovanega ali ko grozi težava. adapter.info(...) beleži običajen potek (INFO), adapter.error(...) pa neuspešno opravilo (ERROR). Funkcije modula logging.info, logging.warning in logging.error pa uporabljajo korenski zapisovalnik in konteksta adapterja ne prejmejo samodejno.
Privzeta izvedba process() v Pythonu 3.12 sporočila ne spremeni in preslikavo iz konstruktorja posreduje kot extra. Če pri posameznem klicu adapterja podaš extra, ga ta nadomesti, ne združi s preslikavo iz konstruktorja. team postane atribut objekta LogRecord, zato ga Formatter lahko prikaže z %(team)s. Ključi v extra se ne smejo ujemati z rezerviranimi atributi zapisa.
Vsak zapis, ki ga obdela ta oblikovalnik, mora vsebovati team, sicer oblikovanje ne uspe. Ali se sporočilo izpiše, je še vedno odvisno od nastavitev zapisovalnika in obdelovalnika. V primeru prag INFO prepusti vse tri ravni.
Primeri
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")Rezultat
INFO [Platform] Deployment started WARNING [Platform] Retrying health check ERROR [Platform] Deployment failed
Zaženi kodo kot samostojen skript v Pythonu 3.12. Obdelovalnik piše na standardni izhod, izklopljeno širjenje pa prepreči pošiljanje zapisov nadrejenim zapisovalnikom. Pričakovane so tri vrstice, vsaka z `[Platform]`.
Povezane lekcije
- Python · Lekcija 27 · Napredna · Različica: 5