Performance Hub-LogoPerformance Hub
Websitebereich: Dokumentation

Anfragen finden

Auf dieser Seite

Die Registerkarte Logs listet die in Ihrer Organisation gestellten Anfragen auf, die neuesten zuerst. Mit den Filtern oben grenzen Sie die Liste auf eine Person, eine IP-Adresse, einen Teil des Performance Hub oder eine Art von Ergebnis ein. Klicken Sie dann auf eine Anfrage, um ihre Details zu sehen.

Kurzübersicht

Wo Sie es finden: Settings (Zahnradsymbol, unten links) → Audit-Protokolle → Logs

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: Die Anfragen hinter einer Frage finden, etwa wer etwas geändert hat oder warum etwas fehlgeschlagen ist

Die Registerkarte Logs mit der Filterleiste oben, einer Liste von Anfragen links und den Details der ausgewählten Anfrage rechtsDie Registerkarte Logs mit der Filterleiste oben, einer Liste von Anfragen links und den Details der ausgewählten Anfrage rechts

Abbildung 1: Die Registerkarte Logs: Filter oben, passende Anfragen links und die ausgewählte Anfrage rechts

Die Registerkarte Logs

  • Filterleiste: die Filter oben, mit Live, Aktualisieren und CSV exportieren rechts.
  • Liste: die passenden Anfragen, die neuesten zuerst. Darüber steht "Viewing logs for 1 organisation" (oder die Anzahl der Organisationen, die Sie sehen können). Jede Zeile zeigt den Statuscode, die Methode, das Quellen-Badge, Datum und Uhrzeit, den Endpunkt, die E-Mail-Adresse des Benutzers und die Antwortzeit in Millisekunden.
  • Details: die Anfrage, die Sie ausgewählt haben. Siehe Einen Protokolleintrag lesen.

Beim Scrollen lädt die Liste weitere Anfragen. Am Ende der Liste wird angezeigt, wie viele Anfragen gefunden wurden, zum Beispiel "End of results · 5 logs".

Die Liste filtern

  1. Klicken Sie in der Filterleiste auf einen Filter, zum Beispiel Endpoint.
  2. Wählen Sie eine Option aus oder geben Sie einen Wert ein. Geben Sie zum Beispiel /api/door-gate-access/* in Endpoint ein und klicken Sie auf Apply.
  3. Der Filter zeigt den gewählten Wert an, und die Liste wird aktualisiert. Fügen Sie weitere Filter hinzu, um sie weiter einzugrenzen: Eine Anfrage muss allen Filtern entsprechen, damit sie angezeigt wird.
  4. Um einen Filter zu entfernen, klicken Sie auf das × daran. Um alle zu entfernen, klicken Sie auf Clear. Diese Schaltfläche erscheint, sobald ein Filter gesetzt ist.

Die Filterleiste: Range, Email, IP, Endpoint, Org, Einrichtung, Method und Status, dann Live, Aktualisieren und Export CSVDie Filterleiste: Range, Email, IP, Endpoint, Org, Einrichtung, Method und Status, dann Live, Aktualisieren und Export CSV

Abbildung 2: Die Filterleiste: Range, Email, IP, Endpoint, Org, Einrichtung, Method und Status, dann Live, Aktualisieren und Export CSV

FilterWas er erfasst
RangeDen Zeitpunkt, zu dem die Anfrage gestellt wurde. Standard ist Last 24 hours. Siehe Range.
EmailDie vollständige E-Mail-Adresse des Benutzers, zum Beispiel priya.shah@example.com. Während der Eingabe werden eventuell Adressen vorgeschlagen.
IPDie vollständige IP-Adresse, von der die Anfrage kam, zum Beispiel 203.0.113.140
EndpointDer Teil des Performance Hub, für den die Anfrage bestimmt war. Jeder Teil des Pfads führt zu einem Treffer, und Sie können einen *-Platzhalter verwenden. Siehe Endpunkt und Platzhalter.
OrgEine Organisation oder Any org. Wird angezeigt, wenn Sie Zugriff auf mindestens eine Organisation haben.
EinrichtungEine Einrichtung oder Beliebige Einrichtung. Wird angezeigt, wenn Sie Zugriff auf mindestens eine Einrichtung haben.
MethodGET, POST, PUT, PATCH oder DELETE
StatusDer Antwortstatus. Siehe Status.

Email und IP benötigen den vollständigen Wert

Email und IP finden nur exakte Übereinstimmungen. Geben Sie die vollständige E-Mail-Adresse ein, etwa ruby.castellano@example.com, oder die vollständige IP-Adresse. Ein Teil einer Adresse, etwa ruby oder 203.0.113, liefert keine Ergebnisse.

Um eine Person ohne ihre vollständige Adresse zu finden, verwenden Sie Top Users im Dashboard oder öffnen Sie eine ihrer Anfragen und kopieren Sie die Adresse aus dem Feld User.

Bereich

Klicken Sie auf Range, um festzulegen, wie weit Sie zurückblicken möchten.

  • Voreinstellungen: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days und Last 90 days.
  • Daten: Wählen Sie im zweimonatigen Kalender ein Start- und ein Enddatum aus und klicken Sie dann auf Apply. Klicken Sie auf Cancel, um das Menü zu schließen, ohne den Zeitraum zu ändern. Daten, die mehr als 90 Tage zurückliegen, können nicht ausgewählt werden.

Der Hinweis unten im Menü gibt an, wie lange Protokolle aufbewahrt werden: "Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)."

Das geöffnete Menü Range mit Voreinstellungen von Last 15 minutes bis Last 90 days, einem zweimonatigen Kalender und dem Hinweis zur Aufbewahrungsdauer der ProtokolleDas geöffnete Menü Range mit Voreinstellungen von Last 15 minutes bis Last 90 days, einem zweimonatigen Kalender und dem Hinweis zur Aufbewahrungsdauer der Protokolle

Abbildung 3: Range: Wählen Sie eine Voreinstellung oder Daten im Kalender. Der Hinweis zeigt, wie lange Protokolle aufbewahrt werden

Endpunkt und Platzhalter

Der Endpunkt ist der Pfad, an den die Anfrage gesendet wurde, etwa /api/door-gate-access/doors/front-entrance/unlock. Er zeigt Ihnen, für welchen Teil des Performance Hub die Anfrage bestimmt war.

  • Ohne * führt jeder Teil des Pfads zu einem Treffer. Zum Beispiel findet unlock jede Anfrage, deren Pfad "unlock" enthält.
  • Mit * muss jedes Stück zwischen den Sternchen im Pfad vorkommen. Zum Beispiel findet /api/door-gate-access/* jede Door & Gate Access-Anfrage und /partner/v1/* jede Anfrage einer Integration, die die Partner API verwendet.

Der geöffnete Filter Endpoint mit der Eingabe /api/door-gate-access/* und den Schaltflächen Cancel und ApplyDer geöffnete Filter Endpoint mit der Eingabe /api/door-gate-access/* und den Schaltflächen Cancel und Apply

Abbildung 4: Endpoint akzeptiert einen *-Platzhalter, zum Beispiel für jede Türanfrage

Die Registerkarte Logs, gefiltert nach /api/door-gate-access/*, mit fünf Türanfragen, von denen die erste geöffnet istDie Registerkarte Logs, gefiltert nach /api/door-gate-access/*, mit fünf Türanfragen, von denen die erste geöffnet ist

Abbildung 5: Die Liste nach dem Filtern nach einem Endpunktmuster

Sie wissen nicht, welchen Endpunkt Sie verwenden sollen? Öffnen Sie eine Anfrage, die Sie kennen, etwa eine Tür, die Sie selbst entsperrt haben, und kopieren Sie den Anfang ihres Endpunkts aus den Details.

Status

Klicken Sie auf Status, um nach dem Antwortstatus zu filtern. Geben Sie etwas in Search… ein, um einen Status schnell zu finden, zum Beispiel "403". Wählen Sie Any, um alle Status anzuzeigen.

Status werden mit ihren Namen aufgeführt, etwa 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error und 503 Service Unavailable. Was sie bedeuten, erfahren Sie unter Statuscodes.

Das geöffnete Menü Status mit einem Suchfeld, Any und Status von 200 OK bis 401 UnauthorisedDas geöffnete Menü Status mit einem Suchfeld, Any und Status von 200 OK bis 401 Unauthorised

Abbildung 6: Nach Antwortstatus filtern

Live und Aktualisieren

Auf der Registerkarte Logs ist Live standardmäßig Off, sodass die Liste unverändert bleibt, während Sie untersuchen. Schalten Sie die Funktion ein und wählen Sie, wie oft die Liste aktualisiert wird, um neue Anfragen eintreffen zu sehen. Klicken Sie auf die Schaltfläche zum Aktualisieren (die kreisförmigen Pfeile), um die Liste einmal neu zu laden.

Eine gefilterte Ansicht teilen oder als Lesezeichen speichern

Ihre Filter werden in der Seitenadresse gespeichert. Speichern Sie die Seite als Lesezeichen, um zur selben Ansicht zurückzukehren, oder senden Sie die Adresse an eine Kollegin oder einen Kollegen. Diese Person sieht dieselbe gefilterte Liste, wenn sie Zugriff auf Audit-Protokolle und auf dieselbe Organisation hat.

Zum Beispiel öffnet eine Adresse, die auf /audit-logs/logs?email=priya.shah%40example.com endet, die nach dieser Person gefilterte Liste, und eine Adresse, die auf /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* endet, öffnet alle Türanfragen.

In der Liste navigieren

  • Klicken Sie auf eine Anfrage, um ihre Details rechts zu öffnen.
  • Mit den Pfeiltasten nach oben und nach unten wechseln Sie zur vorherigen oder nächsten Anfrage in der Liste.
  • Auf einem schmalen Bildschirm öffnen sich die Details über der Liste. Klicken Sie auf die Schaltfläche zum Schließen, um zur Liste zurückzukehren.

Keine Ergebnisse

Wenn nichts passt, zeigt die Liste "No logs match these filters" und "Try widening the time range or clearing a filter." an.

Die Registerkarte Logs mit gesetztem Filter Email und der Meldung No logs match these filtersDie Registerkarte Logs mit gesetztem Filter Email und der Meldung No logs match these filters

Abbildung 7: Keine passenden Anfragen: Erweitern Sie den Zeitraum oder entfernen Sie einen Filter

So finden Sie, wonach Sie suchen:

  • Wählen Sie einen längeren Range, etwa Last 7 days.
  • Prüfen Sie, ob Email und IP die vollständige Adresse enthalten. Ein Teil einer Adresse liefert keine Ergebnisse.
  • Entfernen Sie Filter einzeln mit ihrem × oder klicken Sie auf Clear.