Трейсы

Трейс — это один запрос, прослеженный через все сервисы, которые он затрагивает. Каждый шаг — это спан: HTTP-вызов, запрос к базе данных, вызов другого сервиса. Трейсы показывают, на что медленный запрос потратил время и где сломался неудачный.

Откройте Observability → Трейсы на странице статуса. Каждая строка — один запрос.

Обозреватель трейсов с длительностью запросов во времени и одной строкой на запрос

Трейсы появятся, как только приложение начнёт их отправлять: отметьте Трейсы при копировании промпта настройки или используйте автоинструментирование.

Как читать график

Каждая точка — это запрос, расположенный по времени и длительности. Красные точки завершились ошибкой. Над графиком:

  • Трейсы: сколько запросов нашёл поиск.
  • Ошибки: сколько завершились ошибкой и какова их доля.
  • p50, p95, p99: половина, 95 % и 99 % запросов были быстрее этого значения.

Выделите область на графике, чтобы приблизить временное окно.

Поиск медленных и неудачных запросов

Пользуйтесь полем поиска так же, как на странице Логи. Эти фильтры сделаны для трейсов:

ФильтрЧто находит
status:errorЗапросы, завершившиеся ошибкой
duration:>1sЗапросы дольше секунды. Также >500ms, <100ms
service:apiЗапросы, обработанные одним сервисом
span.name:Спаны с заданным именем, например GET /v1/users
Любой атрибутНапример http.route: или http.response.status_code:

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

Кнопка загрузки экспортирует список в CSV.

Просмотр трейса

Нажмите на строку. Трейс откроется: каждый спан на временной шкале, вложенный под спаном, который его вызвал. Длинные полосы показывают, куда ушло время.

Трейс через три сервиса с медленным вызовом Okta внизу каскада

В этом примере загрузка страницы занимает 842 мс. Каскад показывает причину: web вызывает api, api вызывает sso, а sso ждёт Okta 468 мс.

  • Нажмите на спан, чтобы увидеть его атрибуты, например маршрут, код ответа или запрос к базе данных.
  • N лога из этого спана открывает логи, записанные во время этого спана.
  • N лога вверху открывает все логи запроса во всех сервисах.
  • Скопировать ID трейса копирует ID, чтобы поделиться им или искать через trace_id:.
  • Клавиши ↑ ↓ или J K переключают на предыдущий или следующий трейс, Esc закрывает.

Исправление неудачного запроса

Спаны с ошибкой выделены красным. Только ошибки скрывает успешные спаны, чтобы ошибка была заметна даже в длинном трейсе.

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

Скопировать промпт для исправления копирует описание неудачного запроса: спаны, их ошибки и атрибуты. Вставьте его в агент в проекте приложения, и у него будет всё, чтобы найти причину.