Skip to main content
На вкладці 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 означає, що певне навантаження працює надто інтенсивно; стратегії його вирівнювання описано в розділі ліміти частоти запитів.
  • Трафік від службового облікового запису, який має бути неактивним, — це сигнал перевірити, чи облікові дані зберігаються там, де ви вважаєте, і вимкнути обліковий запис на час розслідування.