ОтелСостояниеТрассировки
Состояние трассировки (W3C TraceState).
Описание
Хранит пары ключ-значение, передаваемые по W3C TraceContext HTTP-заголовку tracestate. Ключи имеют формат vendorname или tenant@vendorname. Максимум 32 записи (ограничение W3C TraceState spec).
Аналог Java SDK: TraceState. Иммутабельный: методы Установить, Удалить возвращают новый экземпляр.
Методы
Получить
Возвращает значение по ключу.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
Ключ | Строка | — | Ключ записи |
Возвращает: Строка — значение или пустая строка
Установить
Добавляет или обновляет значение по ключу. Возвращает новый экземпляр (иммутабельность).
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
Ключ | Строка | — | Ключ записи |
Значение | Строка | — | Значение записи |
Возвращает: ОтелСостояниеТрассировки — новый экземпляр с добавленной записью
Удалить
Удаляет запись по ключу. Возвращает новый экземпляр.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
Ключ | Строка | — | Ключ для удаления |
Возвращает: ОтелСостояниеТрассировки — новый экземпляр без удалённой записи
ПолучитьОтелПодКлюч
Возвращает подзначение из записи OTel-вендора (vendor key = ot).
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ИмяПодКлюча | Строка | — | Имя подключа в OTel-записи |
Возвращает: Строка
УстановитьОтелПодКлюч
Устанавливает подзначение в записи OTel-вендора.
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
ИмяПодКлюча | Строка | — | Имя подключа |
Значение | Строка | — | Значение |
Принудительно | Булево | Ложь | Перезаписать существующее значение |
Возвращает: ОтелСостояниеТрассировки — новый экземпляр
Количество
Возвращает количество записей.
Возвращает: Число
Пример
СостояниеТрассировки = Спан.КонтекстСпана().СостояниеТрассировки();
НовоеСостояние = СостояниеТрассировки
.Установить("vendor1", "значение1")
.Установить("vendor2", "значение2");
Сообщить("Записей: " + НовоеСостояние.Количество());