Метрики
Страница Metrics (боковое меню > Metrics) предоставляет более глубокий аналитический обзор использования вашего API. Она показывает общее распределение outcome и разбивает трафик по API key, IP-адресу клиента или целевому домену.
Для просмотра сводных карточек и графиков временной шкалы в реальном времени (Concurrency, Requests, Bytes, Response Time) используйте страницу Dashboard Overview.
Фильтры
Над страницей расположены два элемента управления: селектор API key и селектор интервала.
Фильтр по ключам
Используйте выпадающий список API Key, чтобы ограничить область видимости страницы конкретным ключом. Отображаются только те ключи, которые входят в вашу область доступа: личные ключи, ключи организации, которые вы администрируете, или ключи, предоставленные через команды.
Селектор интервала
Используйте кнопки интервалов для управления временным окном:
| Кнопка | Окно |
|---|---|
| 1M | Последняя 1 минута |
| 5M | Последние 5 минут |
| 30M | Последние 30 минут |
| 1H | Последний 1 час |
| 6H | Последние 6 часов |
| 1D | Последние 24 часа |
И круговая диаграмма, и таблица обновляются в соответствии с вашим выбором.
Распределение outcome
Круговая диаграмма вверху показывает соотношение успешных запросов и ошибок за выбранный интервал. Наведите курсор на любой сектор, чтобы увидеть точное количество request и процентное соотношение. Используйте ее, чтобы быстро определить, связано ли внезапное падение уровня успешных запросов (success rate) с определенной категорией outcome.
Типы outcome
Каждый API request классифицируется ровно по одному outcome. Только success учитывается в вашей тарифицируемой квоте.
| Outcome | Layer | Meaning |
|---|---|---|
success |
n/a | Request доставил валидный response. Без правил validate это означает HTTP 200. Если вы отправили правила validate, любой response, принятый вашими правилами, считается успешным, независимо от HTTP-статуса. |
application_error |
target | Целевой ресурс вернул HTTP 200, но тело response содержало поле ошибки. |
application_fail |
target | Целевой ресурс вернул статус, отличный от 2xx, который не был принят вашими правилами validate, либо не вернул response вообще. |
client_error |
caller | Ваш request был отклонен до того, как он покинул FourA: неверные параметры, некорректное значение proxy или URL, который разрешается в приватный/зарезервированный IP (защита SSRF). |
rate_limit |
FourA | Request был отклонен из-за превышения вашего лимита RPM или лимита конкурентных запросов (concurrency limit). См. Rate Limits. |
service_error |
FourA | Бэкенд вернул 5xx или ответил телом, которое мы не смогли проанализировать. |
service_fail |
FourA | Сетевой сбой: таймаут, отказ в соединении, ошибка DNS, отключение клиента. |
Колонка layer указывает на то, кто несет ответственность: target означает вызванный вами сайт, caller означает, что ваш request был некорректным, FourA означает, что мы не смогли его обработать.
Если вы используете validate.status.accept для разрешения определенных кодов, отличных от 200 (например, [200, 403]), эти responses возвращаются как success вместо application_fail. Классификация основывается на вердикте движка по вашим правилам, а не на исходном HTTP-коде.
Полную таксономию и схему ее сопоставления с тарификацией см. в разделе Request Outcomes.
Таблица использования с несколькими режимами просмотра
Под круговой диаграммой расположена таблица использования, которая разбивает ваш трафик по трем вкладкам просмотра:
| Вкладка | Группирует данные по |
|---|---|
| API Key | Каждому из ваших API keys |
| Client IP | Исходным IP-адресам, отправляющим requests |
| Domain | Целевым доменам в ваших requests |
Каждая вкладка поддерживает четыре фильтра области видимости (scope chips) справа, которые меняют отображаемые колонки:
| Область | Что отображает |
|---|---|
| Bandwidth | Количество requests, входящие байты, исходящие байты |
| Response Time | Количество requests, минимальную, среднюю и максимальную задержку (latency) |
| Concurrency | Количество requests плюс количество конкурентных requests (только в режиме просмотра API Key) |
| Outcomes | Количество requests плюс разбивка по каждому outcome |
Связанные разделы
- Dashboard Overview: Статистика в реальном времени и графики временной шкалы
- Request Outcomes: Подробное описание семи значений outcome
- API Errors: Как ошибки возвращаются по сети