Трейси

Трейс — це один запит, простежений через усі сервіси, яких він торкається. Кожен крок — це спан: 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 закриває.

Виправлення невдалого запиту

Спани з помилкою виділено червоним. Лише помилки приховує успішні спани, щоб помилка була помітна навіть у довгому трейсі.

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

Скопіювати промпт для виправлення копіює опис невдалого запиту: спани, їхні помилки й атрибути. Вставте його в агента в проєкті застосунку, і він матиме все, щоб знайти причину.