Log Akses
Di halaman ini
Tab Access Logs adalah jejak audit: setiap upaya membuka kunci — berhasil, ditolak, atau gagal; dari aplikasi seluler atau oleh admin — dicatat beserta siapa, pintu mana, kapan, dari mana, dan hasilnya. Halaman ini membahas cara membaca log, memfilter, tampilan No visit recorded, mengekspor ke CSV, dan tampilan detail peristiwa.
Gambar 1: Tab Access Logs
Peristiwa disimpan selama sekitar 13 bulan, lalu dihapus secara otomatis. Menghapus pengguna tidak menghapus peristiwanya — riwayat tetap disimpan untuk jejak audit.
Access Logs terpisah dari Catatan Audit, yang mencatat permintaan yang dibuat di seluruh Performance Hub.
Memfilter dan mencari
Gambar 2: Pencarian, chip filter, kolom, ekspor, penyegaran langsung, dan rentang
| Kontrol | Fungsinya |
|---|---|
| Search | "Search door, person, event ID…" — mencocokkan pintu, orang, ID peristiwa, ID perintah, status, dan alasan penolakan |
| View | Door events (jejak audit) atau No visit recorded (lihat di bawah) |
| State, Result, Door, Source, Partner, Reason | Chip filter yang mempersempit daftar berdasarkan status peristiwa, hasil, pintu, asal permintaan, mitra integrasi, dan alasan penolakan |
| Columns | Memilih kolom yang ditampilkan tabel; tombol ini menunjukkan berapa banyak kolom yang aktif |
| Ekspor CSV | Mengunduh peristiwa yang sedang difilter (lihat Mengekspor ke CSV) |
| Live | Menyegarkan daftar secara otomatis, dengan hitung mundur ke penyegaran berikutnya; tombol di sampingnya menyegarkan sekarang |
| Range | Last day, Last 7 days, Last 30 days, Last 90 days, atau tanggal khusus |
Header menunjukkan jumlah peristiwa untuk rentang dan filter saat ini. Setiap rentang memuat hingga 500 peristiwa terbaru.
Status peristiwa
| Chip status | Artinya |
|---|---|
| Confirmed unlocked | Pengontrol pintu mengonfirmasi bahwa relai telah dilepas — pintu benar-benar terbuka kuncinya |
| Unlocked | Pembukaan kunci dilaporkan berhasil |
| Admin Unlocked | Admin memicu pembukaan kunci dari Performance Hub (penggantian oleh admin). Dicatat segera setelah perintah dikirim |
| Denied | Permintaan ditolak — lihat kolom Reason (semua alasan) |
| Pending / Request received | Permintaan masih diproses (sementara — biasanya selesai dalam hitungan detik) |
| Timed out | Perintah membuka kunci telah dikirim tetapi pengontrol tidak mengonfirmasi tepat waktu — biasanya karena masalah konektivitas di pintu |
| Failed | Pembukaan kunci tidak dapat diselesaikan karena terjadi kesalahan |
| Locked by staff | Staf menggunakan Lock now saat jadwal buka kunci otomatis sedang menahan pintu tetap terbuka. Ini peristiwa jadwal, bukan upaya membuka kunci |
| Schedule resumed | Jadwal buka kunci otomatis kembali berlaku, baik pada perubahan berikutnya maupun karena staf menekan Resume schedule. Ini peristiwa jadwal, bukan upaya membuka kunci |
Setiap baris menampilkan stempel waktu, status, pintu, orang, jarak dari pintu dan latensi perintah (jika tersedia), serta alasan penolakan untuk peristiwa yang ditolak.
Tidak ada kunjungan yang tercatat
Gambar 3: Tampilan No visit recorded
Atur View ke No visit recorded untuk mencantumkan Access Time Windows satu kali, yang ditambahkan oleh admin atau integrasi, saat orang tersebut tidak pernah membuka kunci pintu selama jendela waktu tersebut (termasuk masa tenggang apa pun). Kolom: Person, Scheduled period, Source / partner, Status. Catatan disimpan selama sekitar 13 bulan.
Misalnya, kantor dapat melihat kontraktor dengan jendela waktu satu kali yang tidak pernah datang.
Atribusi Access Policy
Peristiwa yang diotorisasi oleh kebijakan mengidentifikasi kebijakan yang dinamai beserta audiens, target, dan jadwal yang cocok. Kecocokan terjadwal juga dapat mencakup awal dan akhir konkret yang aktif.
Access Time Windows milik administrator dan milik integrasi mempertahankan jalur atribusinya sendiri (admin_time_window dan source_time_window); keduanya tidak diberi label ulang sebagai Access Policies. Penolakan kebijakan membedakan ketidakcocokan target, audiens, dan jadwal yang tidak aktif. Kejadian di masa mendatang menggunakan outside_access_time_window dengan ketersediaan terstruktur jika diketahui.
Detail peristiwa
Klik baris mana pun untuk membuka dialog Access Details.
Gambar 4: Dialog Access Details untuk pembukaan kunci oleh anggota
Header menampilkan pintu, lokasinya, hasilnya, lencana Admin override jika berlaku, dan alasan penolakan jika ditolak. Kolom yang ditampilkan jika tersedia:
| Kolom | Catatan |
|---|---|
| Date / Time | Kapan upaya tersebut terjadi |
| Coordinates | Lokasi yang dilaporkan ponsel, dengan akurasi GPS (±N m); dapat disalin |
| Door / Gate | Nama dan lokasi pintu |
| Person atau Admin | Siapa yang mencoba — pembukaan kunci oleh admin menampilkan akun admin |
| Device | Ponsel/perangkat yang digunakan |
| IP Address | IP yang mengajukan permintaan; dapat disalin |
| Hold time | Berapa lama pintu tetap tidak terkunci |
| Distance from door | Jarak yang dihitung dari pusat geofence |
| Event ID / Command ID | Pengidentifikasi yang dapat disalin untuk eskalasi ke tim dukungan |
| Latency | Berapa lama pengontrol merespons perintah |
| Authorization source | Access Policy, pemberian akses permanen, jendela waktu administrator, atau jendela waktu integrasi |
| Policy | ID/nama kebijakan ditambah audiens, target pintu/Access Scope, dan mode Anytime/Scheduled yang cocok |
| Window / Source ID | Atribusi terbatas untuk jendela waktu terjadwal atau sumber yang aktif |
| Active from / to | Kejadian konkret dalam detik Unix yang digunakan untuk keputusan jendela waktu; waktu akhir bersifat eksklusif |
Unlock Location memetakan koordinat yang dilaporkan di peta dengan tautan Open in Google Maps. Jika tidak ada koordinat, Anda akan melihat "No location captured — unlocked from the Performance Hub." (penggantian oleh admin) atau "No location data was reported for this unlock attempt."
Mengekspor ke CSV
Klik Ekspor CSV untuk mengunduh peristiwa yang sedang difilter. File ini mencakup kolom identitas, pintu, hasil, penolakan, pengontrol, integrasi, dan atribusi kebijakan/jendela waktu. Tombol dinonaktifkan jika daftar yang difilter kosong. Dalam tampilan No visit recorded, Ekspor CSV mengunduh daftar tersebut.
Tips
- Kartu Recent activity di tab Doors adalah pintasan 24 jam ke log ini — mengklik peristiwa di sana akan langsung membawa Anda ke peristiwa tersebut di sini.
- Menyelidiki keluhan anggota? Gunakan chip State atau Result untuk menampilkan upaya yang ditolak, cari namanya, dan baca alasannya — lalu lihat Pemecahan masalah untuk solusi per alasan.
- Untuk keluhan terkait kebijakan, pastikan nama kebijakan serta Who/Where/When-nya. Untuk jendela waktu integrasi, periksa juga usia sumber dan pemetaan
scope_key. - Serangkaian peristiwa Timed out pada satu pintu biasanya berarti pengontrol pintu tersebut mengalami masalah jaringan — periksa statusnya di tab Doors.
- Agen AI Anda dapat membaca peristiwa pintu melalui MCP, misalnya untuk sambutan lobi kantor untuk setiap pengunjung. Peristiwa pintu membawa ID pengguna, bukan nama atau tanggal lahir.
Halaman terkait
- Referensi — setiap status dan alasan penolakan
- Jadwal Access Policy
- Pemecahan masalah
- Doors