Nhật ký truy cập
Trên trang này
Tab Nhật ký truy cập là dấu vết kiểm tra: mọi lần thử mở khóa — thành công, bị từ chối hoặc thất bại; từ ứng dụng di động hoặc do quản trị viên thực hiện — đều được ghi lại kèm thông tin ai, cửa nào, khi nào, từ đâu và kết quả. Trang này trình bày cách đọc nhật ký, lọc, chế độ xem No visit recorded, xuất ra CSV và chế độ xem chi tiết sự kiện.
Hình 1: Tab Nhật ký truy cập
Các sự kiện được lưu giữ trong khoảng 13 tháng, sau đó tự động bị xóa. Việc xóa một người dùng không xóa các sự kiện của họ — lịch sử được giữ lại để phục vụ dấu vết kiểm tra.
Nhật ký truy cập tách biệt với Nhật ký kiểm toán, nơi ghi lại các yêu cầu được thực hiện trên toàn Performance Hub.
Lọc và tìm kiếm
Hình 2: Tìm kiếm, các nhãn bộ lọc, cột, xuất, làm mới trực tiếp và khoảng ngày
| Điều khiển | Chức năng |
|---|---|
| Search | "Search door, person, event ID…" — khớp với cửa, người, ID sự kiện, ID lệnh, trạng thái và lý do từ chối |
| View | Door events (dấu vết kiểm tra) hoặc No visit recorded (xem bên dưới) |
| State, Result, Door, Source, Partner, Reason | Các nhãn bộ lọc thu hẹp danh sách theo trạng thái sự kiện, kết quả, cửa, nguồn gửi yêu cầu, đối tác tích hợp và lý do từ chối |
| Columns | Chọn các cột mà bảng hiển thị; nút cho biết có bao nhiêu cột đang bật |
| Xuất CSV | Tải xuống các sự kiện đang được lọc (xem Xuất ra CSV) |
| Live | Tự động làm mới danh sách, kèm bộ đếm ngược đến lần làm mới tiếp theo; nút bên cạnh sẽ làm mới ngay |
| Range | Last day, Last 7 days, Last 30 days, Last 90 days hoặc ngày tùy chỉnh |
Tiêu đề hiển thị số lượng sự kiện cho khoảng ngày và bộ lọc hiện tại. Mỗi khoảng ngày tải tối đa 500 sự kiện gần nhất.
Trạng thái sự kiện
| Nhãn trạng thái | Ý nghĩa |
|---|---|
| Confirmed unlocked | Bộ điều khiển cửa đã xác nhận rơ-le được nhả — cửa đã thực sự mở khóa |
| Unlocked | Lần mở khóa được báo cáo là thành công |
| Admin Unlocked | Một quản trị viên đã kích hoạt mở khóa từ Performance Hub (ghi đè của quản trị viên). Được ghi lại ngay khi lệnh được gửi đi |
| Denied | Yêu cầu đã bị từ chối — xem cột Reason (tất cả lý do) |
| Pending / Request received | Yêu cầu vẫn đang được xử lý (tạm thời — thường được giải quyết trong vài giây) |
| Timed out | Lệnh mở khóa đã được gửi nhưng bộ điều khiển không xác nhận kịp thời — thường do sự cố kết nối tại cửa |
| Failed | Không thể hoàn tất việc mở khóa do lỗi |
| Locked by staff | Nhân viên đã dùng Lock now trong khi lịch tự động mở khóa đang giữ cửa mở. Đây là sự kiện lịch, không phải lần thử mở khóa |
| Schedule resumed | Lịch tự động mở khóa đã tiếp quản trở lại, vào lần thay đổi tiếp theo của lịch hoặc vì nhân viên đã nhấn Resume schedule. Đây là sự kiện lịch, không phải lần thử mở khóa |
Mỗi hàng hiển thị dấu thời gian, trạng thái, cửa, người, khoảng cách từ cửa và độ trễ lệnh (khi có), và lý do từ chối đối với các sự kiện bị từ chối.
Không ghi nhận lượt truy cập nào
Hình 3: Chế độ xem No visit recorded
Đặt View thành No visit recorded để liệt kê các Access Time Windows dùng một lần, do quản trị viên hoặc một tích hợp thêm vào, mà người dùng chưa bao giờ mở khóa cửa trong khung thời gian đó (bao gồm mọi thời gian ân hạn). Các cột: Person, Scheduled period, Source / partner, Status. Các bản ghi được lưu giữ trong khoảng 13 tháng.
Ví dụ, một văn phòng có thể xem những nhà thầu nào có khung truy cập dùng một lần nhưng chưa bao giờ đến.
Ghi nhận Access Policy
Các sự kiện được ủy quyền theo chính sách xác định chính sách có tên và đối tượng, mục tiêu và lịch đã khớp. Các lần khớp theo lịch cũng có thể bao gồm thời điểm bắt đầu và kết thúc cụ thể đang áp dụng.
Access Time Windows do quản trị viên sở hữu và do tích hợp sở hữu giữ đường ghi nhận riêng (admin_time_window và source_time_window); chúng không bị gắn nhãn lại thành Access Policies. Các lần từ chối theo chính sách phân biệt giữa không khớp mục tiêu, không khớp đối tượng và lịch không hoạt động. Một lần diễn ra trong tương lai sử dụng outside_access_time_window kèm thông tin khả dụng có cấu trúc khi biết được.
Chi tiết sự kiện
Nhấp vào bất kỳ hàng nào để mở hộp thoại Access Details.
Hình 4: Hộp thoại Access Details của một lần mở khóa của hội viên
Tiêu đề hiển thị cửa, vị trí của cửa, kết quả, huy hiệu Admin override khi áp dụng, và lý do từ chối nếu bị từ chối. Các trường được hiển thị khi có:
| Trường | Ghi chú |
|---|---|
| Date / Time | Thời điểm diễn ra lần thử |
| Coordinates | Vị trí mà điện thoại báo cáo, kèm độ chính xác GPS (±N m); có thể sao chép |
| Door / Gate | Tên và vị trí cửa |
| Person hoặc Admin | Người đã thử — các lần mở khóa của quản trị viên hiển thị tài khoản của quản trị viên |
| Device | Điện thoại/thiết bị đã sử dụng |
| IP Address | IP gửi yêu cầu; có thể sao chép |
| Hold time | Thời gian cửa được giữ ở trạng thái mở khóa |
| Distance from door | Khoảng cách được tính từ tâm geofence |
| Event ID / Command ID | Các mã định danh có thể sao chép để chuyển lên bộ phận hỗ trợ |
| Latency | Thời gian bộ điều khiển cần để phản hồi lệnh |
| Authorization source | Access Policy, quyền cấp vĩnh viễn, khung thời gian của quản trị viên hoặc khung thời gian của tích hợp |
| Policy | ID/tên chính sách cùng đối tượng, mục tiêu cửa/Access Scope và chế độ Anytime/Scheduled đã khớp |
| Window / Source ID | Ghi nhận có giới hạn cho các khung thời gian theo lịch hoặc theo nguồn đang hoạt động |
| Active from / to | Lần diễn ra cụ thể tính bằng giây Unix được dùng cho quyết định theo khung thời gian; thời điểm kết thúc không được tính vào |
Unlock Location đánh dấu tọa độ được báo cáo trên bản đồ, kèm liên kết Open in Google Maps. Khi không có tọa độ, bạn sẽ thấy "No location captured — unlocked from the Performance Hub." (ghi đè của quản trị viên) hoặc "No location data was reported for this unlock attempt."
Xuất ra CSV
Nhấp vào Xuất CSV để tải xuống các sự kiện đang được lọc. Tệp bao gồm các trường danh tính, cửa, kết quả, từ chối, bộ điều khiển, tích hợp và ghi nhận chính sách/khung thời gian. Nút bị vô hiệu hóa khi danh sách đã lọc trống. Trong chế độ xem No visit recorded, Xuất CSV sẽ tải xuống danh sách đó.
Mẹo
- Thẻ Recent activity của tab Doors là lối tắt 24 giờ vào nhật ký này — nhấp vào một sự kiện tại đó sẽ chuyển thẳng đến sự kiện đó tại đây.
- Đang điều tra khiếu nại của hội viên? Dùng nhãn State hoặc Result để hiển thị các lần thử bị từ chối, tìm kiếm tên của họ và đọc lý do — sau đó xem Khắc phục sự cố để biết cách khắc phục theo từng lý do.
- Với khiếu nại liên quan đến chính sách, hãy xác nhận tên chính sách và Who/Where/When của chính sách. Với các khung thời gian của tích hợp, hãy kiểm tra thêm độ cũ của nguồn và ánh xạ
scope_key. - Một loạt sự kiện Timed out dồn dập trên một cửa thường có nghĩa là bộ điều khiển của cửa đó gặp sự cố mạng — hãy kiểm tra trạng thái của cửa trong tab Doors.
- AI Agent của bạn có thể đọc các sự kiện cửa thông qua MCP, ví dụ cho bảng chào mừng tại sảnh văn phòng cho từng khách. Các sự kiện cửa mang ID người dùng, không phải tên hay ngày sinh.
Trang liên quan
- Tham khảo — mọi trạng thái và lý do từ chối
- Lịch của Access Policy
- Khắc phục sự cố
- Doors