Преглед на Dashboard
FourA Dashboard е мястото, където управлявате API ключове и proxy потребители, изпълнявате тестови заявки, наблюдавате производителността, управлявате плащанията и конфигурирате профила си. Тази страница описва основния екран Overview и секциите в страничната лента.
Достъп до Dashboard
Влезте в профила си на foura.ai/dashboard. Необходим ви е FourA профил: регистрирайте се тук, ако все още нямате такъв.
Два продукта, един набор от страници
Overview, Metrics и Activity се отварят с превключвател Product с два избора:
| Продукт | Какво отчита | Единица |
|---|---|---|
| API | Заявките, които изпращате към /api/single, /api/proxy, /api/browser и /api/auto |
Заявки и кредити |
| Proxy | Тунелите, които вашите собствени инструменти отварят през proxy.foura.ai |
Тунели и байтове |
Тунелът пренася всичко, което клиентът ви изпраща през него, а случващото се вътре в CONNECT е вашият собствен криптиран трафик. Затова изгледите за Proxy отчитат тунели и байтове, а никога заявки или кредити. Прочетете Proxy Port за самия продукт.
Превключвателят винаги е на една от двете опции, запомня се между посещенията и присъства в адреса като #overview/proxy, #metrics/proxy или #activity/proxy. Поставянето на някоя от тези връзки отваря страницата директно на съответния продукт.
Не бъркайте продукта Proxy с чипа за endpoint Proxy Finder. Proxy Finder е POST /api/proxy/, един от четирите endpoints на API. Продуктът Proxy е самият proxy port.
Страница Overview, продукт API
Началната страница след вход показва основните ви показатели за избрания период.
Преди първата ви заявка
Докато не пристигне първата ви заявка, API изгледът показва примерни данни с етикет Sample върху всеки панел и графика, под банер This is sample data. с две стъпки: Create API key, чийто нов ключ се отваря с тестова команда, и Open Playground за изпращане на заявка. На телефон или таблет стъпките ви насочват към Playground, тъй като телефонът не може да изпълни командата. Първата ви реална заявка заменя примерните данни за постоянно.
Изгледът за 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 извикване. Те никога не се броят като заявки или в процента на успеваемост, а техните кредити са включени в кредитите на Auto. Те се зачитат към вашите лимити за скорост и едновременност за Single, Proxy и Browser. |
| Credits | Фактурирани кредити като стойност, изразходвани кредити отдолу, за общата сума и за всеки продукт, включително Auto |
| Bytes | Прехвърлени данни: In е изпратеното от вас, Out е върнатото, а Premium е частта от този трафик, преминала през премиум изход, независимо дали този изход е доставил страницата. Premium се съдържа в двете общи суми и никога не се добавя към тях. |
| Response Time | Средно, минимум и максимум за периода |
Фактурираните и изразходваните стойности са различни числа. Таксува се само успешна заявка, така че фактурираното е това, за което плащате. Изразходваното включва всеки резултат, тъй като неуспешна заявка все пак консумира proxy или browser. Объркването на двете стойности е причината един и същ акаунт да изглежда като два различни акаунта на две страници. Вижте Request Outcomes за това кои резултати се таксуват.
Панелите Requests и Credits обозначават четирите endpoints като Single, Proxy, Browser и Auto. Редът за филтриране Endpoints над тях нарича Proxy Proxy Finder, което е същото нещо: POST /api/proxy/.
Сборът от четирите не винаги е равен на общия брой. Малък брой извиквания не носят нито едно от тях и те се броят в общата сума, но не и в конкретен endpoint.
Графики на времевата линия
Под панелите шест графики на времевата линия показват обема на заявките, изразходваните кредити, разбивката на резултатите, времето за отговор, честотната лента и едновременността. Всяка графика има превключвател в заглавната си част, който заменя графиката със съответната таблица.
Преглед страница, 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:
| Pill | Window |
|---|---|
| 30M | Last 30 minutes |
| 3H | Last 3 hours |
| 12H | Last 12 hours |
| 24H | Last 24 hours |
| 7D | Last 7 days |
| 30D | Last 30 days |
| 90D | Last 90 days |
| 1Y | Last 12 months |
Custom отваря диалогов прозорец с четири предварително зададени опции, This month, Last month, Last 6 months и All time, плюс двойка дати From и To. Периодът от дати продължава до края на избрания ден, никога след настоящия момент.
Detail определя ширината на всяка лента: за минута, на всеки 5 минути, на всеки 30 минути, на час, на всеки 6 часа, ежедневно, ежеседмично или ежемесечно. По подразбиране е зададено на Auto, което избира най-голямата стъпка, която все пак показва поне петнадесет ленти на диаграмата, така че една година да изглежда като ясна форма вместо като 365 тънки линии. Опцията Auto изписва името на избраната от нея стъпка.
Period и Detail се прилагат за двата продукта.
Стъпките за Detail, които се простират по-назад във времето, отколкото FourA пази съответната детайлност, са сиви, вместо скрити:
| Resolution | How far back it goes |
|---|---|
| Per-request | 7 days |
| 5-minute | 30 days |
| Hourly | 12 months |
| Daily | The whole history |
Ако изберете период, по-стар от допустимото за дадено ниво, по-детайлните опции стават сиви. Auto никога не избира някоя от тях, така че диаграмата никога не остава празна заради агрегиране на данните.
Филтри
Филтрите се наслагват и комбинират, а Period и Detail стоят до тях.
| Filter | Product | What it does |
|---|---|---|
| Product | both | API or Proxy |
| Endpoints | API | Ограничаване до един endpoint: Single, Proxy Finder, Browser или Auto. Извикване на Auto се отчита веднъж, под Auto; заявките Single, Proxy и Browser, които неговата стълбица е направила зад него, се показват по име в панела за опити на Auto, никога като самостоятелни заявки. |
| Outcome | both | Изолиране на една категория. API предлага всички седем; продуктът Proxy предлага петте, с които даден тунел може да завърши. |
| Owner | both | Everything, Personal или някоя от вашите организации. Появява се само когато принадлежите към поне една. |
| Key | API | Ограничаване до един API ключ |
| 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, client IP или домейн за страната на API, и по proxy user, target, изходна държава (exit country), client IP или резултат (outcome) за страната на Proxy, с карти за целия период над таблица с пагинация. Вижте ръководството за Metrics.
Activity е емисия в реално време за последния час. От страната на API всеки ред представлява една заявка: метод, целеви домейн, статус, резултат, продължителност, обем на трансфера и кредити. От страната на Proxy всеки ред е един тунел: proxy user, target, exit, outcome, настройка (setup), продължителност, байтове и client IP. Вижте Activity Log.
Tools: Playground, Extension
Тествайте реални заявки с вашия активен API key, без да пишете код. Изберете Auto, Single, Proxy или Browser, задайте URL, коригирайте флаговете и времевите ограничения (timeouts), и натиснете Send. Запазвайте често използвани конфигурации като шаблони и стартирайте отново всяко от последните си 20 изпълнения от History.
Изразходваните ресурси се отчитат към квотата на ключа точно както при реално извикване в продукционна среда. Вижте ръководството за Playground.
Extension, маркирано като Beta, е мястото, откъдето можете да изтеглите FourA разширението за Chrome. Неговият изскачащ прозорец (popup) насочва трафика на Chrome през един от вашите proxy потребители, а табът FourA в DevTools превръща всяка заявка от страницата в готово API извикване. Вижте Chrome Extension.
Access: API Keys, Proxy
API Keys е мястото, където създавате, преглеждате и управлявате ключовете, които вашите приложения използват за извикване на API. Ключовете използват префикса pk_live_. Вижте Managing API Keys.
Proxy е мястото, където създавате proxy потребители и копирате низ за свързване (connection string) за всеки клиент, който поддържа proxy URL. Тунелите и трафикът през порта се отчитат към вашия план по същия начин както API. Вижте документацията за Proxy Users и Proxy Port.
Account: Organizations, Usage & Limits, Billing, Settings
Organizations споделят API ключове и proxy потребители с колеги под един собственик. Добавяйте хора чрез имейл, задавайте техните роли и прехвърляйте собствеността на организацията при необходимост. Потреблението чрез идентификационни данни на организация се отчита към плана на нейния собственик. Вижте Organizations.
Usage & Limits показва вашия план, използваното през този отчетен период и всеки лимит, спрямо който се измерва потреблението, с разбивка по ключ, по endpoint и по proxy потребител. Вижте Usage & Limits.
Billing управлява вашия абонамент, купува още кредити или трафик, съхранява методи за плащане и фактури и показва кредитите, трафика и премиум трафика за периода спрямо вашия план. Вижте Billing & Subscriptions.
Settings съдържа вашето екранно име, парола, активни сесии и свързани доставчици за вход. Промяната на имейл адрес не е налична в таблото: свържете се с поддръжката.
Съвети
- Използвайте Playground, преди да пишете код. Ако не знаете кой engine е необходим за нов сайт, започнете с Auto и го оставете да избере.
- Сравнявайте фактурираното спрямо изразходваното в картата с кредити. Endpoint, при който двете се различават значително, се проваля често, а отчетът за опитите показва защо.
- При продукта Proxy, блок от статус Rate Limited в Outcome Timeline представлява лимитът на вашия план, а не отказ от целевия сайт. Изгледът Outcome в Metrics посочва кой точно лимит е достигнат.
- Пазете своите API ключове и proxy потребители. Деактивирайте ги незабавно, ако подозирате, че са компрометирани.
Следващи стъпки
- Authentication: Подробности за създаване и управление на API ключове
- Quick Start: Направете първата си заявка през CLI
- How Your Plan Is Metered: Кредити, трафик и кои лимити се прилагат за вас
- Usage & Limits: Проследявайте кредити и трафик спрямо вашия план
- API Endpoints: Използвайте API директно