Трассировки
Обзор
В разделе APM > Трассировки отображаются трассировки, собранные из ваших приложений и служб.
Трассировка представляет собой путь, который запрос проходит через приложения и службы. Например, когда пользователь нажимает кнопку Оформить заказ в интернет-магазине, запрос может пройти от службы веб-интерфейса через службы оформления и оплаты заказа к базе данных.
Трассировка состоит из интервалов. Каждый интервал представляет одну операцию, например HTTP-запрос, который служба веб-интерфейса отправляет службе оформления заказа, запрос к базе данных для сохранения заказа или вызов функции, рассчитывающей стоимость доставки.
Интервалы образуют иерархию. Корневой интервал представляет первую операцию запроса. Каждый другой интервал является дочерним интервалом интервала, во время которого была запущена его операция. Например, служба веб-интерфейса, получающая запрос Оформить заказ, является корневым интервалом, а служба оформления заказа, обрабатывающая заказ, — его дочерним интервалом.
Каждый интервал создается службой (например, zabbix-frontend; имя определяется атрибутом ресурса OpenTelemetry service.name) и областью инструментирования — частью кода, которая его создала (например, библиотекой, отслеживающей HTTP-запросы).
Чтобы предоставить контекст для каждой операции, интервалы также содержат ключ-значение атрибуты: атрибуты интервала описывают саму операцию (например, http.method: POST), а атрибуты ресурса описывают службу и среду, в которой она работает (например, host.name: eabf8c2a5ddc).
Дополнительную информацию о трассировках см. в документации OpenTelemetry.
Пример сбора трассировок см. в разделе Мониторинг производительности приложений с помощью OpenTelemetry.

Раздел APM > Трассировки содержит следующие элементы:
- Кнопка Режим киоска — отображать только содержимое страницы без меню и заголовка.
- Выбор периода времени — выбрать период времени, за который необходимо отображать трассировки.
- Фильтр — отображать только интересующие вас трассировки.
- Список трассировок — просматривать трассировки, описанные их корневыми интервалами.
- Панель трассировки — просматривать все интервалы выбранной трассировки на временной шкале.
Список трассировок
Каждая строка в списке трассировок представляет трассировку; в столбцах отображаются данные её корневого спана.

Трассировки отображаются в настраиваемой таблице.
Кнопка
Настроить таблицу в заголовке таблицы позволяет отображать, скрывать или изменять порядок столбцов, а также восстанавливать макет по умолчанию.
Размер каждого столбца также можно изменить, перетащив его правую границу; для сброса размера дважды щёлкните границу.
Все изменения применяются немедленно и сохраняются для текущего пользователя.
Список трассировок может содержать следующие столбцы:
Каждый столбец соответствует столбцу в таблице otel_traces источника данных телеметрии; список столбцов см. в разделе Поддерживаемые столбцы данных телеметрии.
Большинство столбцов имеют те же названия, что и в источнике данных (например, Идентификатор трассировки соответствует столбцу TraceId).
Если названия отличаются, столбец источника данных указан в таблице ниже.
| Столбец | Описание |
|---|---|
| Идентификатор трассировки | Идентификатор трассировки, общий для всех спанов, относящихся к трассировке. |
| Идентификатор спана | Идентификатор корневого спана. |
| Состояние трассировки | Дополнительные данные, если они есть, которые инструменты трассировки добавляют к трассировке (см. W3C Trace Context). |
| Имя сервиса | Сервис, создавший корневой спан, за которым следует количество спанов в трассировке. Если какие-либо спаны имеют код состояния Ошибка (см. ниже), красный значок показывает их количество. |
| Имя операции | Операция, которую представляет корневой спан (например, POST /zabbix.php).Столбец источника данных: SpanName. |
| Тип спана | Роль корневого спана: Не указано - не указан. Внутренний - операция, выполняемая внутри приложения. Сервер - обработка входящего запроса. Клиент - исходящий запрос. Производитель - создание асинхронной операции (например, отправка сообщения). Потребитель - обработка асинхронной операции. |
| Имя области | Область инструментирования, создавшая корневой спан. |
| Версия области | Версия области инструментирования. |
| Код состояния | Состояние операции, которую представляет корневой спан: Не задано - корневому спану не присвоено явное состояние. ОК - операция успешно завершена. Ошибка - операция завершена с ошибкой. |
| Сообщение о состоянии | Дополнительная информация, если она есть, о состоянии. |
| Время начала | Дата и время начала корневого спана. Столбец источника данных: Timestamp. |
| Атрибуты спана | Атрибуты корневого спана. Нажмите кнопку с тремя точками |
| Атрибуты ресурса | Атрибуты ресурса корневого спана. Нажмите кнопку с тремя точками |
| Длительность | Длительность трассировки; серая полоса показывает её относительно других трассировок. |
Панель трассировки
Нажмите на трассировку в списке трассировок, чтобы открыть панель трассировки, в которой на временной шкале отображаются все спаны трассировки: какие операции выполнялись, в каком порядке и сколько времени заняла каждая из них.

Панель трассировки может содержать следующие элементы:
| Элемент | Описание |
|---|---|
| Идентификатор трассировки | Идентификатор выбранной трассировки. |
| Обзор временной шкалы трассировки | Вся трассировка со спанами, расположенными максимум в 8 строках (несколько спанов могут находиться в одной строке). Перетаскивайте границы выбранного диапазона или сам диапазон, чтобы увеличить масштаб временной шкалы спанов для этой части трассировки. |
| Дерево спанов | Спаны в иерархическом представлении; для каждого отображаются его сервис (полужирным шрифтом), имя операции и количество непосредственных дочерних спанов. |
| Временная шкала спанов | Спаны в виде полос: положение и длина показывают, когда начался каждый спан и сколько времени он выполнялся. Маркеры показывают события (например, исключения); наведите указатель на маркер или нажмите на него, чтобы просмотреть подробности. |
| Подробности спана | Нажмите на спан в дереве спанов, чтобы просмотреть его подробности, атрибуты и события. Например, если операция завершилась ошибкой из-за исключения, в разделе События отображается событие exception с типом исключения, сообщением и трассировкой стека. |
Использование фильтра
Вы можете использовать фильтр, чтобы отображать только интересующие вас трассировки.

Чтобы отфильтровать данные по атрибутам, введите ключ атрибута, выберите оператор и введите значение атрибута.
Поддерживаются следующие операторы:
- Содержит - (по умолчанию) значение атрибута содержит введенную строку.
- Равно - значение атрибута равно введенной строке.
- Не содержит - значение атрибута не содержит введенную строку.
- Не равно - значение атрибута не равно введенной строке.
- Существует - атрибут с введенным ключом существует.
- Не существует - атрибут с введенным ключом не существует.
Если вы добавили несколько условий, выберите способ их оценки:
- И/ИЛИ - (по умолчанию) должны выполняться все условия; условия с одинаковым ключом атрибута объединяются с помощью ИЛИ.
- ИЛИ - должно выполняться хотя бы одно условие.