CKTIS / Python
LoggerAdapter.info — kontextbezogenes Logging
LoggerAdapter.info protokolliert eine INFO-Meldung mit Adapterkontext, etwa einer Anfrage-ID. Erfahre, worin sich das standardmäßige Verhalten von extra und merge_extra=True unterscheidet.
Version: Python 3.14; repository image, production runtime not attested
Syntax
adapter = logging.LoggerAdapter(logger, extra=None, merge_extra=False)
adapter.info(msg, *args, **kwargs)LoggerAdapter umschließt einen Logger und ergänzt Kontext, ohne ihn bei jedem Aufruf erneut angeben zu müssen. LoggerAdapter.info(msg, *args, **kwargs) entspricht Logger.info: Die Methode protokolliert eine Meldung der Stufe INFO, abhängig von der Logging-Konfiguration.
Die Methode process() übergibt den Kontext als extra. Dessen Felder werden zu LogRecord-Attributen, die ein Formatter anzeigen kann, beispielsweise mit %(request_id)s. Übergib die Nachrichtenargumente separat: adapter.info('Processed %s items', 3).
Standardmäßig ignoriert merge_extra=False das extra, das bei einem einzelnen Aufruf angegeben wird. Mit merge_extra=True, verfügbar seit Python 3.13, werden beide Mengen zusammengeführt; Werte des Aufrufs haben Vorrang. Das Beispiel zeigt beide Verhaltensweisen.
Schlüssel in extra dürfen nicht mit reservierten Logging-Attributen kollidieren. Fehlt ein Feld, das der Formatter eines Handlers benötigt, schlägt die Formatierung fehl und dieser Handler gibt den Datensatz nicht aus. Ein anderer Handler, dessen Formatter dieses Feld nicht benötigt, kann denselben Datensatz weiterhin ausgeben. Der Adapter konfiguriert weder Handler noch umgeht er Logging-Schwellenwerte.
Beispiele
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='')Ergebnis
INFO R1 Processed 3 items INFO R1 Default context INFO R2 Merged context
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.