Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori