CKTIS / Python
LoggerAdapter.info — protokolování s kontextem
LoggerAdapter.info zaznamená zprávu úrovně INFO s kontextem adaptéru, například identifikátorem požadavku. Zjistěte, jak se výchozí zpracování extra liší od merge_extra=True.
Verze: 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 obaluje logger a přidává kontext, aniž by jej bylo nutné opakovat při každém volání. LoggerAdapter.info(msg, *args, **kwargs) odpovídá metodě Logger.info: zaznamená zprávu úrovně INFO v závislosti na konfiguraci protokolování.
Metoda process() předává kontext jako extra. Jeho pole se stanou atributy LogRecord, které může zobrazit Formatter, například pomocí %(request_id)s. Argumenty zprávy předávejte samostatně: adapter.info('Processed %s items', 3).
Ve výchozím nastavení merge_extra=False ignoruje extra zadané při jednotlivém volání. Nastavení merge_extra=True, dostupné od Pythonu 3.13, spojí obě sady; přednost mají hodnoty z konkrétního volání. Příklad ukazuje obě možnosti.
Klíče v extra se nesmějí střetávat s vyhrazenými atributy protokolování. Chybí-li pole požadované formátovačem daného handleru, formátování selže a tento handler záznam nevypíše. Jiný handler, jehož formátovač toto pole nevyžaduje, může tentýž záznam přesto vypsat. Adaptér nekonfiguruje handlery ani neobchází prahové úrovně protokolování.
Příklady
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='')Výsledek
INFO R1 Processed 3 items INFO R1 Default context INFO R2 Merged context
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.