A Developer Hub Request logs lapja
megjeleníti szervezete /v1 API-forgalmát: az elmúlt 24 óra összesítő
statisztikáit — a kérelmek számát, a hibaarányt és a sebességkorlátozott
kérelmek számát — egy kereshető napló felett, amely az egyes kérelmeket
tartalmazza.
Mit rögzít az egyes bejegyzés
A naplótábla minden híváshoz megjeleníti az időpontot, a HTTP-metódust, az elérési utat, a válasz állapotát, a szabályzati döntést, a késleltetést és a kérelemazonosítót. A bejegyzés megnyitásakor megjelenik a teljes részletes információ, beleértve a hívást végző szolgáltatásfiókot és API-kulcsot, a forrás IP-címet, valamint az érvényben lévő jogosultságokat.
A szabályzati döntés megmutatja, hogyan kezelte a rendszer a kérelmet:
- Allowed — a kérelem hitelesítése és engedélyezése megtörtént.
- Denied — a kérelmet elutasították, például mert a kulcs nem rendelkezett a szükséges jogosultsággal, lejárt, vagy visszavonták.
- Rate limited — a kérelem túllépte a kérelmi keretet, ezért elutasításra került
429 válasszal. Lásd a sebességkorlátokat.
Szűrés és keresés
A naplót szűkítheti szolgáltatásfiók, API-kulcs, HTTP-metódus, állapotosztály (2xx–5xx), szabályzati döntés, időtartomány vagy elérési útvonal-előtag (például /v1/entities) szerint.
Hiba követése kérelemazonosító alapján
Minden API-válasz tartalmaz egy Request-Id fejlécet, és minden hibatörzs ugyanezt az értéket tartalmazza a request_id mezőben. Illessze be ezt az értéket a kérelemnapló keresőjébe, hogy közvetlenül a megfelelő bejegyzéshez ugorjon, és pontosan láthassa, hogyan kezelték a kérelmet.
Ha egy integráció hibát jelez, kérje el a hibaválaszban szereplő request_id értéket. Ez a leggyorsabb út az ügyféloldali tünettől a történtek hiteles rögzítéséig — egyben ezt az értéket érdemes megadni, ha a Living Security ügyfélszolgálatához fordul.
Problémák korai észlelése
- Az error rate (hibaarány) emelkedése általában azt jelenti, hogy egy kulcs lejárt, visszavonták, vagy elvesztett egy szükséges jogosultságot — a hibás hitelesítő adat megtalálásához szűrjön döntés szerint.
- A rate-limited kérelmek számának emelkedése azt jelzi, hogy egy munkaterhelés túl intenzíven működik; a terhelés kiegyenlítését szolgáló stratégiákat a sebességkorlátoknál talál.
- Ha egy olyan szolgáltatásfiók forgalmat generál, amelynek tétlennek kellene lennie, ellenőrizze, hogy a hitelesítő adatai valóban ott vannak-e, ahol gondolja — és a vizsgálat idejére tiltsa le a fiókot.