Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri