CKTIS / Python
LoggerAdapter.error(): beleženje napak s kontekstom ekipe
V Pythonu 3.12 uporabi `LoggerAdapter.error()` za beleženje na ravni `ERROR` s poljem `team`, ne da bi to polje podajal ob vsakem klicu.
Različica: Python 3.12
Sintaksa
adapter = logging.LoggerAdapter(logger, extra={"team": team})
adapter.error(msg, *args, **kwargs)Ustvari adapter z logging.LoggerAdapter(logger, extra={"team": "platform"}). adapter.error() beleži na ravni ERROR prek podanega objekta Logger, medtem ko funkcija modula logging.error() uporablja korenski beležnik. Adapter nima lastnega praga: nastavitve beležnika in njegovih obdelovalnikov določajo, ali se zapis izpiše.
Uporabi adapter.error(), da zabeležiš neuspeh. Klic sam ne sproži izjeme in privzeto ne doda izpisa sklada klicev. V bloku except uporabi adapter.exception(...) ali adapter.error(..., exc_info=True), da vključiš izjemo, ki jo trenutno obravnavaš.
V Pythonu 3.12 privzeta implementacija process() nadomesti extra posameznega klica s kontekstom iz konstruktorja, namesto da bi ju združila. Polje team postane atribut objekta LogRecord; oblikovalnik ga prikaže z %(team)s. Izogibaj se imenom vgrajenih atributov, kot je levelname. Če oblikovalnik pričakuje team, polje pa v zapisu manjka, oblikovanje ne uspe, razen če je nastavljena privzeta vrednost.
Primeri
import logging
import sys
logger = logging.getLogger("deploy")
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, extra={"team": "platform"})
adapter.info("Deployment started for %s", "api")
adapter.warning("Health check is slow")
adapter.error("Deployment failed")Rezultat
INFO [platform] Deployment started for api WARNING [platform] Health check is slow ERROR [platform] Deployment failed
Kodo zaženi kot samostojen skript. Prag `INFO` prepusti vse tri zapise, `StreamHandler` pa jih zapiše na standardni izhod. `propagate = False` prepreči posredovanje zapisov obdelovalnikom nadrejenih beležnikov.
Povezane lekcije
- Python · Lekcija 27 · Napredna · Različica: 5