CKTIS / Python
LoggerAdapter.info — логване с контекст
LoggerAdapter.info записва съобщение INFO с контекст от адаптера, например идентификатор на заявка. Научете как обработката на extra по подразбиране се различава от merge_extra=True.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
adapter = logging.LoggerAdapter(logger, extra=None, merge_extra=False)
adapter.info(msg, *args, **kwargs)LoggerAdapter обвива логер и добавя контекст, без той да се повтаря при всяко извикване. LoggerAdapter.info(msg, *args, **kwargs) съответства на Logger.info: записва съобщение на ниво INFO според конфигурацията на логването.
Методът process() предава контекста като extra. Полетата му стават атрибути на LogRecord, които Formatter може да показва, например чрез %(request_id)s. Подайте аргументите на съобщението отделно: adapter.info('Processed %s items', 3).
По подразбиране merge_extra=False игнорира extra, подадено при отделно извикване. Задаването на merge_extra=True, налично от Python 3.13, обединява двата набора; стойностите от конкретното извикване имат предимство. Примерът показва и двата начина на работа.
Ключовете в extra не трябва да съвпадат с резервирани атрибути за логване. Ако липсва поле, необходимо на форматиращия обект на даден обработчик, форматирането завършва с грешка и този обработчик не извежда записа. Друг обработчик, чийто форматиращ обект не изисква това поле, все пак може да изведе същия запис. Адаптерът не конфигурира обработчици и не заобикаля праговете на нивата за логване.
Примери
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='')Резултат
INFO R1 Processed 3 items INFO R1 Default context INFO R2 Merged context
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.