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

CKTIS / Python

LoggerAdapter.info — journalisation avec contexte

LoggerAdapter.info journalise un message INFO avec le contexte de l’adaptateur, par exemple un identifiant de requête. Découvrez la différence entre le traitement par défaut de extra et merge_extra=True.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

adapter = logging.LoggerAdapter(logger, extra=None, merge_extra=False)
adapter.info(msg, *args, **kwargs)

LoggerAdapter enveloppe un logger et ajoute du contexte sans devoir le répéter à chaque appel. LoggerAdapter.info(msg, *args, **kwargs) correspond à Logger.info : la méthode journalise un message de niveau INFO, selon la configuration de journalisation.

La méthode process() transmet le contexte sous forme de extra. Ses champs deviennent des attributs de LogRecord qu’un Formatter peut afficher, par exemple avec %(request_id)s. Passez les arguments du message séparément : adapter.info('Processed %s items', 3).

Par défaut, merge_extra=False ignore le extra fourni lors d’un appel individuel. Avec merge_extra=True, disponible depuis Python 3.13, les deux ensembles sont combinés ; les valeurs propres à l’appel sont prioritaires. L’exemple illustre les deux comportements.

Les clés de extra ne doivent pas entrer en conflit avec les attributs de journalisation réservés. Si un champ requis par le formateur d’un handler est absent, le formatage échoue et ce handler n’émet pas l’enregistrement. Un autre handler dont le formateur ne requiert pas ce champ peut tout de même émettre le même enregistrement. L’adaptateur ne configure pas les handlers et ne contourne pas les seuils de niveau de journalisation.

Exemples

import io
import logging

stream = io.StringIO()
handler = logging.StreamHandler(stream)
handler.setFormatter(logging.Formatter(
    '%(levelname)s %(request_id)s %(message)s'
))
logger = logging.Logger('adapter-demo', level=logging.INFO)
logger.addHandler(handler)

adapter = logging.LoggerAdapter(logger, {'request_id': 'R1'})
adapter.info('Processed %s items', 3)
adapter.info('Default context', extra={'request_id': 'R2'})

merged = logging.LoggerAdapter(
    logger, {'request_id': 'R1'}, merge_extra=True
)
merged.info('Merged context', extra={'request_id': 'R2'})

print(stream.getvalue(), end='')

Résultat

INFO R1 Processed 3 items
INFO R1 Default context
INFO R2 Merged context

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources