Performance Hub-LogoPerformance Hub
Websitebereich: Dokumentation

Audit-Protokolle

Auf dieser Seite

Audit-Protokolle zeichnen die Anfragen auf, die in Ihrer Organisation an den Performance Hub gestellt werden. Sie umfassen Anfragen von Personen, die den Performance Hub in einem Browser oder in der App verwenden, sowie von verbundenen Tools wie API-Schlüsseln, über MCP verbundenen KI-Agenten und dem Model Router. Damit beantworten Sie Fragen wie: Wer hat eine Tür entsperrt, warum wurde eine Änderung nicht gespeichert oder wann hat eine Integration aufgehört zu funktionieren – ganz gleich, ob Ihre Standorte Büros, Geschäfte, Cafés, Veranstaltungsorte, Praxen, Campusse oder Fitnessstudios sind.

Kurzübersicht

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

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: Sehen, wer was im Performance Hub getan hat, und herausfinden, warum eine Anfrage fehlgeschlagen ist

Das Dashboard der Audit-Protokolle mit der Schaltfläche Window, fünf Kennzahlen und dem Diagramm Request TimelineDas Dashboard der Audit-Protokolle mit der Schaltfläche Window, fünf Kennzahlen und dem Diagramm Request Timeline

Abbildung 1: Das Dashboard der Audit-Protokolle: das Zeitfenster, die Kennzahlen und die Zeitachse der Anfragen

Was protokolliert wird

Jeder Protokolleintrag ist eine an den Performance Hub gestellte Anfrage. Er zeigt:

  • Wer die Anfrage gestellt hat: die E-Mail-Adresse des Benutzers.
  • Von wo: die IP-Adresse sowie der Browser oder das Tool, das die Anfrage gesendet hat.
  • Was aufgerufen wurde: die Methode (zum Beispiel GET zum Lesen oder POST zum Erstellen) und der Endpunkt, also der Teil des Performance Hub, für den die Anfrage bestimmt war, etwa /api/door-gate-access/doors/front-entrance/unlock.
  • Das Ergebnis: der Antwortstatus, zum Beispiel 200 bei Erfolg oder 403, wenn die Person keine Berechtigung hatte.
  • Wie lange es gedauert hat, in Millisekunden.
  • Woher sie stammt: ein Quellen-Badge, etwa web für eine Person, die den Performance Hub verwendet, oder api-key für eine Integration. Siehe Quellen-Badges.

Bei aktuellen Anfragen enthält der Protokolleintrag außerdem, was gesendet und was zurückgegeben wurde. Siehe Einen Protokolleintrag lesen.

Die beiden Registerkarten

RegisterkarteWofür sie dient
DashboardSummen, Fehlerquoten und Diagramme für ein Zeitfenster, mit den am häufigsten aufgerufenen Endpunkten und den aktivsten Benutzern. Klicken Sie auf ein Diagramm oder eine Zeile, um die passenden Protokolle zu öffnen.
LogsDie Anfragen selbst. Filtern und durchsuchen Sie die Liste, öffnen Sie einen Protokolleintrag, um seine Details zu sehen, und exportieren Sie als CSV.

Wer Audit-Protokolle verwenden kann

Sie benötigen eine Rolle, die Audit-Protokolle und Identity & Access Management in Ihrer Organisation umfasst, zum Beispiel Organisation Administrator. Wenn Sie Audit-Protokolle im Einstellungsmenü nicht sehen, umfasst Ihre Rolle diese Funktion nicht.

  • Welche Organisationen Sie sehen: die Organisationen, in denen Ihre Rolle sowohl Audit-Protokolle als auch Identity & Access Management umfasst. Die Registerkarte Logs zeigt an, wie viele es sind, zum Beispiel "Viewing logs for 1 organisation".
  • Rollenvorlagen: Die Vorlage Organisation Administrator enthält Audit-Protokolle. Die Vorlagen Site Manager und Site Owner enthalten sie nicht. Siehe Rollenvorlagen.
  • Benutzerdefinierte Rollen: Damit eine benutzerdefinierte Rolle Audit-Protokolle verwenden kann, nehmen Sie sowohl Audit-Protokolle als auch Identity & Access Management in ihren Modulzugriff auf. Siehe Zugriffsbereich und Modulzugriff.

Audit-Protokolle zeigen E-Mail-Adressen, IP-Adressen und die von Personen gesendeten Inhalte an. Gewähren Sie den Zugriff daher nur Personen, die ihn benötigen.

Wie lange Protokolle aufbewahrt werden

Die Aufbewahrungsdauer für Audit-Protokolle legt fest, wie lange sie gespeichert werden: 90 Tage für jeden Protokolleintrag und 7 Tage für die vollständigen Anfrage- und Antwortinhalte.

Im Menü Range auf der Registerkarte Logs steht:

"Audit-Protokolle werden 90 Tage lang aufbewahrt. Vollständige Anfrage- und Antwort-Payloads werden 7 Tage lang aufbewahrt, danach bleibt eine kurze Vorschau erhalten. Benötigen Sie einen längeren Verlauf? Wenden Sie sich an den Support (es fallen zusätzliche Gebühren an)."

Sie können also 90 Tage zurückblicken. In den ersten 7 Tagen enthält ein Protokolleintrag die vollständige Anfrage und Antwort. Danach werden längere Inhalte auf eine kurze Vorschau gekürzt. Siehe Nach 7 Tagen: Vorschauen.

Was Sie tun können

  • Das Dashboard lesen: Anfragevolumen, Fehlerquoten sowie die am häufigsten aufgerufenen Endpunkte und aktivsten Benutzer für ein Zeitfenster ansehen.
  • Anfragen finden: nach Zeitraum, E-Mail-Adresse, IP-Adresse, Endpunkt, Organisation, Einrichtung, Methode und Status filtern und eine gefilterte Ansicht teilen.
  • Einen Protokolleintrag lesen: sehen, wer eine Anfrage gestellt hat, von wo und was gesendet und zurückgegeben wurde. Bei einer fehlgeschlagenen Anfrage erhalten Sie eine verständliche Zusammenfassung des Fehlers.
  • Protokolle exportieren: die geladenen Protokolle als CSV-Datei herunterladen.
  • Einem Untersuchungsbeispiel folgen: Schritt-für-Schritt-Antworten auf häufige Fragen, etwa wer eine Tür entsperrt hat oder warum eine Integration die Synchronisierung eingestellt hat.
  • Häufige Fragen