Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

LoggerAdapter.error(): registrare errori con il contesto del team

In Python 3.12, usa `LoggerAdapter.error()` per registrare messaggi di livello `ERROR` con un campo `team`, senza passare il campo a ogni chiamata.

Versione: Python 3.12

Sintassi

adapter = logging.LoggerAdapter(logger, extra={"team": team})
adapter.error(msg, *args, **kwargs)

Crea l’adattatore con logging.LoggerAdapter(logger, extra={"team": "platform"}). adapter.error() registra messaggi di livello ERROR tramite il Logger fornito, mentre la funzione di modulo logging.error() usa il logger radice. L’adattatore non ha una soglia propria: sono le impostazioni del logger e dei suoi handler a determinare se un record viene emesso.

Usa adapter.error() per segnalare un fallimento. La chiamata non solleva di per sé un’eccezione e per impostazione predefinita non include un traceback. Dentro except, usa adapter.exception(...) o adapter.error(..., exc_info=True) per includere l’eccezione in gestione.

In Python 3.12, l’implementazione predefinita di process() sostituisce l’eventuale extra della singola chiamata con il contesto del costruttore, anziché unirli. Il campo team diventa un attributo di LogRecord; il formatter lo visualizza con %(team)s. Evita i nomi degli attributi predefiniti come levelname. Se il formatter richiede team e il record non ha quel campo, la formattazione non riesce a meno che non sia configurato un valore predefinito.

Esempi

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")

Risultato

INFO [platform] Deployment started for api
WARNING [platform] Health check is slow
ERROR [platform] Deployment failed

Esegui il codice come script autonomo. La soglia `INFO` lascia passare tutti e tre i record e lo `StreamHandler` li scrive sullo standard output. `propagate = False` impedisce che vengano inoltrati agli handler dei logger antenati.

Lezioni correlate

  • Python · Lezione 27 · Avanzato · Versione: 5

Fonti