CKTIS / Python
LoggerAdapter.info — logging contestuale
LoggerAdapter.info registra un messaggio INFO con il contesto dell’adattatore, ad esempio un identificativo della richiesta. Scopri la differenza tra la gestione predefinita di extra e merge_extra=True.
Versione: Python 3.14; repository image, production runtime not attested
Sintassi
adapter = logging.LoggerAdapter(logger, extra=None, merge_extra=False)
adapter.info(msg, *args, **kwargs)LoggerAdapter avvolge un logger e aggiunge contesto senza doverlo ripetere a ogni chiamata. LoggerAdapter.info(msg, *args, **kwargs) corrisponde a Logger.info: registra un messaggio di livello INFO, in base alla configurazione del logging.
Il metodo process() passa il contesto come extra. I suoi campi diventano attributi di LogRecord che un Formatter può visualizzare, ad esempio usando %(request_id)s. Passa separatamente gli argomenti del messaggio: adapter.info('Processed %s items', 3).
Per impostazione predefinita, merge_extra=False ignora extra fornito in una singola chiamata. Impostando merge_extra=True, disponibile da Python 3.13, i due insiemi vengono combinati; prevalgono i valori specifici della chiamata. L’esempio mostra entrambi i comportamenti.
Le chiavi di extra non devono entrare in conflitto con gli attributi di logging riservati. Se manca un campo richiesto dal formatter di un handler, la formattazione non riesce e quell’handler non emette il record. Un altro handler il cui formatter non richiede quel campo può comunque emettere lo stesso record. L’adattatore non configura gli handler né aggira le soglie dei livelli di logging.
Esempi
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='')Risultato
INFO R1 Processed 3 items INFO R1 Default context INFO R2 Merged context
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.