Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti