Объект интервала APM

Следующие объекты напрямую связаны с API apmspan.

Каждое свойство соответствует столбцу в таблице otel_traces источника данных телеметрии. Список столбцов см. в разделе Поддерживаемые столбцы данных телеметрии.

Спан APM

Объект спана APM представляет спан (одну операцию внутри трейса, например HTTP-запрос, запрос к базе данных или вызов функции).

Спаны образуют иерархию, начиная с корневого спана, который представляет первую операцию запроса. Каждый другой спан является дочерним спаном того спана, во время которого была запущена его операция.

Объект спана APM имеет следующие свойства:

Свойство Тип Описание
timestamp integer Время в формате Unix (в наносекундах), когда был запущен спан.

Поведение свойства:
- только для чтения
traceid string ID трейса, к которому относится спан.

Поведение свойства:
- только для чтения
spanid string ID спана.

Поведение свойства:
- только для чтения
parent_spanid string ID родительского спана.
Для корневого спана значение пустое.

Поведение свойства:
- только для чтения
trace_state string Дополнительные данные, если они есть, которые инструменты трассировки добавляют к трейсу (см. контекст трейса W3C).

Поведение свойства:
- только для чтения
span_name string Имя операции, которую представляет спан (например, mysqli_query).

Поведение свойства:
- только для чтения
span_kind string Роль спана.

Возможные значения:
Unspecified - тип спана не указан;
Internal - операция, выполненная внутри приложения;
Server - обработка входящего запроса;
Client - исходящий запрос;
Producer - создание асинхронной операции (например, отправка сообщения);
Consumer - обработка асинхронной операции.

Поведение свойства:
- только для чтения
service_name string Имя сервиса, создавшего спан (например, zabbix-frontend), взятое из атрибута ресурса OpenTelemetry service.name.

Поведение свойства:
- только для чтения
resource_attributes object Атрибуты ресурса спана в формате «ключ-значение» (например, host.name: eabf8c2a5ddc).

Поведение свойства:
- только для чтения
scope_name string Имя области инструментирования, создавшей спан.

Поведение свойства:
- только для чтения
scope_version string Версия области инструментирования.

Поведение свойства:
- только для чтения
span_attributes object Атрибуты спана в формате «ключ-значение» (например, db.system: mysql).

Поведение свойства:
- только для чтения
duration integer Продолжительность спана в наносекундах.

Поведение свойства:
- только для чтения
status_code string Статус операции, которую представляет спан.

Возможные значения:
Unset - спану не был явно назначен статус;
Ok - операция успешно завершена;
Error - операция завершена с ошибкой.

Поведение свойства:
- только для чтения
status_message string Дополнительная информация, если она есть, о статусе спана.

Поведение свойства:
- только для чтения
events array Массив объектов событий спана, то есть значимых моментов времени во время операции (например, исключений).

Поведение свойства:
- только для чтения
links array Массив объектов связей спана, указывающих на связанные спаны в том же или другом трейсе.

Поведение свойства:
- только для чтения