Op het tabblad Request logs van de
Developer Hub ziet u het
/v1-API-verkeer van uw organisatie: samenvattende statistieken over de afgelopen 24 uur —
aantal requests, foutpercentage en requests waarvoor een limiet is afgedwongen — boven een doorzoekbaar
logboek van afzonderlijke requests.
Wat elke vermelding vastlegt
De logtabel toont van elke aanroep het tijdstip, de HTTP-methode, het pad, de responsstatus, de beleidsbeslissing, de latentie en de request-ID. Als u een vermelding opent, ziet u alle details, waaronder het serviceaccount en de API-sleutel waarmee de aanroep is gedaan, het bron-IP-adres en de rechten die van kracht waren.
De beleidsbeslissing geeft aan hoe het request is afgehandeld:
- Allowed — het request is geauthenticeerd en geautoriseerd.
- Denied — het request is geweigerd, bijvoorbeeld omdat de sleutel het vereiste recht niet had, was verlopen of was ingetrokken.
- Rate limited — het request overschreed een requestbudget en is geweigerd
met een
429. Zie rate limits.
Filteren en zoeken
Beperk het logboek op serviceaccount, API-sleutel, HTTP-methode, statusklasse
(2xx–5xx), beleidsbeslissing, tijdsbereik of padvoorvoegsel (bijvoorbeeld
/v1/entities).
Een fout traceren via de request-ID
Elke API-respons bevat een Request-Id-header en elke foutmelding bevat
dezelfde waarde in het veld request_id. Plak die waarde in de zoekfunctie van het
requestlogboek om direct naar de bijbehorende vermelding te gaan en precies te zien
hoe het request is afgehandeld.
Vraagt u bij een foutmelding van een integratie om de request_id uit de
foutrespons. Dit is de snelste weg van een symptoom aan de klantzijde naar de
gezaghebbende registratie van wat er is gebeurd — en de waarde die u moet vermelden
als u contact opneemt met de support van Living Security.
Problemen vroeg signaleren
- Een stijgend foutpercentage betekent meestal dat een sleutel is verlopen, is ingetrokken of een
benodigd recht heeft verloren — filter op beslissing om de falende referentie te vinden.
- Een stijgend aantal rate-limited requests betekent dat een workload te intensief draait; zie
rate limits voor strategieën om het verkeer te spreiden.
- Verkeer van een serviceaccount dat inactief hoort te zijn, is een signaal om te controleren
of de referenties zich wel bevinden waar u denkt dat ze zijn — en om
het account uit te schakelen terwijl
u onderzoek doet.
