На вкладці Request logs у
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.
Своєчасне виявлення проблем
- Зростання error rate зазвичай означає, що термін дії ключа закінчився, його було відкликано
або він втратив потрібний дозвіл — відфільтруйте журнал за рішенням, щоб знайти облікові дані, які спричиняють збої.
- Зростання кількості запитів rate-limited означає, що певне навантаження працює надто інтенсивно; стратегії
його вирівнювання описано в розділі ліміти частоти запитів.
- Трафік від службового облікового запису, який має бути неактивним, — це сигнал перевірити,
чи облікові дані зберігаються там, де ви вважаєте, і
вимкнути обліковий запис на час
розслідування.