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

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

На этой странице:

Введение

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

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

Как открыть

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

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

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

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

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

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

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

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

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

./images/tracing-ui.png

Инструменты анализа дерева спанов

Над диаграммой водопада доступен набор инструментов для быстрого разбора сложных трейсов:

  • Поиск спанов — поиск по имени операции прямо в дереве трейса с переходом между совпадениями.
  • Быстрый переход к узкому месту — платформа подсказывает спан, вносящий наибольший вклад в общую длительность трейса, и прокручивает дерево к нему.
  • Подсветка критического пути — выделяет цепочку спанов, определяющую общее время выполнения трейса.
  • Быстрый переход к ошибочному спану — по клику на индикатор «Источник ошибки» дерево прокручивается к спану, где возникла ошибка.
  • Подсветка причины ошибки — платформа определяет спан, в котором ошибка возникла (а не была проброшена выше по цепочке вызовов), и показывает её тип.
  • Скрытие спанов 0 мс — убирает мгновенные спаны, чтобы не загромождать дерево.
  • Сжатие пауз — схлопывает интервалы ожидания между спанами, оставляя видимой только «свою» работу.
  • Подсветка спанов сервиса — при выборе названия сервиса подсвечиваются все его спаны в дереве.

Детали спана

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

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

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

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

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

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

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

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

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

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

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

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