CKTIS / Python
Záznam varování s kontextem týmu pomocí `LoggerAdapter`
Obalte existující logger pomocí `logging.LoggerAdapter` s polem `team`, aby volání metod `info`, `warning` a `error` nesla stejný kontext týmu.
Verze: Python 3.12
Syntaxe
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 výraz logging.LoggerAdapter(logger, {"team": "Platform"}) obalí existující logger a předává mu volání s kontextem týmu. Použijte adapter.warning(...) pro úroveň WARNING, když se stane něco nečekaného nebo hrozí problém. adapter.info(...) zaznamenává běžný průběh (INFO) a adapter.error(...) neúspěšnou operaci (ERROR). Funkce modulu logging.info, logging.warning a logging.error naproti tomu používají kořenový logger a kontext adaptéru automaticky nepřebírají.
Výchozí implementace process() v Pythonu 3.12 nemění zprávu a předá mapování z konstruktoru jako extra. Pokud předáte extra při jednotlivém volání adaptéru, nahradí se, nikoli sloučí s mapováním z konstruktoru. team se stane atributem objektu LogRecord, takže jej Formatter může zobrazit pomocí %(team)s. Klíče v extra nesmějí kolidovat s vyhrazenými atributy záznamu.
Každý záznam zpracovaný tímto formátovačem musí obsahovat team, jinak formátování selže. O tom, zda se zpráva vypíše, nadále rozhoduje konfigurace loggeru a obsluhy výstupu. V příkladu práh INFO propustí všechny tři úrovně.
Příklady
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")Výsledek
INFO [Platform] Deployment started WARNING [Platform] Retrying health check ERROR [Platform] Deployment failed
Spusťte kód jako samostatný skript v Pythonu 3.12. Obsluha výstupu zapisuje na standardní výstup a vypnuté šíření brání předávání záznamů nadřazeným loggerům. Očekávejte tři řádky, každý s `[Platform]`.
Související lekce
- Python · Lekce 27 · Pokročilá · Verze: 5