Echolot
Начало работы

Главная и Sonar

Главная — обзор рабочего пространства; её карточка Sonar рисует все отправки за последний час, день, неделю или месяц по тому, сколько заняло получение ответа.

Главная — страница, с которой начинается окно рабочего пространства. Она показывает, что есть в рабочем пространстве, на что стоит взглянуть и как отвечали ваши запросы. Откройте её кнопкой Главная в боковой панели или сочетанием ⇧⌘H.

Главная: приветствие, счётчики рабочего пространства, карточка Sonar с пингами и показателями, карточки недавних запросов, последних ответов, тестов и окружений

Что показывает Главная

Сверху вниз:

  • Приветствие и одна строка новостей. Она сообщает, сколько проверок не проходит или у скольких запросов есть несохранённые изменения, а в остальных случаях говорит Ничто не ждёт вашего внимания. В новом рабочем пространстве без запросов предлагается импортировать коллекцию или создать первый запрос.
  • Рабочее пространство: его имя и папка, а также числа Запросы, Папки, Окружения, Переменные и Проверки.
  • Sonar, о нём ниже.
  • Недавние запросы с кнопкой Новый запрос; Последние ответы; Тесты — у скольких запросов есть проверки и какие из них не проходят — с кнопкой Показать все; и Окружения с кнопкой Управление и отметкой у защищённых.

Щёлкните запрос или ответ в карточке, чтобы открыть его.

Sonar

Sonar рисует каждую отправку за период в виде пинга — так, как сонар рисует эхо. Время идёт слева направо: от начала периода слева до сейчас справа. Глубина — это время получения ответа: быстрый ответ остаётся у поверхности, медленный погружается. Одного взгляда достаточно, чтобы понять, быстро ли отвечал API, где он замедлился и не было ли сбоев.

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

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

  • Зоны. Шкала глубины логарифмическая, поэтому читаются и быстрый, и медленный края. ВЕРХ — всё быстрее 250 мс, ТОЛЩА — от 250 мс до 1 с, а ГЛУБИНА — дольше 1 с.
  • Цвет пинга — класс его статуса. Легенда в заголовке карточки называет их: 2xx, 3xx, 4xx и 5xx · с ошибкой; последний также означает отправку, на которую не пришло вообще никакого ответа.
  • Морское дно — затенённое дно под самыми медленными ответами каждого отрезка времени. Оно поднимается и опускается вместе с ними.
  • Линия справа отмечает «сейчас». Когда отправка завершается, пока открыта Главная, от её пинга расходится рябь (при включённом Уменьшить движение её нет).
  • Полоса под графиком показывает, как отправки периода распределились по зонам, в процентах.

Наведите указатель на пинг, чтобы увидеть его запрос: когда он был отправлен, статус и время, метод и имя. Щёлкните, чтобы открыть запрос с этим ответом. Если открывать нечего (запрос удалён или не был сохранён, либо на отправку не пришло ответа), в подсказке написано Нажмите, чтобы найти в истории, и щелчок открывает Историю с поиском по имени запроса.

Выбор периода

Переключатель в заголовке карточки выбирает 1 ч, 24 ч, 7 дн. (по умолчанию) или 30 дн. График и показатели следуют за ним. Если за период отправок не было, карточка сообщает, что эхо запроса появится здесь, как только вы его отправите.

Показатели

Над графиком — пять показателей, у каждого рядом значение за такой же предыдущий период («+12% к прошлой неделе»):

ПоказательЧто он считает
ОтправкиЗапросы, отправленные за период.
УспешноДоля отправок с ответом со статусом ниже 400 и изменение в процентных пунктах.
МедианаСреднее по порядку время ответа и p95: 95 из 100 отправок были быстрее.
Быстрее 250 мсДоля отправок у поверхности.
Дольше 1 сСколько отправок оказалось на глубине и сколько из них завершились ошибкой.

В узкой карточке видны только первые три.

Что считает Sonar

  • Показатели учитывают все отправки, ещё хранящиеся в истории рабочего пространства. Отправки, которые вы очистили или которые удалили лимиты истории, больше не учитываются. График рисует самые последние из них.
  • Sonar считает запросы HTTP, GraphQL, gRPC и MCP, кто бы их ни отправил: вы, Прогон, сценарий или агент. Сеансы WebSocket, Socket.IO и MQTT остаются открытыми сколько угодно, поэтому у них нет времени ответа, и они не рисуются.

На этой странице