Zugriffsprotokolle
Auf dieser Seite
Der Tab „Access Logs“ ist der Prüfpfad: Jeder Entsperrversuch – erfolgreich, abgelehnt oder fehlgeschlagen, über die mobile App oder durch einen Administrator – wird mit Person, Tür, Zeitpunkt, Herkunft und Ergebnis aufgezeichnet. Diese Seite behandelt das Lesen des Protokolls, das Filtern, die Ansicht „No visit recorded“, den Export als CSV und die Detailansicht eines Ereignisses.
Abbildung 1: Der Tab „Access Logs“
Ereignisse werden etwa 13 Monate lang aufbewahrt und dann automatisch entfernt. Das Löschen eines Benutzers löscht seine Ereignisse nicht – der Verlauf bleibt für den Prüfpfad erhalten.
Zugriffsprotokolle sind von den Audit-Protokollen getrennt, die Anfragen im gesamten Performance Hub aufzeichnen.
Filtern und Suchen
Abbildung 2: Suche, Filter-Chips, Spalten, Export, Live-Aktualisierung und Zeitraum
| Steuerelement | Funktion |
|---|---|
| Search | „Search door, person, event ID…“ – durchsucht Tür, Person, Ereignis-ID, Befehls-ID, Status und Ablehnungsgrund |
| View | Door events (der Prüfpfad) oder No visit recorded (siehe unten) |
| State, Result, Door, Source, Partner, Reason | Filter-Chips, die die Liste nach Ereignisstatus, Ergebnis, Tür, Herkunft der Anfrage, Integrationspartner und Ablehnungsgrund eingrenzen |
| Columns | Festlegen, welche Spalten die Tabelle anzeigt; die Schaltfläche zeigt, wie viele aktiviert sind |
| CSV exportieren | Lädt die aktuell gefilterten Ereignisse herunter (siehe Export als CSV) |
| Live | Aktualisiert die Liste automatisch, mit einem Countdown bis zur nächsten Aktualisierung; die Schaltfläche daneben aktualisiert sofort |
| Range | Last day, Last 7 days, Last 30 days, Last 90 days oder benutzerdefinierte Daten |
Die Kopfzeile zeigt die Anzahl der Ereignisse für den aktuellen Zeitraum und die aktuellen Filter. Jeder Zeitraum lädt bis zu 500 der neuesten Ereignisse.
Ereignisstatus
| Status-Chip | Bedeutung |
|---|---|
| Confirmed unlocked | Der Türcontroller hat bestätigt, dass das Relais freigegeben wurde – die Tür wurde tatsächlich entsperrt |
| Unlocked | Die Entsperrung wurde als erfolgreich gemeldet |
| Admin Unlocked | Ein Administrator hat die Entsperrung im Performance Hub ausgelöst (Admin-Override). Wird aufgezeichnet, sobald der Befehl gesendet wird |
| Denied | Die Anfrage wurde abgelehnt – siehe Spalte Reason (alle Gründe) |
| Pending / Request received | Die Anfrage wird noch verarbeitet (vorübergehend – normalerweise innerhalb von Sekunden erledigt) |
| Timed out | Der Entsperrbefehl wurde gesendet, aber der Controller hat ihn nicht rechtzeitig bestätigt – meist ein Verbindungsproblem an der Tür |
| Failed | Die Entsperrung konnte aufgrund eines Fehlers nicht abgeschlossen werden |
| Locked by staff | Mitarbeitende haben Lock now verwendet, während der Zeitplan für automatisches Entsperren die Tür offen hielt. Ein Zeitplanereignis, kein Entsperrversuch |
| Schedule resumed | Der Zeitplan für automatisches Entsperren hat wieder übernommen, entweder bei seiner nächsten Änderung oder weil Mitarbeitende Resume schedule gedrückt haben. Ein Zeitplanereignis, kein Entsperrversuch |
Jede Zeile zeigt Zeitstempel, Status, Tür, Person, Entfernung zur Tür und Befehlslatenz (sofern verfügbar) sowie bei abgelehnten Ereignissen den Ablehnungsgrund.
Kein Besuch aufgezeichnet
Abbildung 3: Die Ansicht „No visit recorded“
Setzen Sie View auf No visit recorded, um einmalige Access Time Windows aufzulisten, die von einem Administrator oder einer Integration hinzugefügt wurden und in denen die Person während des Fensters (einschließlich einer etwaigen Kulanzzeit) nie eine Tür entsperrt hat. Spalten: Person, Scheduled period, Source / partner, Status. Die Einträge werden etwa 13 Monate lang aufbewahrt.
So kann ein Büro zum Beispiel sehen, welche Auftragnehmer mit einem einmaligen Fenster nie erschienen sind.
Zuordnung zu Access Policies
Durch eine Policy autorisierte Ereignisse nennen die benannte Policy sowie die passende Zielgruppe, das passende Ziel und den passenden Zeitplan. Bei geplanten Treffern können zusätzlich der konkrete aktive Beginn und das konkrete aktive Ende angegeben sein.
Access Time Windows, die einem Administrator oder einer Integration gehören, behalten ihre eigenen Zuordnungspfade (admin_time_window und source_time_window); sie werden nicht als Access Policies umbenannt. Ablehnungen durch Policies unterscheiden zwischen nicht passendem Ziel, nicht passender Zielgruppe und inaktivem Zeitplan. Für ein künftiges Vorkommen wird outside_access_time_window mit strukturierten Verfügbarkeitsangaben verwendet, sofern bekannt.
Ereignisdetails
Klicken Sie auf eine beliebige Zeile, um den Dialog Access Details zu öffnen.
Abbildung 4: Der Dialog „Access Details“ für eine Entsperrung durch ein Mitglied
Die Kopfzeile zeigt die Tür, ihren Standort, das Ergebnis, gegebenenfalls ein Badge Admin override und bei Ablehnung den Ablehnungsgrund. Folgende Felder werden angezeigt, sofern verfügbar:
| Feld | Hinweise |
|---|---|
| Date / Time | Wann der Versuch stattfand |
| Coordinates | Der vom Telefon gemeldete Standort mit GPS-Genauigkeit (±N m); kopierbar |
| Door / Gate | Name und Standort der Tür |
| Person oder Admin | Wer den Versuch unternommen hat – bei Entsperrungen durch Administratoren wird das Konto des Administrators angezeigt |
| Device | Das verwendete Telefon bzw. Gerät |
| IP Address | Die anfragende IP-Adresse; kopierbar |
| Hold time | Wie lange die Tür entsperrt blieb |
| Distance from door | Berechnete Entfernung vom Mittelpunkt des Geofence |
| Event ID / Command ID | Kopierbare Kennungen für die Eskalation an den Support |
| Latency | Wie lange der Controller gebraucht hat, um auf den Befehl zu reagieren |
| Authorization source | Access Policy, dauerhafte Berechtigung, Administratorfenster oder Integrationsfenster |
| Policy | ID bzw. Name der Policy sowie die passende Zielgruppe, das Ziel (Tür oder Zugriffsbereich) und der Modus Anytime oder Scheduled |
| Window / Source ID | Begrenzte Zuordnung für aktive geplante Fenster oder Quellfenster |
| Active from / to | Konkretes Vorkommen in Unix-Sekunden, das für eine Fensterentscheidung verwendet wurde; das Ende ist exklusiv |
Unlock Location zeigt die gemeldeten Koordinaten auf einer Karte mit dem Link Open in Google Maps. Wenn keine Koordinaten vorliegen, sehen Sie „No location captured — unlocked from the Performance Hub.“ (Admin-Overrides) oder „No location data was reported for this unlock attempt.“
Export als CSV
Klicken Sie auf CSV exportieren, um die aktuell gefilterten Ereignisse herunterzuladen. Die Datei enthält Felder zu Identität, Tür, Ergebnis, Ablehnung, Controller, Integration sowie zur Zuordnung von Policy und Fenster. Die Schaltfläche ist deaktiviert, wenn die gefilterte Liste leer ist. In der Ansicht No visit recorded lädt CSV exportieren stattdessen diese Liste herunter.
Tipps
- Die Karte Recent activity im Tab „Doors“ ist eine 24-Stunden-Abkürzung zu diesem Protokoll – wenn Sie dort auf ein Ereignis klicken, springen Sie direkt hierher.
- Sie gehen der Beschwerde eines Mitglieds nach? Verwenden Sie den Chip State oder Result, um abgelehnte Versuche anzuzeigen, suchen Sie nach dem Namen und lesen Sie den Grund – die Lösung für jeden Grund finden Sie unter Fehlerbehebung.
- Prüfen Sie bei Beschwerden zu Policies den Namen der Policy und ihre Angaben zu Who/Where/When. Prüfen Sie bei Integrationsfenstern außerdem das Alter der Quelle und die Zuordnung von
scope_key. - Eine Häufung von Timed out-Ereignissen an einer Tür bedeutet in der Regel, dass der Controller dieser Tür Netzwerkprobleme hat – prüfen Sie seinen Status im Tab Doors.
- Ihr KI-Agent kann Türereignisse über MCP lesen, zum Beispiel für eine Begrüßung für jeden Besucher in der Bürolobby. Türereignisse enthalten eine Benutzer-ID, keinen Namen und kein Geburtsdatum.
Verwandte Seiten
- Referenz – jeder Status und jeder Ablehnungsgrund
- Zeitpläne für Access Policies
- Fehlerbehebung
- Doors