ОтелSdk
Главный класс OpenTelemetry SDK — единая точка входа в телеметрию.
Описание
Агрегирует ОтелПровайдерТрассировки, ОтелПровайдерЛогирования, ОтелПровайдерМетрик и пропагаторы контекста. Предоставляет shortcut-методы для получения ОтелТрассировщик, ОтелЛоггер и ОтелМетр.
Аналог Java SDK: OpenTelemetrySdk.
Экземпляр создаётся через ОтелПостроительSdk — прямой вызов конструктора в пользовательском коде не рекомендуется.
Конструктор
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ПровайдерТрассировки | ОтелПровайдерТрассировки | Неопределено | Провайдер трассировки |
ПровайдерЛогирования | ОтелПровайдерЛогирования | Неопределено | Провайдер логирования |
ПровайдерМетрик | ОтелПровайдерМетрик | Неопределено | Провайдер метрик |
Пропагаторы | ОтелКомпозитныйПропагатор | Неопределено | Пропагаторы контекста |
Методы
ПровайдерТрассировки
Возвращает провайдер трассировки.
Возвращает: ОтелПровайдерТрассировки — провайдер трассировки
ПровайдерЛогирования
Возвращает провайдер логирования.
Возвращает: ОтелПровайдерЛогирования — провайдер логирования
ПровайдерМетрик
Возвращает провайдер метрик.
Возвращает: ОтелПровайдерМетрик — провайдер метрик
Пропагаторы
Возвращает пропагаторы контекста.
Возвращает: ОтелКомпозитныйПропагатор, Неопределено — пропагаторы контекста или Неопределено
ПолучитьТрассировщик
Shortcut: получить трассировщик. Аналог Java SDK: openTelemetry.getTracer("name").
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ИмяБиблиотеки | Строка | — | Имя инструментирующей библиотеки |
ВерсияБиблиотеки | Строка | "" | Версия библиотеки |
Возвращает: ОтелТрассировщик — трассировщик
ПостроительТрассировщика
Shortcut: получить построитель трассировщика.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ИмяБиблиотеки | Строка | — | Имя инструментирующей библиотеки |
Возвращает: ОтелПостроительТрассировщика — построитель трассировщика
ПолучитьЛоггер
Shortcut: получить логгер.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ИмяБиблиотеки | Строка | — | Имя инструментирующей библиотеки |
ВерсияБиблиотеки | Строка | "" | Версия библиотеки |
Возвращает: ОтелЛоггер — логгер
ПостроительЛоггера
Shortcut: получить построитель логгера.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ИмяБиблиотеки | Строка | — | Имя инструментирующей библиотеки |
Возвращает: ОтелПостроительЛоггера — построитель логгера
ПолучитьМетр
Shortcut: получить метр.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ИмяБиблиотеки | Строка | — | Имя инструментирующей библиотеки |
ВерсияБиблиотеки | Строка | "" | Версия библиотеки |
Возвращает: ОтелМетр — метр
ПостроительМетра
Shortcut: получить построитель метра.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ИмяБиблиотеки | Строка | — | Имя инструментирующей библиотеки |
Возвращает: ОтелПостроительМетра — построитель метра
СброситьБуфер
Принудительно отправляет все накопленные данные из всех провайдеров.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ТаймаутМс | Число | 0 | Таймаут в миллисекундах (0 — без ограничения) |
Возвращает: ОтелРезультатЭкспорта — агрегированный результат сброса всех провайдеров
Закрыть
Завершает работу всех провайдеров.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ТаймаутМс | Число | 30000 | Таймаут завершения в миллисекундах. Переопределяется переменной окружения OTEL_SDK_SHUTDOWN_TIMEOUT |
Возвращает: ОтелРезультатЗакрытия — первый неуспешный результат или успешный результат
Пример
Сдк = Новый ОтелПостроительSdk()
.УстановитьПровайдерТрассировки(ПровайдерТрассировки)
.УстановитьПровайдерМетрик(ПровайдерМетрик)
.Построить();
Трассировщик = Сдк.ПолучитьТрассировщик("мой-сервис");
Спан = Трассировщик.НачатьСпан("обработка-запроса");
// ...
Спан.Завершить();
Сдк.Закрыть();