CKTIS / Python
LoggerAdapter.error(): logování chyb s kontextem týmu
V Pythonu 3.12 použij `LoggerAdapter.error()` k zápisu zpráv na úrovni `ERROR` s polem `team`, aniž bys toto pole předával při každém volání.
Verze: Python 3.12
Syntaxe
adapter = logging.LoggerAdapter(logger, extra={"team": team})
adapter.error(msg, *args, **kwargs)Vytvoř adaptér pomocí logging.LoggerAdapter(logger, extra={"team": "platform"}). adapter.error() zapisuje zprávy na úrovni ERROR prostřednictvím zadaného objektu Logger. Funkce modulu logging.error() naopak používá kořenový logger. Adaptér nemá vlastní prahovou úroveň: o tom, zda se záznam zapíše, rozhoduje nastavení loggeru a jeho handlerů.
Použij adapter.error() k oznámení selhání. Samotné volání nevyvolá výjimku a ve výchozím nastavení nepřipojí výpis zásobníku. Uvnitř bloku except použij adapter.exception(...) nebo adapter.error(..., exc_info=True), aby záznam obsahoval právě zpracovávanou výjimku.
V Pythonu 3.12 výchozí metoda process() nahrazuje extra z jednotlivého volání kontextem z konstruktoru, místo aby je sloučila. Pole team se stane atributem objektu LogRecord; formátovač je zobrazí pomocí %(team)s. Vyhni se názvům vestavěných atributů, jako je levelname. Pokud formátovač očekává team a pole chybí, formátování selže, není-li nastavena výchozí hodnota.
Příklady
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")Výsledek
INFO [platform] Deployment started for api WARNING [platform] Health check is slow ERROR [platform] Deployment failed
Spusť kód jako samostatný skript. Prahová úroveň `INFO` propustí všechny tři záznamy a `StreamHandler` je zapíše na standardní výstup. `propagate = False` zabrání předání záznamů handlerům nadřazených loggerů.
Související lekce
- Python · Lekce 27 · Pokročilá · Verze: 5