CKTIS / Python
Journaliser des avertissements avec le contexte d’équipe dans `LoggerAdapter`
Enveloppez un journaliseur existant dans un `logging.LoggerAdapter` muni du champ `team` pour que `info`, `warning` et `error` partagent le même contexte d’équipe.
Version : Python 3.12
Syntaxe
adapter = logging.LoggerAdapter(logger, {"team": "Platform"})
adapter.info(msg, *args, **kwargs)
adapter.warning(msg, *args, **kwargs)
adapter.error(msg, *args, **kwargs)En Python 3.12, logging.LoggerAdapter(logger, {"team": "Platform"}) enveloppe un journaliseur existant et lui transmet les appels avec le contexte d’équipe. Utilisez adapter.warning(...) au niveau WARNING si un événement inattendu survient ou si un problème risque de se produire. adapter.info(...) signale une progression normale (INFO), tandis que adapter.error(...) signale l’échec d’une opération (ERROR). Les fonctions de module logging.info, logging.warning et logging.error utilisent au contraire le journaliseur racine et ne récupèrent pas automatiquement le contexte de l’adaptateur.
En Python 3.12, l’implémentation par défaut de process() laisse le message intact et transmet la table de correspondance du constructeur comme extra. Un extra fourni lors d’un appel à l’adaptateur est remplacé, pas fusionné. team devient un attribut du LogRecord, qu’un Formatter peut afficher avec %(team)s. Les clés de extra ne doivent pas entrer en conflit avec les attributs réservés de l’enregistrement.
Chaque enregistrement traité par ce formateur doit contenir team, sinon le formatage échoue. L’émission du message dépend toujours de la configuration du journaliseur et du gestionnaire. Dans l’exemple, le seuil INFO laisse passer les trois niveaux.
Exemples
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")Résultat
INFO [Platform] Deployment started WARNING [Platform] Retrying health check ERROR [Platform] Deployment failed
Exécutez le code comme un script autonome avec Python 3.12. Le gestionnaire écrit sur la sortie standard. La propagation désactivée empêche les enregistrements d’atteindre les journaliseurs parents. Trois lignes contenant chacune `[Platform]` sont attendues.
Leçons associées
- Python · Leçon 27 · Avancé · Version : 5