CKTIS / Python
Registrare avvisi con il contesto del team tramite `LoggerAdapter`
Avvolgi un logger esistente in `logging.LoggerAdapter` con un campo `team` per associare lo stesso contesto alle chiamate a `info`, `warning` ed `error`.
Versione: Python 3.12
Sintassi
adapter = logging.LoggerAdapter(logger, {"team": "Platform"})
adapter.info(msg, *args, **kwargs)
adapter.warning(msg, *args, **kwargs)
adapter.error(msg, *args, **kwargs)In Python 3.12, logging.LoggerAdapter(logger, {"team": "Platform"}) avvolge un logger esistente e gli inoltra le chiamate con il contesto del team. Usa adapter.warning(...) per un evento di livello WARNING quando succede qualcosa di inatteso o potrebbe sorgere un problema. adapter.info(...) indica il normale avanzamento (INFO), mentre adapter.error(...) indica che un’operazione non è riuscita (ERROR). Le funzioni del modulo logging.info, logging.warning e logging.error usano invece il logger radice e non ricevono automaticamente il contesto dell’adattatore.
In Python 3.12, l’implementazione predefinita di process() lascia invariato il messaggio e passa la mappatura del costruttore come extra. Se passi extra in una singola chiamata all’adattatore, viene sostituito, non unito a quello del costruttore. team diventa un attributo del LogRecord, che un Formatter può mostrare con %(team)s. Le chiavi di extra non devono coincidere con gli attributi riservati del record.
Tutti i record elaborati da quel formatter devono contenere team, altrimenti la formattazione fallisce. L’emissione del messaggio dipende ancora dalla configurazione del logger e dell’handler. Nell’esempio, la soglia INFO ammette tutti e tre i livelli.
Esempi
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")Risultato
INFO [Platform] Deployment started WARNING [Platform] Retrying health check ERROR [Platform] Deployment failed
Esegui il codice come script autonomo con Python 3.12. L’handler scrive sullo standard output e la propagazione disattivata impedisce ai record di raggiungere i logger antenati. L’output atteso è di tre righe, ciascuna con `[Platform]`.
Lezioni correlate
- Python · Lezione 27 · Avanzato · Versione: 5