Объект трассировки APM
Следующие объекты напрямую связаны с API apmtrace.
Каждое свойство, за исключением span_count и error_count, соответствует столбцу в таблице otel_traces источника данных телеметрии.
Большинство свойств соответствуют столбцу с таким же именем (например, свойство span_name соответствует столбцу SpanName).
Если имена различаются, столбцы источника данных указаны в таблицах ниже.
Список столбцов см. в разделе Поддерживаемые столбцы данных телеметрии.
Трассировка APM
Объект трассировки APM представляет трассировку (путь, который запрос проходит через ваши приложения и службы). Трассировка состоит из одного или нескольких интервалов; каждый интервал представляет одну операцию.
Объект трассировки APM основан на корневом интервале трассировки (интервале, с которого начинается трассировка и у которого нет родительского интервала).
Все свойства содержат данные корневого интервала, за исключением span_count и error_count, которые вычисляются на основе всех интервалов трассировки.
Объект трассировки APM имеет следующие свойства:
| Свойство | Тип | Описание |
|---|---|---|
| timestamp | integer | Время Unix (в наносекундах), когда начался корневой интервал. Поведение свойства: - только для чтения |
| traceid | string | Идентификатор трассировки, общий для всех интервалов, относящихся к трассировке. Поведение свойства: - только для чтения |
| spanid | string | Идентификатор корневого интервала. Поведение свойства: - только для чтения |
| trace_state | string | Дополнительные данные, если они есть, которые инструменты трассировки добавляют к трассировке (см. контекст трассировки W3C). Поведение свойства: - только для чтения |
| span_name | string | Имя операции, которую представляет корневой интервал (например, POST /zabbix.php).Поведение свойства: - только для чтения |
| span_kind | string | Роль корневого интервала. Возможные значения: Unspecified - тип интервала не указан;Internal - операция, выполняемая внутри приложения;Server - обработка входящего запроса;Client - исходящий запрос;Producer - создание асинхронной операции (например, отправка сообщения);Consumer - обработка асинхронной операции.Поведение свойства: - только для чтения |
| service_name | string | Имя службы, создавшей корневой интервал (например, zabbix-nginx), полученное из атрибута ресурса OpenTelemetry service.name.Поведение свойства: - только для чтения |
| resource_attributes | object | Пары ключ-значение атрибутов ресурса корневого интервала (например, host.name: eabf8c2a5ddc).Поведение свойства: - только для чтения |
| scope_name | string | Имя области инструментирования, создавшей корневой интервал. Поведение свойства: - только для чтения |
| scope_version | string | Версия области инструментирования. Поведение свойства: - только для чтения |
| span_attributes | object | Пары ключ-значение атрибутов интервала корневого интервала (например, http.method: POST).Поведение свойства: - только для чтения |
| duration | integer | Продолжительность трассировки в наносекундах. Поведение свойства: - только для чтения |
| status_code | string | Статус операции, которую представляет корневой интервал. Возможные значения: Unset - корневому интервалу не присвоен явный статус;Ok - операция успешно завершена;Error - операция завершена с ошибкой.Поведение свойства: - только для чтения |
| status_message | string | Дополнительная информация, если она есть, о статусе корневого интервала. Поведение свойства: - только для чтения |
| events | array | Массив объектов событий корневого интервала, то есть значимых моментов времени во время выполнения операции (например, исключений). Поведение свойства: - только для чтения |
| links | array | Массив объектов связей корневого интервала, указывающих на связанные интервалы в той же или другой трассировке. Поведение свойства: - только для чтения |
| span_count | integer | Общее количество интервалов в трассировке. Поведение свойства: - только для чтения |
| error_count | integer | Количество интервалов в трассировке, для которых status_code имеет значение Error.Поведение свойства: - только для чтения |
Событие
Объект события имеет следующие свойства.
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Время в формате Unix (в наносекундах), когда произошло событие. Столбец источника данных: Events.Timestamp |
| name | string | Имя события. Столбец источника данных: Events.Name |
| attributes | object | Атрибуты «ключ-значение» с дополнительной информацией о событии, если она есть. Столбец источника данных: Events.Attributes |
Ссылка
Объект ссылки имеет следующие свойства.
| Свойство | Тип | Описание |
|---|---|---|
| traceid | string | Идентификатор трассировки, содержащей связанную операцию. Столбец источника данных: Links.TraceId |
| spanid | string | Идентификатор связанной операции. Вместе с traceid однозначно идентифицирует связанную операцию.Столбец источника данных: Links.SpanId |
| trace_state | string | Состояние трассировки связанной операции, если оно задано (см. W3C Trace Context). Столбец источника данных: Links.TraceState |
| attributes | object | Атрибуты «ключ-значение» с дополнительной информацией о ссылке. Столбец источника данных: Links.Attributes |