# Трейси

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

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

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

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

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

Трейси з’являться, щойно застосунок почне їх надсилати: позначте **Трейси** під час [копіювання промпту налаштування](https://instatus.com/help/uk/observability/send-logs#спосіб-1-скопіюйте-промпт) або використайте автоінструментування.

## Як читати графік

Кожна точка — це запит, розміщений за часом і тривалістю. Червоні точки завершилися помилкою. Над графіком:

- **Трейси**: скільки запитів знайшов пошук.
- **Помилки**: скільки завершилися помилкою і яка їхня частка.
- **p50**, **p95**, **p99**: половина, 95 % і 99 % запитів були швидшими за це значення.

Виділіть ділянку на графіку, щоб наблизити часове вікно.

## Пошук повільних і невдалих запитів

Користуйтеся полем пошуку так само, як на сторінці [Логи](https://instatus.com/help/uk/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/uk/observability/metrics): Помічайте зміни, найбільші — першими
- [Логи](https://instatus.com/help/uk/observability/logs): Шукайте, фільтруйте й переглядайте логи наживо
