CKTIS / Python
LoggerAdapter.info — bilježenje s kontekstom
LoggerAdapter.info bilježi poruku razine INFO s kontekstom adaptera, primjerice identifikatorom zahtjeva. Saznajte po čemu se zadana obrada extra razlikuje od merge_extra=True.
Verzija: Python 3.14; repository image, production runtime not attested
Sintaksa
adapter = logging.LoggerAdapter(logger, extra=None, merge_extra=False)
adapter.info(msg, *args, **kwargs)LoggerAdapter omata logger i dodaje kontekst bez ponavljanja pri svakom pozivu. LoggerAdapter.info(msg, *args, **kwargs) odgovara metodi Logger.info: bilježi poruku razine INFO, ovisno o konfiguraciji bilježenja.
Metoda process() prosljeđuje kontekst kao extra. Njegova polja postaju atributi LogRecord koje Formatter može prikazati, primjerice pomoću %(request_id)s. Argumente poruke proslijedite zasebno: adapter.info('Processed %s items', 3).
Zadana vrijednost merge_extra=False zanemaruje extra naveden u pojedinačnom pozivu. Postavka merge_extra=True, dostupna od Pythona 3.13, spaja oba skupa; prednost imaju vrijednosti iz pojedinačnog poziva. Primjer prikazuje oba načina rada.
Ključevi u extra ne smiju se sukobljavati s rezerviranim atributima bilježenja. Ako nedostaje polje koje zahtijeva formatter određenog handlera, oblikovanje ne uspijeva i taj handler ne ispisuje zapis. Drugi handler čiji formatter ne zahtijeva to polje i dalje može ispisati isti zapis. Adapter ne konfigurira handlere niti zaobilazi pragove razina bilježenja.
Primjeri
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='')Rezultat
INFO R1 Processed 3 items INFO R1 Default context INFO R2 Merged context
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.