Activity Log
Activity Log показва най-новия ви трафик в реално време. Използвайте го за дебъгване на отделни заявки, проверка на статус кодове на отговорите и потвърждаване, че новата интеграция работи.
Product
Страницата се отваря с превключвател Product: API за заявките, които изпращате към API endpoints, Proxy за тунелите, които вашите собствени инструменти отварят през proxy.foura.ai. И двата потока обхващат последния час и използват един и същ селектор за лимит. Изборът се запомня и поддържа директни връзки като #activity/proxy.
Останалата част от тази страница описва първо API потока, а след това Proxy потока.
Какво ще видите в API потока
Дневникът показва заявки, направени през последния час, с най-новите най-отгоре. Девет колони описват целия ред:
| Колона | Какво показва |
|---|---|
| Time | Кога е направена заявката |
| Key | Кой API ключ е използван |
| Request | Самото извикване: цветна маркировка на endpoint (Single, Proxy, Browser или Auto), HTTP методът и целевият домейн. Сортира се по домейн. |
| Status | Две стойности в една клетка, разделени с наклонена черта: HTTP статусът на вашето извикване към FourA, след това статусът, върнат от целта. Тире означава, че целта не е отговорила. |
| Outcome | Класификация на заявката (Success, Client Error, Rate Limited и т.н.) |
| Duration | Общо време за отговор в милисекунди |
| Bytes | Двупосочен трансфер в една клетка: стрелка надолу за request payload, стрелка нагоре за отговора. Ред, който е използвал премиум трафик, съдържа маркировка premium в тази клетка, включително когато е направен опит за премиум изход, но е отговорил стандартният пул; този трафик се отчита към вашия премиум трафик. |
| Credits | Кредити, изразходвани за извикването (вижте Response Headers) |
| Client IP | Адресът, направил заявката. Заявките, изпратени от Playground или хоствания MCP на FourA, показват FourA вместо адрес. |
Кликнете върху заглавието на която и да е колона, за да сортирате таблицата по нея; посоката се редува: низходящ, възходящ ред, след което се изключва. Клик с Ctrl или Cmd връща настройката по подразбиране (най-новите първо).
Филтриране
Четири контроли прецизират дневника.
По собственик
Ако членувате в поне една организация, първо се появява падащото меню Owner: Everything, Personal или една от вашите организации. Промяната му презарежда съседното падащо меню за ключове, така че ключ, принадлежащ на предишния собственик, не може да остане активен след превключването и тихомълком да не върне нищо. Същата контрола в Overview, Metrics и API Keys следва вашия избор. Вижте Organizations.
По API ключ
Използвайте падащото меню за API ключ, за да покажете заявки от конкретен ключ. Появяват се само ключове, до които имате достъп: вашите лични ключове и ключовете на организациите, в които членувате.
По endpoint
Когато Product е зададен на API, филтрирайте до един endpoint с бутоните Single / Proxy Finder / Browser / Auto. Полезно е, когато искате да дебъгвате грешки само от браузъра отделно от единичните заявки. Auto извежда вашите Auto извиквания, по един ред за всяко.
По лимит
Дневникът на активността показва по подразбиране 50 записа. Използвайте селектора за лимит, за да промените броя на показваните записи:
| Лимит | Бележки |
|---|---|
| 10 | Бърз преглед |
| 50 | По подразбиране |
| 100 | Разширен изглед |
| 200 | Максимум |
Всички записи са от последния час. За исторически данни използвайте секцията Metrics, която обобщава данни за дни и седмици.
Auto повиквания
Ред от тип Auto представлява едно повикване. Вторият му ред показва колко опита е направил Auto и колко са успешни, а неговите Credits и Bytes са общите стойности от тези опити. В продължение на няколко секунди след приключване на повикването се показва attempts settling…, след което редът се попълва сам. Повикване, отказано преди Auto да опита каквото и да е, показва no attempts recorded.
Отворете реда, за да видите таблица Attempts: Engine, Rung, Status, Outcome, Time, Bytes, Credits. Опитите се отчитат към лимитите за Single, Proxy Finder и Browser, но никога към броя на вашите request или процента на успеваемост.
Отваряне на Request
Кликнете върху произволен ред, за да отворите панел с подробности с предварителен преглед на пълния request и response payload. Панелът се отваря с мета мрежа, изградена от самия ред, така че остава полезен дори след като съхраненият payload е изтекъл: времево клеймо, ключ, HTTP статус, статус на приложението, резултат, времетраене, кредити, proxy и X-FourA-Request-Id на заявката.
Под мрежата се показва по един панел, избран чрез таб:
| Таб | Какво показва |
|---|---|
| Request | Форматиран JSON на точно изпратеното тяло |
| Response headers | Заглавните части, върнати от целевия сървър, по един блок за всеки пренасочващ скок. При пренасочване табът показва броя на скоковете. |
| Response body | Предварителен преглед на съхраненото тяло, с обозначения за съкратено съдържание и двоични данни, където е приложимо |
| Other fields | Всичко останало, върнато от енджина извън статус, времеви параметри, proxy и хедъри. Скрито, когато няма допълнителни данни. |
Бутон Copy копира съдържанието на отворения в момента панел. Payloads се пазят 24 часа, с лимит до последните 200 за API ключ. Редовете, по-стари от този период, показват само метаданните на реда, без payload.
Съобщения в панела Body
Панелът за тяло използва различен заместващ текст в зависимост от случилото се:
| Съобщение | Значение |
|---|---|
(no body — the request failed: <error>) |
Заявката е върнала грешка, преди целевият сървър да върне тяло |
(no body captured for this request) |
Payload е изтекъл или не е бил съхранен |
(empty body — the server returned 0 bytes) |
Целевият сървър е върнал реално празен отговор |
Open in Playground
Диалоговият прозорец с подробности съдържа бутон Open in Playground. Кликнете върху него, за да заредите както архивирания request, така и архивирания response във формата на Playground. Оттам можете да коригирате параметри и да изпълните заявката отново към реалния API или просто да инспектирате върнатия резултат, без да стартирате request наново.
Бутонът е деактивиран за Auto повиквания и за payloads, които не могат да се изпълнят повторно (твърде големи request stubs и маршрути извън API), като е налично подсказващо съобщение с причината.
Потокът за Proxy
Превключете Product на Proxy и списъкът ще показва по един ред на тунел, също от последния час. Тунелът е единична връзка, отворена от вашия инструмент; изпратеното вътре е вашият собствен криптиран трафик, така че редът описва накъде е насочена връзката, как е излязла, колко време е отнело отварянето и какъв обем е пренесен.
| Колона | Какво показва |
|---|---|
| Time | Кога е приключил тунелът, с относително време до него |
| Proxy user | Кой proxy потребител го е пренесъл |
| Target | Хостът и портът, към които е насочен тунелът |
| Exit | Shared или Premium, плюс държавата на изхода, когато е известна |
| Outcome | Success, Client Error, Service Error, Service Fail или Rate Limited, с причината при отказ |
| Setup | Времето от свързването на вашия инструмент до предаването на тунела |
| Duration | Колко време е останал отворен тунелът |
| Bytes | Двете посоки в една клетка, с обозначение premium, когато изходът е бил в premium мрежата |
| Client IP | Адресът, от който е дошла връзката |
Няма колони за Status, Credits или payload, както и диалогов прозорец с детайли. Един CONNECT няма статус от целевия хост и няма body, което FourA да запази.
Падащото меню Owner и селекторът за лимит работят по същия начин. На мястото на падащото меню за ключ, менюто Proxy user ограничава списъка до едни идентификационни данни. Всяка колона може да се сортира.
Ред със статус Rate Limited отразява лимита на вашия план, а не отказ от целевия хост. Причината посочва точно кой лимит: едновременни тунели, отваряния в минута, изчерпан трафик, недостъпен premium или порт, който не е включен във вашия план. Вижте Proxy Port.
Използване на Request ID
Всеки API response съдържа X-Foura-Request-Id header. Запишете го в логовете от ваша страна и можете да го поставите в тикет за поддръжка, за да посочите точната заявка в Activity Log. Идентификаторът е същият като използвания в този диалогов прозорец и съвпада с X-Foura-Request-Id, върнат от API. Вижте Response Headers за подробности.
Свързани
- Metrics and Analytics: Обобщени данни за производителността за по-дълги периоди, и за двата продукта
- Proxy Port: Продуктът, за който Proxy списъкът докладва
- Playground: Повторно изпълнение на заявки от Activity
- Response Headers: Откъде идват request ID и кредитите
- API Endpoints: Структури на заявките и отговорите
- Organizations: Какво покрива филтърът Owner
- Troubleshooting: Често срещани проблеми и решения