ОтелПростойПроцессорЛогов
Простой процессор записей логов (SimpleLogRecordProcessor) по спецификации OpenTelemetry.
Описание
Синхронно передаёт каждую запись лога экспортеру в момент вызова ПриПоявлении(). Аналог ОтелПростойПроцессорСпанов для подсистемы логирования. Потокобезопасен — доступ к экспортеру защищён блокировкой.
Реализует ИнтерфейсПроцессорЛогов.
Конструктор
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
Экспортер | ОтелЭкспортерЛогов | — | Экспортер записей логов |
Методы
ПриПоявлении
Обрабатывает запись лога — синхронно передаёт экспортеру. После Закрыть() записи игнорируются. Ошибки экспортера логируются и не пробрасываются наверх.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ЗаписьЛога | ОтелЗаписьЛога | — | Запись лога |
Контекст | Соответствие, Неопределено | Неопределено | Разрешённый контекст |
Включен
Проверяет, будет ли процессор обрабатывать запись. Реализация не мутирует переданные объекты. Всегда возвращает Истина (процессор без фильтрации).
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
Контекст | Соответствие, Неопределено | Неопределено | Явный контекст |
ОбластьИнструментирования | ОтелОбластьИнструментирования | Неопределено | Scope логгера |
СтепеньСерьезности | Число | 0 | Номер серьезности |
ИмяСобытия | Строка | "" | Имя события |
Возвращает: Булево
СброситьБуфер
Принудительно отправляет накопленные данные. Своего буфера у простого процессора нет: в пределах таймаута он дожидается экспорта, начатого в другом потоке, затем сбрасывает буфер экспортера.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ТаймаутМс | Число | 0 | Таймаут в миллисекундах (0 — без ограничения) |
Возвращает: ОтелРезультатЭкспорта — результат сброса буфера экспортера; таймаут, если экспорт в другом потоке не завершился за срок
Закрыть
Завершает работу процессора: дожидается текущего экспорта, сбрасывает буфер экспортера (СброситьБуфер) и закрывает экспортер — в пределах общего срока. Экспортер закрывается и после сбоя сброса буфера. После вызова ПриПоявлении игнорирует новые записи. Идемпотентен: повторный вызов возвращает успех.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ТаймаутМс | Число | 30000 | Таймаут в миллисекундах (0 — без ограничения) |
Возвращает: ОтелРезультатЗакрытия — ошибка сброса буфера или закрытия экспортера; иначе таймаут, если истёк срок; иначе успех
ПринудительноВыгрузитьСРезультатом
Принудительно выгружает накопленные данные и возвращает результат.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ТаймаутМс | Число | 30000 | Таймаут в миллисекундах |
Возвращает: ОтелРезультатЗакрытия
Пример
Процессор = Новый ОтелПростойПроцессорЛогов(МойОтлпЭкспортер);
Провайдер = Новый ОтелПостроительПровайдераЛогирования()
.УстановитьРесурс(Ресурс)
.ДобавитьПроцессор(Процессор)
.Построить();