Метрики
Страница Metrics (боковая панель > Metrics) предоставляет более глубокий аналитический обзор использования вашего API. Она показывает общее распределение результатов и разбивает трафик по ключу API, IP-адресу клиента или целевому домену.
Для получения сводных карточек и графиков во времени в реальном времени (Concurrency, Requests, Bytes, Response Time, Budget) используйте страницу Dashboard Overview.
Фильтры
В верхней части страницы расположены два элемента управления: выбор ключа API и выбор интервала.
Фильтр ключей
Используйте выпадающий список API Key, чтобы ограничить страницу конкретным ключом. Отображаются только ключи в пределах вашей области доступа: личные ключи, ключи организации, которыми вы управляете, или ключи, доступные через команды.
Выбор интервала
Используйте кнопки интервалов для управления временным окном:
| Кнопка | Окно |
|---|---|
| 1M | Последняя 1 минута |
| 5M | Последние 5 минут |
| 30M | Последние 30 минут |
| 1H | Последний 1 час |
| 6H | Последние 6 часов |
| 1D | Последние 24 часа |
И круговая диаграмма, и таблица следуют за вашим выбором.
Распределение результатов
Круговая диаграмма в верхней части показывает распределение успехов и ошибок для выбранного интервала. Наведите курсор на любой сектор, чтобы увидеть точное количество запросов и процент. Используйте это, чтобы быстро определить, совпадает ли внезапное падение процента успешных запросов с определенной категорией результатов.
Типы результатов
Каждый запрос к API классифицируется ровно в один результат. Только success учитывается в вашей оплачиваемой квоте.
| Результат | Уровень | Значение |
|---|---|---|
success |
н/д | Запрос доставил действительный ответ. Без правил validate это означает HTTP 200. Если вы отправили правила validate, любой ответ, принятый вашими правилами, считается успешным, независимо от статуса HTTP. |
application_error |
target | Цель вернула HTTP 200, но тело ответа содержало поле ошибки. |
application_fail |
target | Цель вернула статус, отличный от 2xx, который ваши правила validate не приняли, или вообще не вернула ответ. |
client_error |
caller | Ваш запрос был отклонен до того, как он покинул FourA: неверные параметры, некорректное значение прокси или URL, который разрешается в частный/зарезервированный IP (защита от SSRF). |
rate_limit |
FourA | Запрос был отклонен вашим RPM или лимитом параллелизма. См. Rate Limits. |
service_error |
FourA | Бэкенд вернул 5xx или ответил телом, которое мы не смогли разобрать. |
service_fail |
FourA | Сетевой сбой: тайм-аут, отказ в соединении, ошибка DNS, отключение клиента. |
Столбец уровня сообщает, кто несет ответственность: target означает сайт, который вы вызвали, caller означает, что ваш запрос был плохим, FourA означает, что мы не смогли его обработать.
Если вы используете validate.status.accept, чтобы разрешить определенные коды, отличные от 200 (например, [200, 403]), эти ответы возвращаются как success вместо application_fail. Классификация следует вердикту движка по вашим правилам, а не исходному HTTP-коду.
Полную таксономию и то, как она соотносится с выставлением счетов, см. в Request Outcomes.
Таблица использования с несколькими представлениями
Под круговой диаграммой таблица использования разбивает ваш трафик на три вкладки:
| Вкладка | Группировка данных |
|---|---|
| API Key | Каждый из ваших ключей API |
| Client IP | Исходные IP-адреса, отправляющие запросы |
| Domain | Целевые домены в ваших запросах |
Каждая вкладка поддерживает переключатели справа, которые изменяют отображаемые столбцы:
| Область | Что отображается |
|---|---|
| Bandwidth | Количество запросов, байт получено, байт отправлено |
| Response Time | Количество запросов, мин., сред. и макс. задержка |
| Concurrency | Количество запросов плюс количество параллельных запросов (только вид API Key) |
| Outcomes | Количество запросов плюс разбивка по результатам |
| Budget | Количество запросов и потраченные кредиты с разбивкой по продуктам (Single, Proxy, Browser) |
Область Budget считывает метрику credits, записываемую API при каждом запросе (см. Response Headers). Суммы представляют собой общие расходы, биллинг учитывает только результат success в вашем тарифе.
Нажмите на заголовок столбца для сортировки. Состояние сортировки сохраняется для каждой таблицы при перезагрузке страницы. Удерживайте Ctrl или Cmd при клике на заголовок для сброса.
Связанные материалы
- Обзор дашборда: статистика в реальном времени и графики
- Результаты запросов: подробное объяснение семи возможных результатов
- Response Headers: откуда берутся кредиты
- Ошибки API: как ошибки возвращаются по сети