Activity Log
Activity Log показва най-новите ви API requests в реално време. Използвайте го, за да дебъгвате отделни requests, да проверявате response кодовете и да се уверите, че интеграцията ви работи.
Какво ще видите
Дневникът показва requests, направени през последния час, като най-новите са най-отгоре. Всеки запис включва:
| Поле | Описание |
|---|---|
| Timestamp | Кога е направен request-ът |
| Method | HTTP метод, изпратен към целта (GET, POST и др.) |
| Route | Кой FourA endpoint е използван (single, proxy или browser) |
| Domain | Целевият домейн, извлечен от URL на request-а |
| Status | HTTP статус код, върнат от целта |
| App Status | Статус на ниво приложение, върнат в response тялото |
| Outcome | Класификация на request-а (success, client_error, rate_limit и др.) |
| Duration | Общо време за response в милисекунди |
| Bytes In | Размер на полезния товар (payload) на request-а |
| Bytes Out | Размер на полезния товар (payload) на response |
| Key Name | Кой API ключ е използван |
| Client IP | IP адресът, направил request-а |
Филтриране
Три контрола филтрират дневника.
По API ключ
Използвайте падащото меню за API ключ, за да покажете requests от един ключ. В падащото меню се показват само ключове в рамките на вашия обхват на достъп.
По продукт
Филтрирайте до един endpoint с инструмента за избор single / proxy / browser. Полезно е, когато искате да дебъгвате грешки, специфични само за browser, отделно от единични requests.
По лимит
По подразбиране Activity Log показва 50 записа. Използвайте селектора за лимит, за да промените броя на показваните записи:
| Лимит | Бележки |
|---|---|
| 10 | Бързо преглеждане |
| 50 | По подразбиране |
| 100 | Разширен изглед |
| 200 | Максимум |
Всички записи са от последния час. За хронологични данни използвайте секцията Metrics, която агрегира данни за дни и седмици.
Отваряне на Request
Кликнете върху произволен ред, за да отворите диалогов прозорец с детайли и преглед на пълния полезен товар (payload) на request и response. Диалоговият прозорец показва:
- Meta grid: timestamp, key, HTTP статус, app статус, outcome, времетраене и
X-Foura-Request-Idна request-а. - Request: форматиран (pretty-printed) JSON на точното изпратено тяло (body), с бутон Copy.
- Response: мета лента плюс преглед на тялото (body), с баджове за съкратен (truncated) и двоичен (binary) формат, където е приложимо.
Полезните товари (payloads) се пазят в продължение на 24 часа, ограничени до последните 200 на API ключ. Редовете, по-стари от това, показват само самия ред, без диалогов прозорец с детайли.
Съобщения в панела за тяло (Body Pane)
Панелът за тяло (body pane) използва различен заместващ текст (placeholder) в зависимост от това какво се е случило:
| Съобщение | Какво означава |
|---|---|
(no body — the request failed: <error>) |
Възникна грешка в request-а, преди целта да върне тяло (body) |
(no body captured) |
Срокът на полезния товар (payload) е изтекъл или не е бил съхранен |
(empty body — the server returned 0 bytes) |
Целта върна действително празен response |
Отваряне в Playground
Диалоговият прозорец с детайли има бутон Open in Playground. Кликнете върху него, за да заредите както архивирания request, така и архивирания response във формата на Playground. Оттам можете да коригирате параметрите и да ги изпратите повторно (replay) към активното API, или просто да прегледате какво се е върнало, без да изпълнявате request-а отново.
Бутонът е деактивиран за полезни товари (payloads), които не могат да бъдат изпратени повторно (неразрешени за replay, като например твърде големи заготовки за request и маршрути, които не са за API), с подсказка, обясняваща причината.
Използване на Request ID
Всеки API response съдържа X-Foura-Request-Id header. Запишете го в лог от ваша страна и можете да го поставите в тикет за поддръжка, за да посочите точния request в Activity Log. Идентификаторът (ID) е същият като използвания в този диалогов прозорец и съвпада с X-Foura-Request-Id, върнат от API. Вижте документацията за API Endpoints за подробности.
Свързани теми
- Metrics and Analytics: Агрегирани данни за производителността за по-дълги периоди
- Playground: Повторно изпълнение (replay) на requests от Activity
- API Endpoints: Структура на request и response, включително header-а за ID на request-а
- Troubleshooting: Често срещани проблеми и решения