Журнал активности
Журнал активности показывает ваши последние запросы к API в реальном времени. Используйте его для отладки отдельных запросов, проверки кодов ответа и подтверждения того, что ваша интеграция работает.
Что вы увидите
В журнале отображаются запросы, сделанные за последний час, причем самые последние находятся наверху. Девять столбцов занимают всю строку:
| Столбец | Что показывает |
|---|---|
| Time | Когда был сделан запрос |
| Key | Какой ключ API использовался |
| Request | Сам вызов: цветная точка продукта (single, proxy или browser), метод HTTP и целевой домен. Сортируется по домену. |
| Status | Два значения в одной ячейке, разделенные косой чертой: статус HTTP вашего вызова к FourA, затем статус, возвращенный целью. Дефис означает, что цель не ответила. |
| Outcome | Классификация запроса (Success, Client Error, Rate Limited и т. д.) |
| Duration | Общее время ответа в миллисекундах |
| Bytes | Передача в обе стороны в одной ячейке: стрелка вниз для полезной нагрузки запроса, стрелка вверх для ответа |
| Credits | Кредиты, потраченные на вызов (см. Response Headers) |
| Client IP | Адрес, с которого был сделан запрос |
Нажмите на любой заголовок столбца, чтобы отсортировать таблицу по этому столбцу; направление циклически меняется по убыванию, по возрастанию, затем отключается. Щелчок с нажатой клавишей Ctrl или Cmd восстанавливает значение по умолчанию (сначала новые).
Фильтрация
Три элемента управления сужают журнал.
По ключу API
Используйте раскрывающийся список ключей API, чтобы отобразить запросы от одного ключа. В раскрывающемся списке отображаются только ключи из вашей области доступа.
По продукту
Фильтрация по одному endpoint с помощью селектора single / proxy / browser. Полезно, когда вы хотите отдельно отлаживать сбои, возникающие только в браузере, от single-запросов.
По лимиту
По умолчанию в журнале активности 50 записей. Используйте селектор лимита, чтобы изменить количество отображаемых записей:
| Лимит | Примечания |
|---|---|
| 10 | Quick scan |
| 50 | Default |
| 100 | Extended view |
| 200 | Maximum |
Все записи за последний час. Для исторических данных используйте раздел Metrics, в котором данные агрегируются по дням и неделям.
Открытие запроса
Щелкните любую строку, чтобы открыть панель подробностей с полным предварительным просмотром полезной нагрузки request и response. Панель открывается на мета-сетке, построенной из самой строки, поэтому она остается полезной даже после устаревания сохраненной полезной нагрузки: timestamp, key, HTTP-статус, статус приложения, результат, duration, кредиты, proxy и X-FourA-Request-Id запроса.
Под сеткой одновременно отображается одна панель, выбираемая вкладкой:
| Вкладка | Что показывает |
|---|---|
| Request | Красиво оформленный JSON именно отправленного тела |
| Response headers | Заголовки, возвращенные целью, со счетчиком на вкладке |
| Response body | Сохраненный предварительный просмотр тела с бейджами truncated и binary там, где они применяются |
| Other fields | Все остальное, что вернул движок, помимо статуса, таймингов, proxy и headers. Скрыто, когда нет ничего лишнего. |
Кнопка Copy копирует любую открытую панель. Полезные нагрузки хранятся 24 часа, максимум 200 последних для каждого API ключа. Строки старше этого времени отображают только саму строку, без полезной нагрузки.
Сообщения панели Body
Панель body использует различный текст-заполнитель в зависимости от того, что произошло:
| Сообщение | Что это значит |
|---|---|
(no body — the request failed: <error>) |
Запрос завершился с ошибкой до того, как цель вернула body |
(no body captured for this request) |
Полезная нагрузка устарела или не была сохранена |
(empty body — the server returned 0 bytes) |
Цель вернула реальный пустой response |
Открыть в Playground
В диалоговом окне деталей есть кнопка Open in Playground. Нажмите ее, чтобы загрузить архивный request и архивный response в форму Playground. Оттуда вы можете настроить параметры и повторить запрос к боевому API, или просто изучить то, что вернулось, без повторного запуска запроса.
Кнопка отключена для полезных нагрузок, которые нельзя повторить (слишком большие заглушки запросов и не-API маршруты), с подсказкой, объясняющей причину.
Использование Request ID
Каждый API response содержит header X-Foura-Request-Id. Запишите его на своей стороне, и вы сможете вставить его в тикет поддержки, чтобы указать на точный request в Activity Log. ID совпадает с тем, который используется в этом диалоговом окне, и соответствует X-Foura-Request-Id, который возвращает API. Смотрите Response Headers для подробностей.
Связанные материалы
- Метрики и аналитика: Агрегированные данные о производительности за длительные периоды
- Playground: Повтор запросов из Activity
- Response Headers: Откуда берутся request ID и кредиты
- API Endpoints: Форматы request и response
- Устранение неполадок: Частые проблемы и их решения