CKTIS / Python
LoggerAdapter.info — zaznamenávanie s kontextom
LoggerAdapter.info zaznamená správu úrovne INFO s kontextom adaptéra, napríklad identifikátorom požiadavky. Zistite, ako sa predvolené spracovanie extra líši od merge_extra=True.
Verzia: 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 obaľuje logger a pridáva kontext bez toho, aby ho bolo potrebné opakovať pri každom volaní. LoggerAdapter.info(msg, *args, **kwargs) zodpovedá metóde Logger.info: zaznamená správu úrovne INFO v závislosti od konfigurácie zaznamenávania.
Metóda process() odovzdáva kontext ako extra. Jeho polia sa stanú atribútmi LogRecord, ktoré môže zobraziť Formatter, napríklad pomocou %(request_id)s. Argumenty správy odovzdávajte samostatne: adapter.info('Processed %s items', 3).
Predvolené merge_extra=False ignoruje extra zadané pri jednotlivom volaní. Nastavenie merge_extra=True, dostupné od Pythonu 3.13, spojí obe množiny; prednosť majú hodnoty z konkrétneho volania. Príklad ukazuje obe možnosti.
Kľúče v extra sa nesmú stretnúť s vyhradenými atribútmi zaznamenávania. Ak chýba pole, ktoré vyžaduje formátovač daného handlera, formátovanie zlyhá a tento handler záznam nevypíše. Iný handler, ktorého formátovač toto pole nevyžaduje, môže ten istý záznam napriek tomu vypísať. Adaptér nekonfiguruje handlery ani neobchádza prahové úrovne zaznamenávania.
Prí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ýsledok
INFO R1 Processed 3 items INFO R1 Default context INFO R2 Merged context
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.