Performance Hub-LogoPerformance Hub
Websitebereich: Dokumentation

Untersuchungsbeispiele

Auf dieser Seite

Diese Beispiele zeigen, wie Sie häufige Fragen mit Audit-Protokollen beantworten. Jedes Beispiel nennt die Frage, die zu verwendenden Filter und Klicks und worauf Sie achten sollten. Dieselben Schritte funktionieren an jeder Art von Standort. Passen Sie die Filter also an Ihre eigene Frage an.

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: Von einer Frage zu den Anfragen gelangen, die sie beantworten

Wer hat den Haupteingang entsperrt?

Ein Fitnessstudio oder Freizeitzentrum: Der Haupteingang wurde aus der Ferne entsperrt, und die diensthabende Leitung möchte wissen, wer das war und warum.

  1. Klicken Sie auf der Registerkarte Logs auf Endpoint, geben Sie /api/door-gate-access/* ein und klicken Sie auf Apply. Die Liste zeigt nur noch Door & Gate Access-Anfragen.
  2. Stellen Sie Range so ein, dass der Zeitpunkt der Entsperrung abgedeckt ist.
  3. Klicken Sie auf die Anfrage, deren Endpunkt auf /front-entrance/unlock endet.

Die Registerkarte Logs, gefiltert nach /api/door-gate-access/*, mit geöffneter Anfrage zur Entsperrung des HaupteingangsDie Registerkarte Logs, gefiltert nach /api/door-gate-access/*, mit geöffneter Anfrage zur Entsperrung des Haupteingangs

Abbildung 1: Alle Türanfragen, mit geöffneter Entsperrung des Haupteingangs

Worauf Sie achten sollten: User zeigt, wer die Tür entsperrt hat, hier oscar.tran@example.com. Der Request POST Body zeigt den angegebenen Grund, "Member forgot access card", und der Response Body zeigt, dass die Tür entsperrt wurde.

Als Nächstes: Prüfen Sie den eigenen Datensatz der Tür in den Zugriffsprotokollen von Door & Gate Access. Dort wird jeder Entsperrversuch an der Tür erfasst, auch über die mobile App.

Warum konnte ein Mitarbeiter die Rolle einer Person nicht ändern?

Eine Physiotherapiepraxis: Eine Koordinatorin wollte einer Kollegin eine neue Rolle zuweisen, aber es hat nicht funktioniert.

  1. Klicken Sie auf der Registerkarte Logs auf Status und wählen Sie 403 Forbidden.
  2. Klicken Sie auf die Anfrage mit 403 Forbidden aus dem Zeitraum der Rollenänderung.
  3. Klicken Sie unter AI Error Summary auf Generate summary.

Die AI Error Summary erklärt, dass die Person, die die Änderung vornehmen wollte, nicht berechtigt war, diese Rolle zuzuweisenDie AI Error Summary erklärt, dass die Person, die die Änderung vornehmen wollte, nicht berechtigt war, diese Rolle zuzuweisen

Abbildung 2: Die Zusammenfassung erklärt, warum die Rollenänderung abgelehnt wurde

Worauf Sie achten sollten: Die Zusammenfassung besagt, dass die Person "does not have permission to assign that role". Gleichen Sie das mit dem Response Body ab, in dem "You don't have permission to assign this role." steht. Der Request POST Body zeigt, welche Rolle zugewiesen werden sollte.

Als Nächstes: Bitten Sie einen Organisation Administrator, die Änderung vorzunehmen, oder überprüfen Sie die Rolle der Person. Siehe Rollen eines Benutzers ändern und Rollenvorlagen.

Unsere Buchungsintegration hat über Nacht die Synchronisierung eingestellt

Ein Schwimmbad oder eine kommunale Einrichtung: Check-ins aus dem Buchungssystem erscheinen seit der Nacht nicht mehr.

  1. Klicken Sie auf der Registerkarte Logs auf Endpoint, geben Sie /partner/v1/* ein und klicken Sie auf Apply.
  2. Stellen Sie Range auf Last 24 hours.
  3. Sehen Sie sich den Status am Anfang jeder Zeile an und klicken Sie dann auf die fehlgeschlagenen Anfragen, um ihren Response Body zu lesen.

Worauf Sie achten sollten: Anfragen mit dem Badge api-key von integrations@example.org. Hier zeigt die Liste 429 Too Many Requests, wenn die Integration in kurzer Zeit zu viele Anfragen gesendet hat, sowie 503 Service Unavailable. Notieren Sie, wann die Fehler begonnen haben und ob danach erfolgreiche Anfragen folgten.

Als Nächstes: Klicken Sie auf CSV exportieren und senden Sie die Datei an den Integrationspartner, damit er seine Seite prüfen kann. Siehe Protokolle exportieren und die Seite Fehler der Partner API.

Ein Webhook wurde nicht gespeichert

Ein Café, ein Geschäft oder ein Gastronomiebetrieb: Eine Führungskraft hat einen Webhook eingerichtet, um Besucherdaten an ein anderes System zu senden, aber er wurde nicht gespeichert.

  1. Klicken Sie auf der Registerkarte Logs auf Email und geben Sie die vollständige E-Mail-Adresse der Führungskraft ein, hier leo.hargreaves@example.com.
  2. Suchen Sie die beiden POST-Anfragen aus dem Zeitraum, in dem der Webhook gespeichert wurde: eine mit 400 Bad Request und eine mit 201 Created am selben Endpunkt.
  3. Klicken Sie auf die Anfrage mit 400 Bad Request, dann auf die einige Minuten spätere mit 201 Created, und vergleichen Sie sie.

Worauf Sie achten sollten: Der Response Body der 400-Anfrage lautet "url must start with https://". In ihrem Request POST Body fehlt am Anfang der Adresse https://. Bei der 201-Anfrage war https:// ergänzt worden, und der Webhook wurde gespeichert.

Als Nächstes: Klicken Sie bei einer fehlgeschlagenen Anfrage auf Generate summary, um eine verständliche Erklärung zu erhalten. Siehe AI Error Summary.

Was hat ein ausscheidender Mitarbeiter letzte Woche getan?

Ein Büro oder Coworking-Space: Bevor ein Mitarbeiter das Unternehmen verlässt, möchte seine Führungskraft eine Aufzeichnung seiner jüngsten Aktivitäten.

  1. Klicken Sie auf der Registerkarte Logs auf Email und geben Sie die vollständige E-Mail-Adresse der Person ein.
  2. Stellen Sie Range auf Last 7 days.
  3. Scrollen Sie ans Ende der Liste, damit alle Anfragen geladen werden. Der Export enthält nur die geladenen Zeilen.
  4. Klicken Sie auf CSV exportieren und dann auf Export.

Worauf Sie achten sollten: Änderungen statt Lesezugriffe. Stellen Sie Method nacheinander auf POST, PUT, PATCH oder DELETE, um die Anfragen zu sehen, mit denen etwas erstellt, geändert oder entfernt wurde. Öffnen Sie bei allem Unerwarteten die Anfrage und lesen Sie ihren Request POST Body.

Als Nächstes: Entfernen Sie den Zugriff der Person, wenn sie das Unternehmen verlässt. Siehe Benutzer entfernen. Bewahren Sie die CSV-Datei gemäß den Richtlinien Ihrer Organisation auf.

Welcher Standort hatte die meisten fehlgeschlagenen Anfragen?

Ein Betreiber mehrerer Standorte: Mehrere Standorte haben gestern Probleme gemeldet, und die Zentrale möchte wissen, wo sie ansetzen soll.

  1. Stellen Sie auf der Registerkarte Dashboard das Window so ein, dass der Tag abgedeckt ist.
  2. Klicken Sie unter Errors Over Time auf den Abschnitt mit den meisten Fehlern. Die Registerkarte Logs öffnet sich mit den fehlgeschlagenen Anfragen aus diesem Zeitraum.
  3. Klicken Sie auf Einrichtung, wählen Sie nacheinander jeden Standort aus und vergleichen Sie, wie viele fehlgeschlagene Anfragen jeder hat.

Worauf Sie achten sollten: einen Standort mit deutlich mehr Fehlern als die anderen oder Fehler an einem bestimmten Endpunkt. Öffnen Sie einige seiner Anfragen und lesen Sie den Response Body oder klicken Sie auf Generate summary.

Als Nächstes: Unter Das Dashboard finden Sie die weiteren Diagramme und unter Einrichtungen die Standorte Ihrer Organisation.