CKTIS / Python
LoggerAdapter.error() : journaliser les erreurs avec le contexte de l’équipe
Avec Python 3.12, utilisez `LoggerAdapter.error()` pour journaliser au niveau `ERROR` avec un champ `team`, sans transmettre ce champ à chaque appel.
Version : Python 3.12
Syntaxe
adapter = logging.LoggerAdapter(logger, extra={"team": team})
adapter.error(msg, *args, **kwargs)Créez l’adaptateur avec logging.LoggerAdapter(logger, extra={"team": "platform"}). adapter.error() journalise au niveau ERROR via le Logger fourni, alors que la fonction du module logging.error() utilise le journaliseur racine. L’adaptateur n’a pas de seuil propre : les réglages du journaliseur et de ses gestionnaires déterminent si une entrée est émise.
Utilisez adapter.error() pour signaler un échec. L’appel ne lève pas lui-même d’exception et n’inclut pas de trace de pile par défaut. Dans un bloc except, utilisez adapter.exception(...) ou adapter.error(..., exc_info=True) pour inclure l’exception en cours de traitement.
Dans Python 3.12, le comportement par défaut de process() remplace le paramètre extra d’un appel par le contexte du constructeur, sans les fusionner. Le champ team devient un attribut du LogRecord ; le formateur l’affiche avec %(team)s. Évitez les noms d’attributs intégrés comme levelname. Si le formateur attend team et que le champ est absent, le formatage échoue sauf si une valeur par défaut est configurée.
Exemples
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")Résultat
INFO [platform] Deployment started for api WARNING [platform] Health check is slow ERROR [platform] Deployment failed
Exécutez ce code comme un script autonome. Le seuil `INFO` laisse passer les trois entrées et le `StreamHandler` les écrit sur la sortie standard. `propagate = False` empêche leur transmission aux gestionnaires des journaliseurs parents.
Leçons associées
- Python · Leçon 27 · Avancé · Version : 5