Traces Explorer — обозреватель трейсов

Руководство по работе с Traces Explorer — интерфейсом для поиска и анализа распределенных трейсов в Proto Observability Platform.

Введение

Traces Explorer — раздел платформы Proto Observability, предоставляющий интерфейс для поиска и анализа распределенных трейсов (traces). Traces Explorer реализован как преднастроенный дашборд (слой GENERAL, дашборд «Traces-Explorer»), который включает виджеты для поиска, фильтрации и визуализации трейсов.

Распределенный трейс (trace) — это запись прохождения запроса через цепочку сервисов и компонентов. Каждый трейс состоит из набора спанов (spans), представляющих отдельные операции в рамках транзакции.

Версия

Данный функционал доступен начиная с версии 200.

Как открыть

Перейдите в раздел Трейсы в основном меню навигации платформы. Откроется страница Traces Explorer с преднастроенными виджетами для поиска и анализа трейсов.

Поиск и фильтрация трейсов

Traces Explorer предоставляет возможности для поиска трейсов по различным критериям:

По сервису — выберите один или несколько сервисов для отображения их трейсов
По операции — фильтрация по имени операции (endpoint, метод)
По длительности — поиск трейсов, превышающих заданное время выполнения
По статусу — фильтрация по статусу выполнения (успешные, с ошибками)
По временному диапазону — выбор периода для анализа

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

Анализ трейса

При выборе конкретного трейса из результатов поиска открывается детальное представление, включающее:

Временная шкала (Timeline / Waterfall)

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

Детали спана

При выборе спана на временной шкале отображаются его детали:

Имя операции — название операции, которую выполняет спан
Сервис — сервис, в котором выполнялась операция
Длительность — время выполнения операции
Теги — атрибуты спана (HTTP метод, URL, статус код и другие)
Логи / События — записи событий, привязанные к спану

Типичные сценарии использования

Анализ медленных запросов

Откройте Traces Explorer
Установите фильтр по длительности, превышающей ожидаемое время
Выберите трейс из результатов
На временной шкале определите, какой спан (сервис/операция) занимает наибольшее время

Поиск ошибок в цепочке вызовов

Установите фильтр по статусу «ошибка»
Откройте трейс с ошибкой
На диаграмме водопада найдите спан с ошибкой (обычно выделен цветом)
Просмотрите теги и логи спана для определения причины

Анализ зависимостей сервисов

Выберите интересующий сервис
Просмотрите трейсы, проходящие через этот сервис
На временной шкале определите, какие сервисы вызываются и в каком порядке

Связь с инструментированием

Данные трейсов поступают в платформу из инструментированных приложений через агент платформы. Для того чтобы трейсы были доступны в Traces Explorer, приложения должны быть настроены на отправку данных распределенного трейсинга.

Подробнее о настройке инструментирования приложений см. разделы: