Einen Protokolleintrag lesen
Auf dieser Seite
Klicken Sie in der Liste auf der Registerkarte Logs auf eine Anfrage, um ihre Details rechts zu öffnen. Die Details zeigen, wann die Anfrage gestellt wurde, von wem und von wo, was gesendet wurde und was zurückkam. Bei einer fehlgeschlagenen Anfrage können Sie außerdem eine verständliche Zusammenfassung des Fehlers anfordern.
Kurzübersicht
Wo Sie es finden: Settings (Zahnradsymbol, unten links) → Audit-Protokolle → Logs, dann auf eine Anfrage klicken
Wer es verwenden kann: Sie benötigen eine Rolle, die Audit-Protokolle und Identity & Access Management in Ihrer Organisation umfasst, zum Beispiel Organisation Administrator. Siehe Wer Audit-Protokolle verwenden kann.
Zweck: Genau sehen, was bei einer Anfrage passiert ist
Einen Protokolleintrag öffnen
- Filtern Sie die Liste auf der Registerkarte Logs auf die Anfragen, die Sie benötigen.
- Klicken Sie auf eine Anfrage. Ihre Details öffnen sich rechts, und die Anfrage wird in der Liste hervorgehoben.
- Mit den Pfeiltasten nach oben und nach unten bewegen Sie sich durch die Liste, ohne die Details zu verlassen.
Oben in den Details werden Status, Methode, Quellen-Badge und Endpunkt wiederholt.
Abbildung 1: Ein Protokolleintrag: wann er erstellt wurde, von wem, von wo, sowie die Anfrage- und Antwortinhalte
Die Felder
Die Felder werden im Performance Hub in Großbuchstaben und in dieser Reihenfolge angezeigt:
| Feld | Was es zeigt |
|---|---|
| Timestamp | Datum und Uhrzeit der Anfrage |
| Response Time | Wie lange der Performance Hub für die Antwort gebraucht hat, in Millisekunden |
| Request ID | Eine eindeutige ID für diese Anfrage. Klicken Sie auf die Schaltfläche zum Kopieren, um sie zu kopieren, zum Beispiel um sie an den Support weiterzugeben. |
| IP Address | Die IP-Adresse, von der die Anfrage kam |
| User | Die E-Mail-Adresse der Person, die die Anfrage gestellt hat |
| Referer | Die Seite, von der aus die Anfrage gestellt wurde, sofern vorhanden |
| User Agent | Der Browser, die App oder das Tool, das die Anfrage gesendet hat |
| Einrichtung | Die Einrichtung, für die die Anfrage bestimmt war, als "Name (id)", zum Beispiel Lower Manhattan und ihre Einrichtungs-ID |
| Organisation | Die Organisation, als "Name (id)" |
Anfrage und Antwort
Unter den Feldern stehen die Inhalte der Anfrage, sofern vorhanden:
| Abschnitt | Was er zeigt |
|---|---|
| Request POST Body | Was gesendet wurde, zum Beispiel der angegebene Grund für eine Türentsperrung oder die neuen Öffnungszeiten einer Einrichtung. Die Überschrift lautet bei jeder Methode, die Inhalte sendet, "Request POST Body". |
| Response Body | Was der Performance Hub zurückgesendet hat, einschließlich etwaiger Fehlermeldungen |
| Query Parameters | Zur Anfrage hinzugefügte Optionen, etwa eine Seitenzahl oder eine Einrichtung |
Klicken Sie auf Copy section (das Kopiersymbol oben rechts in einem Abschnitt), um dessen Inhalt zu kopieren, zum Beispiel um ihn in eine Supportanfrage einzufügen.
Wenn eine Anfrage nichts zu zeigen hat, steht in den Details "No request/response payloads recorded for this entry." Viele GET-Anfragen, die nur Informationen lesen, haben keinen Anfrageinhalt.
KI-Fehlerzusammenfassung
Bei einer fehlgeschlagenen Anfrage mit einem Status von 400 oder höher enthalten die Details einen Abschnitt AI Error Summary.
- Klicken Sie auf Generate summary.
- Lesen Sie die Zusammenfassung. Sie erklärt in verständlicher Sprache, was schiefgelaufen ist und was als Nächstes zu tun ist.
Abbildung 2: Bei einer fehlgeschlagenen Anfrage erklärt Generate summary den Fehler in verständlicher Sprache
- Die Zusammenfassung wird erst erstellt, wenn Sie auf Generate summary klicken. Nachdem eine Zusammenfassung erstellt wurde, kann sie mit dem Tag cached angezeigt werden.
- Sie wird von KI erstellt und kann falsch sein. Gleichen Sie sie mit dem Response Body ab, der die Meldung enthält, die der Performance Hub tatsächlich zurückgegeben hat.
- Wenn die Zusammenfassung nicht erstellt werden kann, werden Sie in einer Warnung gebeten, es später erneut zu versuchen. Lesen Sie in der Zwischenzeit den Response Body.
Nach 7 Tagen: Vorschauen
Vollständige Anfrage- und Antwortinhalte werden 7 Tage lang aufbewahrt. Danach werden längere Inhalte auf eine kurze Vorschau gekürzt, und in den Details steht "Full request and response payloads are kept for 7 days. Showing a preview for this log." Kurze Inhalte, die in die Vorschau passen, bleiben vollständig erhalten.
Der Rest des Protokolleintrags, etwa wer die Anfrage gestellt hat, wann und mit welchem Ergebnis, wird 90 Tage lang aufbewahrt.
Abbildung 3: Nach 7 Tagen bleibt nur eine kurze Vorschau der Anfrage und Antwort erhalten
Wenn Sie die vollständigen Inhalte später eventuell benötigen, öffnen Sie die Anfrage innerhalb von 7 Tagen und verwenden Sie Copy section. Ein CSV-Export enthält die Inhalte nicht.
Statuscodes
Der Status steht in jeder Zeile an erster Stelle. Seine erste Ziffer gibt die Art des Ergebnisses an:
| Status | Bedeutung | Beispiele |
|---|---|---|
| 2xx | Erfolg | 200 OK, 201 Created |
| 3xx | Weiterleitung: Die Anfrage wurde an eine andere Stelle gesendet | 301 Moved |
| 4xx | Ein Problem mit der Anfrage, zum Beispiel fehlende Berechtigung oder ungültige Eingabe | 400 Bad Request (ein Wert war ungültig), 401 Unauthorised (nicht angemeldet), 403 Forbidden (keine Berechtigung), 404 Not Found, 409 Conflict (die Anfrage stand im Widerspruch zum aktuellen Zustand, etwa bei einer Tür im Wartungsmodus), 429 Too Many Requests (zu viele Anfragen in kurzer Zeit) |
| 5xx | Ein Serverfehler | 500 Server Error, 502 Bad Gateway, 503 Service Unavailable |
Quellen-Badges
Jede Anfrage hat ein Quellen-Badge, das angibt, woher sie kam:
| Badge | Woher die Anfrage kam |
|---|---|
web | Eine Person, die den Performance Hub in einem Browser oder in der App verwendet |
api-key | Eine Integration, die einen API-Schlüssel verwendet, etwa ein Buchungs- oder Mitgliedersystem. Siehe Authentifizierung der Partner API. |
mcp | Ein KI-Agent oder KI-Client, der über MCP verbunden ist. Siehe Mit KI verwenden. |
model-router | Der Model Router |
websocket | Eine Live-Verbindung, etwa für eine Echtzeitaktualisierung |
guest-token | Ein Gastlink |
Es können auch andere Badges erscheinen.
Verwandte Seiten
- Anfragen finden: die Liste filtern
- Protokolle exportieren: die geladenen Protokolle herunterladen
- Untersuchungsbeispiele: die Details praktisch nutzen
- Audit-Protokolle: häufige Fragen