# Трейсы

Source: https://instatus.com/help/ru/observability/traces

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

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

![Обозреватель трейсов с длительностью запросов во времени и одной строкой на запрос](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Поиск](https://instatus.com/help/ru/observability/traces#поиск-медленных-и-неудачных-запросов) | status:error, duration:>1s, service: |
| [Открыть](https://instatus.com/help/ru/observability/traces#просмотр-трейса) | Нажмите на строку, чтобы увидеть каскад |
| [Исправить](https://instatus.com/help/ru/observability/traces#исправление-неудачного-запроса) | Скопируйте промпт для исправления для агента |
| [Логи](https://instatus.com/help/ru/observability/traces#просмотр-трейса) | Перейдите к логам запроса |

Трейсы появятся, как только приложение начнёт их отправлять: отметьте **Трейсы** при [копировании промпта настройки](https://instatus.com/help/ru/observability/send-logs#способ-1-скопируйте-промпт) или используйте автоинструментирование.

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

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

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

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

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

Пользуйтесь полем поиска так же, как на странице [Логи](https://instatus.com/help/ru/observability/logs#фильтры). Эти фильтры сделаны для трейсов:

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

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

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

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

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

![Трейс через три сервиса с медленным вызовом Okta внизу каскада](https://instatus.com/help/observability/trace-waterfall.png)

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

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

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

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

![Неудачный запрос со спанами с ошибкой, выделенными красным, и кнопкой копирования промпта для исправления](https://instatus.com/help/observability/trace-error.png)

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

- [Метрики](https://instatus.com/help/ru/observability/metrics): Находите изменения, самые большие — первыми
- [Логи](https://instatus.com/help/ru/observability/logs): Ищите, фильтруйте и смотрите логи в реальном времени
