Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje