Метрики
Страница Metrics (боковое меню > Metrics) дает углубленный аналитический обзор использования. На ней расположена одна панель, Usage, которая разбивает трафик на группы и отображает суммарные показатели за весь период над таблицей строк.
Для сводных карточек и графиков во времени используйте страницу Dashboard Overview.
Продукт
Страница открывается с переключателя Product: API для запросов, отправляемых к endpoint API, и Proxy для туннелей, которые ваши собственные инструменты открывают через proxy.foura.ai. У каждого продукта своя панель Usage со своими представлениями, областями видимости и столбцами, так как у туннеля нет подсчета запросов и кредитов. Выбор переключателя запоминается и доступен по прямой ссылке как #metrics/proxy.
Фильтры
Над панелью расположены: Product, Endpoints (только для API), Owner, затем Key (API) или Proxy user (Proxy), затем Period. Элементы Owner и Period аналогичны элементам управления на Overview и разделяют их состояние, поэтому при переключении между двумя страницами выбранные параметры сохраняются.
Фильтр по владельцу
Everything, Personal или одна из ваших организаций. Этот фильтр появляется только в том случае, если вы состоите хотя бы в одной организации. Выбор владельца также перестраивает выпадающие списки Key и Proxy user, поэтому учетные данные предыдущего владельца не останутся выбранными и не вернут пустой результат.
Если у выбранного владельца нет API-ключей вообще, включая остановленные, строка под периодом сообщает: You have no API keys here yet. Create one to see its usage. В этом случае панели показывают нули, так как считать нечего. См. раздел Managing API Keys.
Фильтры по ключу и пользователю Proxy
Ограничивают область страницы одними учетными данными. Отображаются только доступные вам учетные данные: ваши собственные, а также данные организаций, в которых вы состоите.
Период
Восемь переключателей: 30M, 3H, 12H, 24H, 7D, 30D, 90D и 1Y, а также Custom для календарного месяца, последних 6 месяцев, всего времени или точного диапазона дат.
Endpoint
Для продукта API выберите Single, Proxy Finder, Browser или Auto, чтобы ограничить карточки и таблицу одним endpoint. Вызов Auto учитывается один раз в категории Auto. Область Concurrency недоступна, пока выбран конкретный endpoint.
Панель Usage
Панель отвечает сразу на два вопроса. Карточки над таблицей описывают весь период: сколько в нем групп и суммарные значения по всем ним. Таблица ниже представляет собой одну страницу этих групп с сортировкой по выбранному столбцу.
Обе части всегда относятся к одному и тому же трафику: карточки используют то же временное окно и те же фильтры, что и строки. Количество групп указывается полностью без округления, так как точное число дает прямой ответ на вопрос "скольких доменов мы достигли за этот месяц", а округленное нет.
Изменение представления, области или периода сбрасывает пагинацию на первую страницу. Страница 4 для доменов не соответствует странице 4 для IP клиентов.
Нажмите на заголовок столбца для сортировки. В представлениях Domain и Client IP продукта API сортировка применяется ко всему списку перед разбиением на страницы, поэтому верхняя строка действительно содержит наибольшее значение, а таблица открывается заново с первой страницы. Представление API Key отображает все ключи единым списком и сортирует его на месте. Сортировка возвращается к исходному порядку области видимости при смене представления, изменении области или перезагрузке страницы: сначала наибольшее количество запросов, либо в разделе Routes наибольшее количество попыток браузера через Auto. Нажмите заголовок с клавишей Ctrl или Cmd для сброса. Заголовок первого столбца также содержит поле фильтра (Filter API Keys..., Filter IPs... или Filter Domains...), ограничивающее список строк по имени. В представлениях Client IP и Domain поиск выполняется только по текущей странице, поэтому группа с другой страницы не отобразится. Нажатие Esc сбрасывает фильтр.
Использование, продукт API
Три представления:
| Представление | Группировка данных по |
|---|---|
| API Key | Каждый ключ, к которому у вас есть доступ |
| Client IP | Исходные адреса, отправляющие запросы |
| Domain | Целевые домены в ваших запросах |
Фильтры области действия (Scope) меняют столбцы и карточки:
| Область | Что отображается |
|---|---|
| Bandwidth | Число запросов, входящие байты, исходящие байты и премиум-доля этих байтов (трафик через премиум-выход, включенный в общий объем, а не добавленный сверх него) |
| Response Time | Число запросов, минимальная, средняя и максимальная задержка |
| Concurrency | Число запросов и количество параллельных запросов (только в представлении API Key) |
| Outcomes | Число запросов и разбивка по исходам с круговой диаграммой |
| Budget | Число запросов, тарифицированные кредиты и израсходованные кредиты. Чтобы посмотреть один endpoint, выберите его в строке Endpoints |
| Routes | Число запросов, ваши запросы по маршрутам, операции Auto внутри вызовов и шаг, ответивший на каждый вызов Auto (см. ниже) |
Область Budget разделяет тарифицированные и израсходованные кредиты. Тарифицированные кредиты учитывают только запросы с исходом success: именно они оплачиваются по тарифу. Израсходованные кредиты отражают объем, возвращаемый API в каждом запросе (см. Response Headers), включая неудачные запросы, и плата за них не взимается.
Карточки Budget отображают значение Billed credits с подписью of N spent под ним, а также Per request (среднее число тарифицированных кредитов на запрос). В таблице есть столбцы Billed credits и Spent credits, сортировка доступна по любому из них.
Область Routes
Routes разбивает запросы каждого ключа, Client IP или домена по маршрутам и показывает действия Auto для этих вызовов. Столбцы разделены на три группы, каждая с подписью над ней:
| Группа | Колонки | Что они считают |
|---|---|---|
| Запросы по маршрутам | Single, Proxy Finder, Browser, Auto | Ваши запросы по маршрутам, на которые вы их отправили. Вместе они формируют Запросы. Вызов Auto учитывается один раз в Auto. Под каждым числом указана его доля в Запросах. |
| Попытки Auto | Single, Proxy Finder, Browser | Запросы, которые Auto выполнял на каждом движке за своими вызовами, включая неудачные. Под каждым числом указано количество попыток на вызов Auto. |
| Кем отвечен Auto | Saved session, Plain request, Proxy Finder, Browser, Failed | Шаг, который доставил каждый вызов Auto. Вместе они формируют Auto. Под каждым числом указана его доля в Auto. |
Saved session это сессия, которая уже была у Auto для данного хоста. Browser включает вызовы, где браузер сначала открыл страницу, а повтор его сессии доставил результат. Failed включает вызовы, отклоненные до запуска Auto.
Чтобы увидеть, где Auto использует реальный браузер, смотрите колонку Browser в Попытки Auto. Браузер обычно открывает страницу один раз, после чего Auto повторно использует эту сессию с более легкими запросами, поэтому эта колонка обычно намного больше, чем Browser в Кем отвечен Auto. Раздел Маршруты открывается с сортировкой по ней, поэтому домены, которым браузер нужен больше всего, идут первыми; группы без попыток браузера следуют далее по количеству запросов.
Карточки над таблицей показывают попытки Auto за период с количеством попыток на вызов Auto, а также каждый браузер, открытый напрямую или через Auto.
Попытки Auto никогда не учитываются в Запросах или в показателе успешности. Они учитываются в лимитах частоты и параллелизма Single, Proxy Finder и Browser вашего тарифа, как на карточке попыток Auto в Обзоре. При выборе эндпоинта в строке Эндпоинты раздел Маршруты показывает только этот маршрут: тогда Browser перечисляет запросы браузера, отправленные вами лично, а запросы, выполненные Auto, остаются в Auto.
Диаграмма результатов
В области видимости Результаты круговая диаграмма находится внутри панели и показывает разбивку успехов и ошибок за выбранный период. Наведите курсор на любой сектор, чтобы увидеть точное количество запросов и процентное соотношение. Она отображается только в этой области видимости, поскольку картина за весь период поверх таблицы, отвечающей на другой вопрос, воспринимается как несвязанные данные.
Использование, Прокси-продукт
Пять представлений:
| Представление | Группирует данные по |
|---|---|
| Пользователь прокси | Каждому пользователю прокси, к которому у вас есть доступ |
| Цель | Хосту, к которому подключился каждый туннель |
| Страна выхода | Стране, из которой вышел туннель |
| IP клиента | Адресу, с которого пришло соединение |
| Результат | Результату и его причине |
Четыре области видимости:
| Область видимости | Колонки |
|---|---|
| Трафик | Туннели, Входящие байты, Исходящие байты, Premium |
| Установка | Туннели, Мин. установка, Средн. установка, Макс. установка, Средн. длительность, Макс. длительность |
| Результаты | Туннели плюс одна колонка на результат, с диаграммой результатов |
| Бюджет | Туннели, Standard, Premium, Итого |
Установка это время ожидания перед передачей туннеля. Длительность показывает, сколько времени он затем оставался открытым. Premium это часть трафика, которая прошла через премиум-сеть; она включена в общий объем и никогда не прибавляется к нему повторно.
Ни в одной области видимости нет столбца кредитов или счетчика запросов. Внутри CONNECT передается ваш собственный зашифрованный трафик, поэтому порт считает туннели и байты, и ничего больше.
Типы результатов
Каждый API request классифицируется ровно по одному результату. Тарифицируется только success.
| Результат | Уровень | Значение |
|---|---|---|
success |
н/д | Запрос вернул корректный ответ. Без правил validate это означает HTTP 200. С правилами validate это любой ответ, принятый вашими правилами, независимо от статуса. Страница проверки или отказа, распознанная FourA, никогда не считается успешной. |
application_error |
target | Целевой ресурс вернул HTTP 200, но тело ответа содержало поле ошибки либо представляло собой страницу проверки или отказа, распознанную FourA. |
application_fail |
target | Целевой ресурс вернул статус, отличный от 2xx, который не был принят вашими правилами validate, либо не вернул ответ вовсе. |
client_error |
caller | Запрос был отклонен до отправки из FourA: некорректные параметры, неверное значение proxy или URL, разрешающийся в частный или зарезервированный адрес. |
rate_limit |
FourA | Запрос был отклонен из-за превышения вашего лимита RPM или лимита параллелизма. См. Rate Limits. |
service_error |
FourA | Движок ответил ошибкой сервера или телом, которое не удалось разобрать. |
service_fail |
FourA | Сетевой сбой: таймаут, отказ в соединении, ошибка DNS, отключение клиента. |
Столбец уровня указывает на источник проблемы. target означает вызываемый сайт, caller означает ошибку в вашем запросе, FourA означает, что мы не смогли его обработать.
Если вы используете validate.status.accept для разрешения определенных кодов, отличных от 200 (например, [200, 403]), они возвращаются как success вместо application_fail. Классификация основывается на оценке ваших правил движком, а не на исходном коде HTTP.
Туннель через порт proxy классифицируется по той же схеме, за исключением двух результатов target: ответ туннеля представляет собой ваш собственный зашифрованный трафик, поэтому FourA не видит, был ли успешен ответ сайта за ним. Полную классификацию и схему ее привязки к биллингу см. в разделе Request Outcomes.
Связанные разделы
- Dashboard Overview: карточки сводки, графики временной шкалы, параметры Period и Detail (Detail доступен только в Overview)
- Request Outcomes: подробное описание значений outcome для запросов и туннелей
- Response Headers: откуда берутся списания кредитов
- Proxy Port: продукт, по которому формируются отчеты во вкладках Proxy
- Organizations: что охватывает фильтр Owner
- API Errors: в каком виде ошибки возвращаются по сети