На вкладке Журналы запросов в
Developer Hub отображается трафик API вашей организации /v1: сводная статистика за последние 24 часа — количество запросов, доля ошибок и количество запросов, ограниченных по частоте, — а под ней доступный для поиска журнал отдельных запросов.
Что записывается в каждой записи
В таблице журнала для каждого вызова указываются время, HTTP-метод, путь, статус ответа, решение политики, задержка и идентификатор запроса. При открытии записи отображаются все подробности, включая служебную учётную запись и ключ API, с помощью которых был выполнен вызов, IP-адрес источника и действовавшие разрешения.
Решение политики показывает, как был обработан запрос:
- Allowed — запрос прошёл аутентификацию и авторизацию.
- Denied — запрос был отклонён, например, потому что у ключа не было необходимого разрешения, истёк срок его действия или он был отозван.
- Rate limited — запрос превысил лимит запросов и был отклонён с ответом
429. См. ограничения частоты запросов.
Фильтрация и поиск
Сузить выборку в журнале можно по служебной учётной записи, ключу API, HTTP-методу, классу статуса (2xx–5xx), решению политики, временному диапазону или префиксу пути (например, /v1/entities).
Отслеживание ошибки по идентификатору запроса
Каждый ответ API содержит заголовок Request-Id, а тело каждой ошибки содержит то же значение в поле request_id. Вставьте это значение в поиск по журналу запросов, чтобы сразу перейти к соответствующей записи и увидеть, как именно был обработан запрос.
Если интеграция сообщает об ошибке, запросите request_id из ответа с ошибкой. Это самый быстрый путь от проявления проблемы на стороне клиента к достоверной записи о том, что произошло, а также значение, которое необходимо указать при обращении в службу поддержки Living Security.
Раннее выявление проблем
- Рост доли ошибок обычно означает, что срок действия ключа истёк, ключ был отозван или у него пропало необходимое разрешение. Отфильтруйте записи по решению политики, чтобы найти учётные данные, вызывающие сбои.
- Рост количества запросов Rate limited означает, что рабочая нагрузка создаёт слишком высокую интенсивность запросов. Способы сглаживания нагрузки описаны в разделе ограничения частоты запросов.
- Трафик от служебной учётной записи, которая должна простаивать, — повод проверить, находятся ли её учётные данные там, где вы полагаете, и отключить учётную запись на время расследования.