Метрики
Страница Metrics (боковое меню > Metrics) предоставляет детальную аналитику использования. Она содержит одну панель, Usage, которая группирует трафик и отображает итоговые значения за весь период над таблицей со строками.
Сводные карточки и графики динамики доступны на странице Dashboard Overview.
Product
Страница открывается с переключателем Product: API для запросов к endpoints API и Proxy для туннелей, открываемых вашими инструментами через proxy.foura.ai. У каждого продукта своя панель Usage с отдельными представлениями, областями видимости и столбцами, так как у туннелей нет подсчета запросов и кредитов. Выбор переключателя сохраняется и поддерживает прямые ссылки через #metrics/proxy.
Filters
Над панелью расположены фильтры: Product, Endpoints (только для API), Owner, затем Key (для API) или Proxy user (для Proxy), и далее Period. Фильтры Owner и Period совпадают с элементами на странице Overview и синхронизируют свое состояние, поэтому переключение между страницами не сбрасывает контекст.
Owner Filter
Everything, Personal или одна из ваших организаций. Отображается только при наличии хотя бы одной организации. Выбор владельца также обновляет списки Key и Proxy user, исключая сохранение недействительных учетных данных предыдущего владельца.
Key and Proxy User Filters
Ограничивают данные страницы одной учетной записью. Отображаются только доступные вам учетные данные: личные и данные ваших организаций.
Period
Восемь кнопок выбора: 30M, 3H, 12H, 24H, 7D, 30D, 90D и 1Y, а также Custom для выбора календарного месяца, последних 6 месяцев, всего времени или произвольного диапазона дат.
Endpoints
Для продукта API выберите Single, Proxy Finder, Browser или Auto, чтобы ограничить карточки и таблицу одним endpoint. Вызов Auto учитывается один раз в категории Auto. Режим Concurrency недоступен при выбранном endpoint.
The Usage Panel
Панель решает две задачи одновременно. Карточки над таблицей показывают сводку за весь период: количество групп и общие итоги по ним. Таблица снизу отображает одну страницу этих групп с сортировкой по выбранному столбцу.
Обе части относятся к одному и тому же трафику: карточки используют то же окно времени и фильтры, что и строки. Количество групп отображается точным числом без округления, чтобы дать четкий ответ на вопрос о точном числе доменов за месяц.
Изменение представления, области видимости или периода сбрасывает пагинацию на первую страницу. Страница 4 для доменов не соответствует странице 4 для IP клиентов.
Нажмите на заголовок столбца для сортировки. При смене представления или обновлении страницы сортировка сбрасывается к значениям по убыванию. Нажмите на заголовок с зажатой клавишей Ctrl или Cmd для сброса.
Usage, API Product
Три представления:
| View | Groups data by |
|---|---|
| API Key | Каждый доступный вам ключ |
| Client IP | Адреса источников запросов |
| Domain | Целевые домены в ваших запросах |
Переключатели области видимости справа меняют состав столбцов и карточек:
| Scope | Что отображает |
|---|---|
| Bandwidth | Количество request, входящие байты, исходящие байты и доля premium трафика (трафик через premium exit, включенный в общий объем, а не добавленный к нему) |
| Response Time | Количество request, минимальная, средняя и максимальная задержка |
| Concurrency | Количество request и число параллельных request (только в представлении API Key) |
| Outcomes | Количество request с детализацией по результатам и круговой диаграммой outcome donut |
| Budget | Количество request и израсходованные credits по всем результатам. Чтобы просмотреть конкретный endpoint, выберите его в строке Endpoints |
Scope Budget считывает метрику credits, которую API возвращает в каждом request (см. Response Headers). Эти суммы отражают исходный учтенный расход. Биллинг списывает с тарифа только результат success, а карточка Overview Credits показывает оба значения рядом.
Outcome Donut
В scope Outcomes на панели отображается круговая диаграмма с распределением успешных запросов и ошибок за выбранный период. Наведите курсор на сегмент, чтобы увидеть точное количество request и процент. Диаграмма строится только в этом scope, так как общий график над таблицей с другими данными выглядит несогласованно.
Использование: продукт Proxy
Пять представлений:
| View | Группировка данных |
|---|---|
| Proxy user | Каждый proxy user, к которому у вас есть доступ |
| Target | Хост назначения каждого туннеля |
| Exit country | Страна выхода туннеля |
| Client IP | Адрес источника подключения |
| Outcome | Результат и его причина |
Четыре scope:
| Scope | Колонки |
|---|---|
| Traffic | Tunnels, Bytes In, Bytes Out, Premium |
| Setup | Tunnels, Setup Min, Setup Avg, Setup Max, Duration Avg, Duration Max |
| Outcomes | Tunnels и по одной колонке на каждый результат, вместе с диаграммой outcome donut |
| Budget | Tunnels, Standard, Premium, Total |
Setup показывает время ожидания перед передачей туннеля. Duration показывает, как долго он оставался открытым. Premium это часть трафика, прошедшая через сеть premium; она входит в общий объем и не прибавляется поверх.
Ни в одном scope нет колонок credits или количества request. Внутри CONNECT передается ваш собственный зашифрованный трафик, поэтому порт учитывает только туннели и байты.
Типы результатов (Outcome Types)
Каждый API request относится ровно к одной категории outcome. Тарифицируется только success.
| Результат | Уровень | Значение |
|---|---|---|
success |
н/д | Запрос вернул валидный ответ. Без правил validate это означает HTTP 200. С правилами validate это любой ответ, принятый вашими правилами, независимо от статуса. |
application_error |
target | Целевой ресурс вернул HTTP 200, но тело ответа содержало поле ошибки. |
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: как ошибки передаются по сети