Die Registerkarte Anfrageprotokolle im
Developer Hub zeigt den
/v1-API-Datenverkehr Ihrer Organisation: zusammenfassende Statistiken für die letzten 24 Stunden – Anzahl der Anfragen, Fehlerrate und ratenbegrenzte Anfragen – oberhalb eines durchsuchbaren Protokolls der einzelnen Anfragen.
Was jeder Eintrag erfasst
Die Protokolltabelle zeigt für jeden Aufruf die Uhrzeit, die HTTP-Methode, den Pfad, den Antwortstatus, die Richtlinienentscheidung, die Latenz und die Anfrage-ID. Wenn Sie einen Eintrag öffnen, werden alle Details angezeigt, darunter das Dienstkonto und der API-Schlüssel, mit denen der Aufruf erfolgte, die Quell-IP-Adresse und die zu diesem Zeitpunkt gültigen Berechtigungen.
Die Richtlinienentscheidung gibt an, wie die Anfrage behandelt wurde:
- Allowed – Die Anfrage wurde authentifiziert und autorisiert.
- Denied – Die Anfrage wurde abgelehnt, zum Beispiel weil dem Schlüssel die erforderliche Berechtigung fehlte, er abgelaufen war oder widerrufen wurde.
- Rate limited – Die Anfrage hat ein Anfragekontingent überschritten und wurde mit
429 abgelehnt. Weitere Informationen finden Sie unter Ratenbegrenzungen.
Filtern und Suchen
Grenzen Sie das Protokoll nach Dienstkonto, API-Schlüssel, HTTP-Methode, Statusklasse (2xx–5xx), Richtlinienentscheidung, Zeitraum oder Pfadpräfix ein (zum Beispiel /v1/entities).
Einen Fehler anhand der Anfrage-ID nachverfolgen
Jede API-Antwort enthält einen Header Request-Id, und jeder Fehlertext enthält denselben Wert im Feld request_id. Fügen Sie diesen Wert in die Suche der Anfrageprotokolle ein, um direkt zum passenden Eintrag zu springen und genau nachzuvollziehen, wie die Anfrage behandelt wurde.
Wenn eine Integration einen Fehler meldet, fragen Sie nach dem Wert request_id aus der Fehlerantwort. Er ist der schnellste Weg von einem kundenseitigen Symptom zum maßgeblichen Protokolleintrag dazu, was tatsächlich passiert ist – und der Wert, den Sie angeben sollten, wenn Sie den Support von Living Security kontaktieren.
Probleme frühzeitig erkennen
- Eine steigende Fehlerrate bedeutet in der Regel, dass ein Schlüssel abgelaufen ist, widerrufen wurde oder eine erforderliche Berechtigung verloren hat. Filtern Sie nach Entscheidung, um die fehlschlagenden Anmeldedaten zu finden.
- Eine steigende Anzahl ratenbegrenzter Anfragen bedeutet, dass eine Workload zu stark ausgelastet ist. Strategien zur Glättung finden Sie unter Ratenbegrenzungen.
- Datenverkehr von einem Dienstkonto, das inaktiv sein sollte, ist ein Hinweis darauf, zu prüfen, ob sich seine Anmeldedaten dort befinden, wo Sie es annehmen – und das Konto während Ihrer Untersuchung zu deaktivieren.