Log Akses
Pada halaman ini
Tab Access Logs ialah jejak audit: setiap percubaan membuka kunci — berjaya, ditolak atau gagal; daripada aplikasi mudah alih atau oleh pentadbir — direkodkan bersama siapa, pintu yang mana, bila, dari mana dan hasilnya. Halaman ini merangkumi cara membaca log, penapisan, paparan No visit recorded, eksport ke CSV, dan paparan butiran peristiwa.
Rajah 1: Tab Access Logs
Peristiwa disimpan selama kira-kira 13 bulan, kemudian dialih keluar secara automatik. Memadamkan pengguna tidak memadamkan peristiwa mereka — sejarah disimpan untuk jejak audit.
Access Logs adalah berasingan daripada Log Audit, yang merekodkan permintaan yang dibuat merentas Performance Hub.
Menapis dan mencari
Rajah 2: Carian, cip penapis, lajur, eksport, muat semula langsung dan julat
| Kawalan | Fungsinya |
|---|---|
| Search | "Search door, person, event ID…" — memadankan pintu, orang, ID peristiwa, ID arahan, keadaan dan sebab penolakan |
| View | Door events (jejak audit) atau No visit recorded (lihat di bawah) |
| State, Result, Door, Source, Partner, Reason | Cip penapis yang mengecilkan senarai mengikut keadaan peristiwa, hasil, pintu, asal permintaan, rakan integrasi dan sebab penolakan |
| Columns | Pilih lajur yang ditunjukkan oleh jadual; butang menunjukkan bilangan lajur yang dihidupkan |
| Eksport CSV | Memuat turun peristiwa yang sedang ditapis (lihat Mengeksport ke CSV) |
| Live | Memuat semula senarai secara automatik, dengan kiraan detik ke muat semula seterusnya; butang di sebelahnya memuat semula sekarang |
| Range | Last day, Last 7 days, Last 30 days, Last 90 days, atau tarikh tersuai |
Pengepala menunjukkan kiraan peristiwa untuk julat dan penapis semasa. Setiap julat memuatkan sehingga 500 peristiwa terkini.
Keadaan peristiwa
| Cip keadaan | Maksud |
|---|---|
| Confirmed unlocked | Pengawal pintu mengesahkan geganti telah dilepaskan — pintu benar-benar dibuka kuncinya |
| Unlocked | Pembukaan kunci dilaporkan berjaya |
| Admin Unlocked | Pentadbir mencetuskan pembukaan kunci daripada Performance Hub (pengatasan pentadbir). Direkodkan sebaik sahaja arahan dihantar |
| Denied | Permintaan ditolak — lihat lajur Reason (semua sebab) |
| Pending / Request received | Permintaan masih diproses (sementara — biasanya selesai dalam beberapa saat) |
| Timed out | Arahan buka kunci telah dihantar tetapi pengawal tidak mengesahkan dalam masa yang ditetapkan — biasanya masalah kesambungan di pintu |
| Failed | Pembukaan kunci tidak dapat diselesaikan kerana ralat |
| Locked by staff | Kakitangan menggunakan Lock now semasa jadual buka kunci automatik sedang menahan pintu terbuka. Peristiwa jadual, bukan percubaan membuka kunci |
| Schedule resumed | Jadual buka kunci automatik mengambil alih semula, sama ada pada perubahan seterusnya atau kerana kakitangan menekan Resume schedule. Peristiwa jadual, bukan percubaan membuka kunci |
Setiap baris menunjukkan cap masa, keadaan, pintu, orang, jarak dari pintu dan kependaman arahan (jika tersedia), serta sebab penolakan untuk peristiwa yang ditolak.
Tiada lawatan direkodkan
Rajah 3: Paparan No visit recorded
Tetapkan View kepada No visit recorded untuk menyenaraikan Access Time Windows sekali sahaja, yang ditambah oleh pentadbir atau integrasi, yang mana orang itu tidak pernah membuka kunci pintu semasa tetingkap tersebut (termasuk sebarang tempoh tangguh). Lajur: Person, Scheduled period, Source / partner, Status. Rekod disimpan selama kira-kira 13 bulan.
Contohnya, pejabat boleh melihat kontraktor dengan tetingkap sekali sahaja yang tidak pernah hadir.
Atribusi Access Policy
Peristiwa yang dibenarkan oleh polisi mengenal pasti polisi bernama serta khalayak, sasaran dan jadual yang sepadan. Padanan berjadual juga boleh merangkumi permulaan dan penghujung konkrit yang aktif.
Access Time Windows yang dimiliki oleh pentadbir dan yang dimiliki oleh integrasi mengekalkan laluan atribusi masing-masing (admin_time_window dan source_time_window); ia tidak dilabel semula sebagai Access Policies. Penolakan polisi membezakan ketidakpadanan sasaran, khalayak dan jadual tidak aktif. Kejadian pada masa hadapan menggunakan outside_access_time_window dengan ketersediaan berstruktur apabila diketahui.
Butiran peristiwa
Klik mana-mana baris untuk membuka dialog Access Details.
Rajah 4: Dialog Access Details untuk pembukaan kunci oleh ahli
Pengepala menunjukkan pintu, lokasinya, hasilnya, lencana Admin override jika berkenaan, dan sebab penolakan jika ditolak. Medan yang ditunjukkan apabila tersedia:
| Medan | Nota |
|---|---|
| Date / Time | Bila percubaan berlaku |
| Coordinates | Lokasi yang dilaporkan oleh telefon, dengan ketepatan GPS (±N m); boleh disalin |
| Door / Gate | Nama dan lokasi pintu |
| Person atau Admin | Siapa yang mencuba — pembukaan kunci oleh pentadbir menunjukkan akaun pentadbir |
| Device | Telefon/peranti yang digunakan |
| IP Address | IP yang membuat permintaan; boleh disalin |
| Hold time | Berapa lama pintu kekal tidak berkunci |
| Distance from door | Jarak yang dikira dari pusat geofence |
| Event ID / Command ID | Pengecam yang boleh disalin untuk eskalasi sokongan |
| Latency | Berapa lama pengawal mengambil masa untuk bertindak balas terhadap arahan |
| Authorization source | Access Policy, pemberian kekal, tetingkap pentadbir atau tetingkap integrasi |
| Policy | ID/nama polisi serta khalayak, sasaran pintu/Skop Akses dan mod Anytime/Scheduled yang sepadan |
| Window / Source ID | Atribusi terbatas untuk tetingkap berjadual atau tetingkap sumber yang aktif |
| Active from / to | Kejadian konkrit dalam saat Unix yang digunakan untuk keputusan tetingkap; penghujungnya eksklusif |
Unlock Location memplotkan koordinat yang dilaporkan pada peta dengan pautan Open in Google Maps. Apabila tiada koordinat, anda akan melihat "No location captured — unlocked from the Performance Hub." (pengatasan pentadbir) atau "No location data was reported for this unlock attempt."
Mengeksport ke CSV
Klik Eksport CSV untuk memuat turun peristiwa yang sedang ditapis. Fail ini merangkumi medan identiti, pintu, hasil, penolakan, pengawal, integrasi dan atribusi polisi/tetingkap. Butang dinyahdayakan apabila senarai yang ditapis kosong. Dalam paparan No visit recorded, Eksport CSV memuat turun senarai tersebut sebaliknya.
Petua
- Kad Recent activity pada tab Doors ialah pintasan 24 jam ke dalam log ini — mengklik peristiwa di sana membawa anda terus kepadanya di sini.
- Menyiasat aduan ahli? Gunakan cip State atau Result untuk menunjukkan percubaan yang ditolak, cari nama mereka, dan baca sebabnya — kemudian lihat Penyelesaian masalah untuk penyelesaian bagi setiap sebab.
- Untuk aduan polisi, sahkan nama polisi dan Who/Where/Whennya. Untuk tetingkap integrasi, periksa juga usia sumber dan pemetaan
scope_key. - Lonjakan peristiwa Timed out pada satu pintu biasanya bermakna pengawal pintu itu mempunyai masalah rangkaian — semak statusnya dalam tab Doors.
- Ejen AI anda boleh membaca peristiwa pintu melalui MCP, contohnya untuk alu-aluan lobi pejabat untuk setiap pelawat. Peristiwa pintu membawa ID pengguna, bukan nama atau tarikh lahir.
Halaman berkaitan
- Rujukan — setiap keadaan dan sebab penolakan
- Jadual Access Policy
- Penyelesaian masalah
- Doors