CKTIS / Python
LoggerAdapter.info — beleženje s kontekstom
LoggerAdapter.info zabeleži sporočilo INFO s kontekstom prilagodilnika, na primer identifikatorjem zahteve. Preverite, kako se privzeta obravnava extra razlikuje od merge_extra=True.
Različica: 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 ovije beležilnik in doda kontekst, ne da bi ga bilo treba ponavljati pri vsakem klicu. LoggerAdapter.info(msg, *args, **kwargs) ustreza metodi Logger.info: zabeleži sporočilo ravni INFO, skladno s konfiguracijo beleženja.
Metoda process() posreduje kontekst kot extra. Njegova polja postanejo atributi LogRecord, ki jih lahko prikaže Formatter, na primer z %(request_id)s. Argumente sporočila posredujte ločeno: adapter.info('Processed %s items', 3).
Privzeta vrednost merge_extra=False prezre extra, podan pri posameznem klicu. Nastavitev merge_extra=True, ki je na voljo od Pythona 3.13, združi oba nabora; prednost imajo vrednosti iz posameznega klica. Primer prikazuje obe vedenji.
Ključi v extra ne smejo biti v sporu z rezerviranimi atributi beleženja. Če manjka polje, ki ga zahteva oblikovalnik posameznega obravnavalnika, oblikovanje ne uspe in ta obravnavalnik zapisa ne izpiše. Drug obravnavalnik, katerega oblikovalnik tega polja ne zahteva, lahko isti zapis vseeno izpiše. Prilagodilnik ne konfigurira obravnavalnikov in ne zaobide pragov ravni beleženja.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.