CKTIS / Python
LoggerAdapter.info — registro con contexto
LoggerAdapter.info registra un mensaje INFO con el contexto del adaptador, como un identificador de solicitud. Descubre en qué se diferencia el comportamiento predeterminado de extra de merge_extra=True.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
adapter = logging.LoggerAdapter(logger, extra=None, merge_extra=False)
adapter.info(msg, *args, **kwargs)LoggerAdapter envuelve un logger y añade contexto sin tener que repetirlo en cada llamada. LoggerAdapter.info(msg, *args, **kwargs) corresponde a Logger.info: registra un mensaje de nivel INFO, sujeto a la configuración del registro.
El método process() pasa el contexto como extra. Sus campos se convierten en atributos de LogRecord que un Formatter puede mostrar, por ejemplo con %(request_id)s. Pasa los argumentos del mensaje por separado: adapter.info('Processed %s items', 3).
De forma predeterminada, merge_extra=False ignora el extra proporcionado en una llamada individual. Al establecer merge_extra=True, disponible desde Python 3.13, se combinan ambos conjuntos; prevalecen los valores específicos de la llamada. El ejemplo muestra ambos comportamientos.
Las claves de extra no deben entrar en conflicto con los atributos reservados del registro. Si falta un campo que necesita el formateador de un handler, se produce un error de formato y ese handler no emite el registro. Otro handler cuyo formateador no necesite ese campo aún puede emitir el mismo registro. El adaptador no configura handlers ni elude los umbrales de nivel de registro.
Ejemplos
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='')Resultado
INFO R1 Processed 3 items INFO R1 Default context INFO R2 Merged context
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.