База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници