Журнал активности
Журнал активности (Activity Log) показывает ваши последние API-запросы в реальном времени. Используйте его для отладки отдельных запросов, проверки кодов ответов и подтверждения корректности интеграции.
Что вы увидите
В журнале отображаются запросы, сделанные за последний час, при этом самые свежие находятся вверху. Каждая запись содержит:
| Поле | Описание |
|---|---|
| Временная метка | Время выполнения запроса |
| Метод | HTTP-метод, отправленный целевому серверу (GET, POST и т. д.) |
| Маршрут | Какой endpoint FourA был использован (single, proxy или browser) |
| Домен | Целевой домен, извлеченный из URL запроса |
| Статус | HTTP-код статуса, возвращенный целевым сервером |
| Статус приложения | Статус уровня приложения, возвращенный в теле ответа |
| Результат | Классификация запроса (success, client_error, rate_limit и т. д.) |
| Длительность | Общее время ответа в миллисекундах |
| Входящие байты | Размер полезной нагрузки запроса |
| Исходящие байты | Размер полезной нагрузки ответа |
| Имя ключа | Какой API-ключ был использован |
| IP клиента | IP-адрес, с которого был сделан запрос |
Фильтрация
Три элемента управления позволяют сузить список в журнале.
По API-ключу
Используйте выпадающий список API-ключей, чтобы показать запросы для конкретного ключа. В списке отображаются только те ключи, которые входят в вашу область доступа.
По продукту
Отфильтруйте запросы по одному endpoint с помощью селектора single / proxy / browser. Это полезно, когда нужно отладить сбои, возникающие только в браузере, отдельно от простых запросов.
По лимиту
По умолчанию в журнале активности отображается 50 записей. Используйте селектор лимита, чтобы изменить количество отображаемых записей:
| Лимит | Примечания |
|---|---|
| 10 | Быстрый просмотр |
| 50 | По умолчанию |
| 100 | Расширенный вид |
| 200 | Максимум |
Все записи относятся к последнему часу. Для просмотра исторических данных используйте раздел Метрики, который агрегирует данные за дни и недели.
Открытие запроса
Нажмите на любую строку, чтобы открыть диалоговое окно с подробными сведениями и предварительным просмотром полной полезной нагрузки запроса и ответа. В диалоговом окне отображаются:
- Мета-сетка: временная метка, ключ, HTTP-статус, статус приложения, результат, длительность и
X-Foura-Request-Idзапроса. - Запрос: отформатированный JSON точного отправленного тела с кнопкой копирования.
- Ответ: мета-панель и предварительный просмотр тела с ярлыками усечения (truncated) или бинарных данных (binary), если они применимы.
Полезная нагрузка хранится в течение 24 часов и ограничена последними 200 запросами на один API-ключ. Для более старых строк отображается только сама строка без диалогового окна с подробностями.
Сообщения в панели тела запроса
В панели тела запроса используются различные сообщения-заглушки в зависимости от произошедшего:
| Сообщение | Что оно означает |
|---|---|
(no body — the request failed: <error>) |
Произошла ошибка запроса до того, как целевой сервер вернул тело |
(no body captured) |
Срок хранения полезной нагрузки истек или она не была сохранена |
(empty body — the server returned 0 bytes) |
Целевой сервер вернул действительно пустой ответ |
Открыть в Playground
Диалоговое окно с подробностями содержит кнопку Открыть в Playground. Нажмите ее, чтобы загрузить архивный запрос и архивный ответ в форму Playground. Оттуда вы можете настроить параметры и повторить запрос к живому API или просто изучить возвращенные данные без повторного выполнения запроса.
Кнопка отключена для неповторяемых полезных нагрузок (слишком большие заготовки запросов и маршруты, не относящиеся к API), с подсказкой, объясняющей причину.
Использование Request ID
Каждый ответ API содержит заголовок X-Foura-Request-Id. Логируйте его на своей стороне, и вы сможете вставить его в тикет поддержки, чтобы указать на конкретный запрос в Activity Log. Этот идентификатор совпадает с тем, который используется в данном диалоговом окне, и соответствует X-Foura-Request-Id, возвращаемому API. Подробности см. в справочнике API Endpoints.
Связанные разделы
- Метрики и аналитика: Агрегированные данные о производительности за более длительные периоды
- Playground: Повторный запуск запросов из журнала активности
- API Endpoints: Структура запросов и ответов, включая заголовок идентификатора запроса
- Устранение неполадок: Распространенные проблемы и решения