Обзор Dashboard
Панель управления FourA позволяет управлять API ключами и пользователями proxy, выполнять тестовые request запросы, отслеживать производительность, настраивать биллинг и параметры аккаунта. На этой странице описан главный экран Overview и разделы бокового меню.
Доступ к панели управления
Войдите на foura.ai/dashboard. Вам понадобится аккаунт FourA: зарегистрируйтесь здесь, если у вас его еще нет.
Два продукта, единый интерфейс
Страницы Overview, Metrics и Activity содержат переключатель Product с двумя вариантами:
| Продукт | Что учитывается | Единицы |
|---|---|---|
| API | Request запросы, отправленные к /api/single, /api/proxy, /api/browser и /api/auto |
Запросы и кредиты |
| Proxy | Туннели, открытые вашими инструментами через proxy.foura.ai |
Туннели и байты |
Туннель передает любые данные вашего клиента, а внутри CONNECT идет ваш собственный зашифрованный трафик. Поэтому в разделах Proxy отображаются туннели и байты, но не запросы или кредиты. Подробнее о продукте читайте в Proxy Port.
Переключатель всегда активен на одном из двух значений, сохраняется между сессиями и присутствует в URL как #overview/proxy, #metrics/proxy или #activity/proxy. Переход по такой ссылке открывает страницу с выбранным продуктом.
Не путайте продукт Proxy с чипом endpoint Proxy Finder. Proxy Finder это POST /api/proxy/, один из четырех API endpoint. Продукт Proxy это proxy порт.
Страница Overview, продукт API
Начальная страница после входа отображает основные показатели за выбранный период.
До первого запроса
Пока не отправлен первый request, в режиме API отображаются демонстрационные данные с меткой Sample на каждой панели и графике под баннером This is sample data.. Баннер содержит два шага: Create API key (сгенерированный ключ открывается с готовой тестовой командой) и Open Playground для отправки запроса. На телефонах и планшетах интерфейс направляет в Playground, так как на мобильном устройстве нельзя выполнить команду. Первый реальный request навсегда заменит демонстрационные данные.
В разделе Proxy есть собственный баннер No traffic yet. с кнопками Create proxy user и Open Proxy, который отображается до появления трафика у любого пользователя proxy. Закрытие одного из баннеров скрывает оба.
Карточки сводки
В верхней части расположены пять панелей, а также шестая, если за период выполнялись задачи в Auto:
| Панель | Что отображается |
|---|---|
| Concurrency | Запросы, выполняемые одновременно прямо сейчас, а также среднее и максимальное значение за период |
| Requests | Общее число вызовов, далее Single, Proxy, Browser и Auto, каждый со своей долей от общего числа ниже. Вызов Auto учитывается один раз, в строке Auto. |
| Auto attempts | Отображается, только если Auto выполнял задачи в этот период. Запросы Single, Proxy и Browser, которые Auto делал в рамках ваших вызовов Auto, с количеством попыток на каждый вызов Auto. Они не считаются отдельными запросами и не входят в success rate, а их кредиты включены в кредиты Auto. При этом они учитываются в ваших лимитах rate limit и concurrency для Single, Proxy и Browser. |
| Credits | Тарифицированные кредиты в качестве основного значения, потраченные кредиты ниже, для общего объема и для каждого продукта, включая Auto |
| Bytes | Переданные данные: In показывает отправленные данные, Out показывает полученные данные, а Premium показывает часть этого трафика через премиальный выход, независимо от того, была ли доставлена страница. Значение Premium уже входит в оба итога и не прибавляется к ним повторно. |
| Response Time | Среднее, минимальное и максимальное время за период |
Billed и spent представляют разные числа. Тарифицируется только успешный запрос, поэтому billed это то, за что вы платите. Spent учитывает любой результат, так как неудачный запрос все равно задействует proxy или browser. Если перепутать эти значения, один и тот же аккаунт на разных страницах может показаться двумя разными. Смотрите подробности о тарификации результатов в Request Outcomes.
Панели Requests и Credits обозначают четыре endpoint как Single, Proxy, Browser и Auto. В строке фильтра Endpoints над ними Proxy назван как Proxy Finder, что обозначает то же самое: POST /api/proxy/.
Сумма четырех категорий не всегда равна итогу. Небольшая часть вызовов не относится ни к одной из них, поэтому они учитываются только в общем объеме и не попадают ни в один конкретный endpoint.
Графики временной шкалы
Ниже панелей расположены шесть графиков временной шкалы: объем запросов, расход кредитов, распределение результатов, время ответа, пропускная способность и concurrency. В заголовке каждого графика есть переключатель, заменяющий график на исходную таблицу.
Страница Overview, продукт Proxy
Переключите Product на Proxy, и та же страница отобразит данные по туннелям. Четыре панели:
| Панель | Что отображается |
|---|---|
| Tunnels at Once | Туннели, открытые одновременно. Значение Current охватывает последние несколько секунд и обновляется каждые пять секунд; Avg и Max рассчитаны за весь период. Ваш тарифный план ограничивает это значение суммарно для всех ваших пользователей proxy. |
| Tunnels | Success и Failed, каждый со своей долей от общего числа. Failed включает любой другой результат, а строка Outcome детализирует его. |
| Traffic | In показывает отправленные вашими инструментами данные, Out показывает полученные данные, а Premium показывает часть, прошедшую через премиальную сеть. Это значение уже включено в общие итоги, а не прибавляется к ним. |
| Setup Time | Среднее, минимальное и максимальное время ожидания перед передачей туннеля, только для успешных туннелей. Это время ожидания до передачи первого байта, а не скорость сайта за туннелем. |
Под ними расположены пять графиков временной шкалы: Tunnel Timeline, Outcome Timeline, Setup Time Timeline, Traffic Timeline и Tunnels at Once Timeline. В каждом из них доступен тот же переключатель графика и таблицы, что и в графиках API.
Три панели затемняются при выборе фильтра Outcome, поскольку для данного исхода соответствующие числовые значения отсутствуют. Панель Tunnels at Once затемняется при любом выбранном исходе. Панели Setup Time и Traffic затемняются при неудачном исходе и содержат метку Success only, так как неудачный туннель не был передан клиенту и не передавал трафик.
Period и Detail
Параметр Period определяет глубину отображаемого интервала времени. Доступны восемь кнопок и вариант Custom:
| Кнопка | Интервал |
|---|---|
| 30M | Последние 30 минут |
| 3H | Последние 3 часа |
| 12H | Последние 12 часов |
| 24H | Последние 24 часа |
| 7D | Последние 7 дней |
| 30D | Последние 30 дней |
| 90D | Последние 90 дней |
| 1Y | Последние 12 месяцев |
Вариант Custom открывает диалоговое окно с четырьмя пресетами (This month, Last month, Last 6 months и All time), а также полями выбора дат From и To. Диапазон дат длится до конца выбранного дня, но не позже текущего момента.
Параметр Detail определяет ширину каждого столбца: поминутно, каждые 5 минут, каждые 30 минут, каждый час, каждые 6 часов, ежедневно, еженедельно или ежемесячно. По умолчанию установлено значение Auto, которое выбирает максимальный шаг, обеспечивающий отображение не менее 15 столбцов на графике. Это позволяет видеть годовой интервал как общую структуру, а не как 365 тонких линий. Опция Auto отображает название выбранного шага.
Параметры Period и Detail применяются к обоим продуктам.
Шаги Detail, которые выходят за рамки периода хранения детализации в FourA, становятся неактивными, но не скрываются:
| Детализация | Доступная глубина истории |
|---|---|
| Per-request | 7 дней |
| 5-minute | 30 дней |
| Hourly | 12 месяцев |
| Daily | Вся история |
Если выбрать период старше лимита уровня детализации, более мелкие шаги станут неактивными. Режим Auto никогда не выбирает их, поэтому график не бывает пустым из-за агрегации данных.
Фильтры
Фильтры суммируются и комбинируются, а параметры Period и Detail настраиваются рядом с ними.
| Фильтр | Продукт | Описание |
|---|---|---|
| Product | оба | API или Proxy |
| Endpoints | API | Ограничение одним endpoint: Single, Proxy Finder, Browser или Auto. Вызов Auto учитывается один раз в категории Auto; сопутствующие запросы Single, Proxy и Browser отображаются по имени на панели попыток Auto и не считаются отдельными запросами. |
| Outcome | оба | Выделение одной категории. Для API доступны все семь исходов; для продукта Proxy доступны пять исходов, которыми может завершиться туннель. |
| Owner | оба | Everything, Personal или одна из ваших организаций. Отображается только при участии хотя бы в одной организации. |
| Key | API | Ограничение одним API key |
| Proxy user | Proxy | Ограничение одним пользователем proxy |
Панель и график Concurrency на стороне API не поддерживают фильтры Endpoints и Outcome. Они затемняются при включении любого из этих фильтров, о чем сообщается в заголовке графика.
Фильтр Owner
Выпадающий список Owner отвечает на вопрос "чей трафик я сейчас смотрю". Он предлагает варианты Everything, Personal и по одному пункту для каждой организации, в которой вы состоите. Этот же переключатель на страницах Metrics, Activity, API Keys и Proxy сохраняет ваш выбор, поэтому данные на страницах всегда согласованы.
Разделы Usage & Limits и Billing намеренно его не используют. Они отвечают на вопрос "за что мне выставляется счет", то есть учитывают ваши личные ключи и proxy-пользователей, а также ресурсы принадлежащих вам организаций. См. Organizations.
Sidebar Sections
Одиннадцать разделов в четырех группах: Dashboard, Tools, Access и Account.
Dashboard: Overview, Metrics, Activity
Три страницы, отвечающие на вопрос "что произошло". На всех трех есть переключатель Product.
Overview представляет собой описанную выше страницу и всегда служит начальной точкой после входа в систему.
Metrics содержит панель Usage: детализацию с группировкой по API key, IP-адресу клиента или домену для API, а также по proxy-пользователю, целевому ресурсу, стране выхода, IP-адресу клиента или результату для Proxy, с карточками за весь период над таблицей с пагинацией. См. руководство Metrics guide.
Activity представляет собой ленту событий в реальном времени за последний час. Для API каждая строка соответствует одному request: метод, целевой домен, статус, результат, длительность, объем переданных данных и кредиты. Для Proxy каждая строка соответствует одному туннелю: proxy-пользователь, целевой ресурс, точка выхода, результат, установка соединения, длительность, байты и IP-адрес клиента. См. Activity Log.
Tools: Playground, Extension
Тестируйте реальные запросы с вашим действующим API key без написания кода. Выберите Auto, Single, Proxy или Browser, укажите URL, настройте флаги и таймауты, затем нажмите Send. Сохраняйте типовые конфигурации в виде пресетов и перезапускайте любой из последних 20 запусков из History.
Расход списывается с квоты ключа точно так же, как и при вызове из продакшена. См. руководство Playground guide.
В разделе Extension с пометкой Beta можно скачать расширение FourA для Chrome. Его всплывающее окно направляет трафик Chrome через одного из ваших proxy-пользователей, а вкладка FourA в DevTools преобразует любой запрос со страницы в готовый вызов API. См. Chrome Extension.
Access: API Keys, Proxy
В разделе API Keys вы создаете, просматриваете и администрируете ключи, которые ваши приложения используют для вызова API. Ключи имеют префикс pk_live_. См. Managing API Keys.
В разделе Proxy вы создаете proxy-пользователей и копируете строку подключения для любого клиента, поддерживающего proxy URL. Туннели и трафик через порт тарифицируются в рамках вашего плана так же, как и API. См. документацию Proxy Users и справочник по Proxy Port.
Account: Organizations, Usage & Limits, Billing, Settings
Organizations позволяют использовать общие API-ключи и учетные записи proxy-пользователей вместе с коллегами под управлением одного владельца. Добавляйте пользователей по email, назначайте им роли и передавайте права владения организацией при необходимости. Расход по учетным данным организации списывается с тарифного плана ее владельца. См. Organizations.
Usage & Limits отображает ваш тариф, объем использования за текущий расчетный период и все действующие лимиты с детализацией по ключам, endpoint и пользователям proxy. См. Usage & Limits.
Billing управляет вашей подпиской, покупкой дополнительных кредитов или трафика, хранит способы оплаты и счета, а также показывает объем кредитов, трафика и премиум-трафика за период относительно вашего тарифа. См. Billing & Subscriptions.
Settings содержит отображаемое имя, пароль, активные сессии и подключенные провайдеры входа. Смена email недоступна в панели управления: обратитесь в поддержку.
Tips
- Используйте Playground перед написанием кода. Если вы не знаете, какой движок требуется для нового сайта, начните с Auto и позвольте системе выбрать его.
- Сравнивайте оплаченный объем с фактическим расходом на карточке Credits. Endpoint с большой разницей между ними часто завершается ошибкой, а отчет о попытках объясняет причину.
- В продукте Proxy блок Rate Limited в Outcome Timeline указывает на лимит вашего тарифа, а не на отказ целевого ресурса. Представление Outcome на странице Metrics показывает конкретный лимит.
- Обеспечьте безопасность ваших API-ключей и пользователей proxy. Немедленно отключите их при подозрении на компрометацию.
Next Steps
- Authentication: подробности о создании и управлении API-ключами
- Quick Start: отправьте свой первый request через CLI
- How Your Plan Is Metered: кредиты, трафик и действующие лимиты тарифа
- Usage & Limits: отслеживание кредитов и трафика в рамках тарифа
- API Endpoints: прямая работа с API