Инспектор запросов

Инспектор запросов в "Explore (Исследование)" предоставляет подробную статистику по запросам, которая помогает понять и устранить проблемы с запросами. Инспектор запросов также позволяет просматривать необработанные данные, экспортировать данные в файл с разделителями-запятыми (CSV), экспортировать результаты журнала в формате TXT и просматривать запросы.

Интерфейс

Чтобы открыть инспектор запросов нужно выполнить следующие действия:

  1. перейти на страницу "Explore (Исследование)";
  2. запустить запрос, который требуется проверить;
  3. нажать Query inspector (Инспектор запросов).

Панель инспектора запросов открывается в нижней части страницы "Explore (Исследование)", где размещаются следующие вкладки:

  • Stats (Статистика) – показывает статистику по запросу, включая время выполнения запроса, время обработки данных и объем возвращаемых данных;
  • Query (Запрос) – предоставляет необработанные данные запроса и ответа, а также время запроса Подсистемой источника данных;
  • JSON – позволяет просматривать и копировать данные JSON и структуру фрейма данных JSON;
  • Data (Данные) – показывает необработанные данные, возвращаемые запросом; возможно загрузить информацию в файл CSV;
  • Error (Ошибки) – показывает все ошибки (отображается только в том случае, если запрос возвращает ошибку).

Вкладка "Статистика"

Производительность запроса можно проверить на вкладке "Stats (Статистика)", где отображается статистика, показывающая, сколько времени занимает запрос, сколько запросов отправляется, количество возвращаемых строк и идентификаторы трассировки. Эта информация может помочь устранить неполадки с запросами, особенно если какие-либо значения неожиданно высокие или низкие:

  1. открыть инспектор запросов;
  2. перейти на вкладку "Stats (Статистика)".

Статистика отображается в формате, доступном только для чтения.

Вкладка "Запросы"

Чтобы просмотреть необработанный запрос и ответ на вкладке "Query (Запрос)" необходимо:

  1. открыть инспектор запросов и перейти на вкладку "Query (Запрос)";
  2. нажать Refresh (Обновить).

Подсистема отправляет запрос на сервер и отображает результат. Возможно перейти к конкретным частям запроса, развернуть или свернуть его целиком. Чтобы скопировать данные для использования в других приложениях следует нажать Copy to clipboard (Копировать в буфер обмена).

Вкладка "JSON"

На вкладке "JSON" можно просматривать результаты в формате JSON и в виде фреймов данных моделей JSON.

  1. открыть инспектор запросов и перейти на вкладку "JSON";
  2. выбрать один из следующих параметров в раскрывающемся меню "Select source (Выбрать источник)":
  • Panel data (Данные панели) – отображает объект JSON, представляющий данные, полученные визуализацией из "Explore (Исследование)";
  • DataFrame JSON (from query) (JSON-файл фрейма данных (из запроса)) – отображает необработанный набор результатов без примененных преобразований и настроек полей.

Вкладка "Данные"

На вкладке "Data (Данные)" можно просматривать, проверять и загружать необработанные результаты запроса:

  1. открыть инспектор запросов и перейти на вкладку "Data (Данные)";
  2. нажать "Data options (Параметры данных)", чтобы просмотреть параметры в секции "Show data frame (Показать фрейм данных)";
  3. выбрать набор результатов обработки данных из выпадающего меню;
  4. для нескольких запросов или запросов с несколькими узлами можно выбрать "Series joined by time (Ряды, объединенные по времени)" в раскрывающемся списке, чтобы сразу просмотреть необработанные данные по всем запросам, по одному набору результатов в каждом столбце; можно нажать на заголовок любого столбца, чтобы отсортировать данные;
  5. переключить "Formatted data (Форматированные данные)" так, чтобы они соответствовали формату на панели;
  6. нажать Download for Excel (Скачать для Excel), чтобы загрузить CSV-файл, специально отформатированный для Excel;
  7. чтобы загрузить результаты в файл CSV, нажать Download CSV (Загрузить CSV) в правом верхнем углу панели инспектора запросов.

В зависимости от типа источника данных (например, Loki) или при наличии журналов в наборе результатов Подсистема создает файл TXT с необработанными данными журналов в папке для загрузок браузера по умолчанию. Возможно открыть его в выбранном средстве просмотра:

  1. выбрать "Query inspector (Инспектор запросов)";
  2. перейти на вкладку "Data (Данные)", чтобы просмотреть результаты запроса журнала;
  3. нажать Download logs (Загрузить журналы).

В зависимости от типа источника данных (например, Tempo) Подсистема генерирует файл JSON с результатами трассировки в одном из поддерживаемых форматов – Jaeger, Zipkin или OTLP:

  1. выбрать "Query inspector (Инспектор запросов)";
  2. перейти на вкладку "Data (Данные)", чтобы просмотреть результаты трассировки;
  3. нажать Download traces (Загрузить трассировки).