Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources