Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje