KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

LoggerAdapter.info — contextueel loggen

LoggerAdapter.info logt een INFO-bericht met adaptercontext, zoals een aanvraag-ID. Ontdek het verschil tussen de standaardverwerking van extra en merge_extra=True.

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

Syntax

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

LoggerAdapter wikkelt een logger in en voegt context toe zonder die bij elke aanroep te herhalen. LoggerAdapter.info(msg, *args, **kwargs) komt overeen met Logger.info: de methode logt een bericht op niveau INFO, afhankelijk van de loggingconfiguratie.

De methode process() geeft de context door als extra. De velden daarvan worden attributen van LogRecord die een Formatter kan weergeven, bijvoorbeeld met %(request_id)s. Geef berichtargumenten apart door: adapter.info('Processed %s items', 3).

Standaard negeert merge_extra=False de extra die bij een afzonderlijke aanroep wordt opgegeven. Met merge_extra=True, beschikbaar sinds Python 3.13, worden beide verzamelingen gecombineerd; waarden van de aanroep krijgen voorrang. Het voorbeeld laat beide gedragingen zien.

Sleutels in extra mogen niet botsen met gereserveerde loggingattributen. Als een veld ontbreekt dat de formatter van een handler nodig heeft, mislukt de opmaak en geeft die handler het record niet uit. Een andere handler waarvan de formatter dat veld niet nodig heeft, kan hetzelfde record nog wel uitvoeren. De adapter configureert geen handlers en omzeilt geen loggingniveaudrempels.

Voorbeelden

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='')

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen