ОтелФайловаяКонфигурация

Модуль файловой конфигурации OpenTelemetry SDK.

Описание

Читает YAML-файл конфигурации, выполняет подстановку переменных окружения и возвращает типизированную дата-модель (ОтелКонфигурация).

Реализует спецификацию:

• OTel File Configuration
• OTel Configuration Data Model

Формат файла: YAML, обязательное поле file_format (поддерживается версия 1.x).

Подстановка переменных: переменные вида ${ENV_VAR_NAME} автоматически заменяются значениями из окружения через ОтелПодстановкаПеременных.

Методы модуля

Разобрать

Разбирает файл конфигурации и возвращает типизированную модель ОтелКонфигурация.

Параметр	Тип	По умолчанию	Описание
ПутьКФайлу	Строка	—	Путь к YAML-файлу конфигурации

Возвращает: ОтелКонфигурация — разобранная конфигурация

Исключения:

• Файл не найден по указанному пути
• YAML не является маппингом верхнего уровня
• Поле file_format не указано
• Версия формата не поддерживается (не 1.x)

Пример

#Использовать opentelemetry

// Разобрать файл конфигурации
Конфигурация = ОтелФайловаяКонфигурация.Разобрать("/etc/otel/config.yaml");

// Проверить флаг отключения
Если Конфигурация.Отключен Тогда
    // OpenTelemetry отключён в конфигурации
    Возврат;
КонецЕсли;

// Использовать автоконфигурацию
ОтелАвтоконфигурация.Применить(Конфигурация);

Пример YAML-файла конфигурации:

file_format: "1.0"
disabled: false

resource:
  attributes:
    service.name: "${SERVICE_NAME}"
    service.version: "1.0.0"

tracer_provider:
  processors:
    - batch:
        exporter:
          otlp:
            protocol: http/protobuf
            endpoint: "${OTLP_ENDPOINT}"