CKTIS / Python
Zaznamenávanie varovaní s kontextom tímu pomocou `LoggerAdapter`
Obaľ existujúci logger pomocou `logging.LoggerAdapter` s poľom `team`, aby volania metód `info`, `warning` a `error` mali rovnaký kontext tímu.
Verzia: Python 3.12
Syntax
adapter = logging.LoggerAdapter(logger, {"team": "Platform"})
adapter.info(msg, *args, **kwargs)
adapter.warning(msg, *args, **kwargs)
adapter.error(msg, *args, **kwargs)V Pythone 3.12 výraz logging.LoggerAdapter(logger, {"team": "Platform"}) obalí existujúci logger a odovzdáva mu volania s kontextom tímu. Použi adapter.warning(...) na záznam úrovne WARNING, keď sa stane niečo neočakávané alebo hrozí problém. adapter.info(...) zaznamenáva bežný priebeh (INFO) a adapter.error(...) zlyhanie operácie (ERROR). Funkcie modulu logging.info, logging.warning a logging.error naopak používajú koreňový logger a kontext adaptéra automaticky nepreberajú.
Predvolená implementácia process() v Pythone 3.12 nemení správu a odovzdá mapovanie z konštruktora ako extra. Ak pri jednotlivom volaní adaptéra zadáš extra, jeho hodnota sa nahradí, nezlúči sa s mapovaním z konštruktora. team sa stane atribútom objektu LogRecord, takže ho Formatter môže zobraziť pomocou %(team)s. Kľúče v extra nesmú kolidovať s vyhradenými atribútmi záznamu.
Každý záznam spracovaný týmto formátovačom musí obsahovať team, inak formátovanie zlyhá. O tom, či sa správa vypíše, naďalej rozhoduje konfigurácia loggera a obsluhy výstupu. V príklade prah INFO prepúšťa všetky tri úrovne.
Prí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ýsledok
INFO [Platform] Deployment started WARNING [Platform] Retrying health check ERROR [Platform] Deployment failed
Spusti kód ako samostatný skript v Pythone 3.12. Obsluha výstupu zapisuje na štandardný výstup a vypnuté šírenie bráni odovzdaniu záznamov nadradeným loggerom. Očakávaj tri riadky, každý s `[Platform]`.
Súvisiace lekcie
- Python · Lekcia 27 · Pokročilá · Verzia: 5