访问日志
本页内容
访问日志选项卡是审计记录：每次解锁尝试（无论成功、被拒绝还是失败，无论来自移动应用还是管理员）都会被记录，包括谁、哪扇门、何时、从何处以及结果。本页介绍如何查看日志、筛选、No visit recorded 视图、导出为 CSV 以及事件详细信息视图。
图 1：访问日志选项卡
事件保留约 13 个月，之后会自动删除。删除用户不会删除其事件，历史记录会保留用于审计。
访问日志与审计日志是分开的，后者记录在整个 Performance Hub 中发出的请求。
筛选和搜索
图 2：搜索、筛选标记、列、导出、实时刷新和范围
| 控件 | 作用 |
|---|---|
| Search | “Search door, person, event ID…”：匹配门、人员、事件 ID、命令 ID、状态和拒绝原因 |
| View | Door events（审计记录）或 No visit recorded（请参阅下文） |
| State、Result、Door、Source、Partner、Reason | 筛选标记，可按事件状态、结果、门、请求来源、集成合作伙伴和拒绝原因缩小列表范围 |
| Columns | 选择表格显示哪些列；按钮会显示已开启的列数 |
| 导出 CSV | 下载当前筛选出的事件（请参阅导出为 CSV） |
| Live | 自动刷新列表，并显示距下次刷新的倒计时；旁边的按钮可立即刷新 |
| Range | Last day、Last 7 days、Last 30 days、Last 90 days 或自定义日期 |
标题会显示当前范围和筛选条件下的事件数量。每个范围最多加载最近的 500 个事件。
事件状态
| 状态标记 | 含义 |
|---|---|
| Confirmed unlocked | 门控制器已确认继电器释放，门确实已解锁 |
| Unlocked | 报告解锁成功 |
| Admin Unlocked | 管理员从 Performance Hub 触发了解锁（管理员覆盖）。命令一经发出即会记录 |
| Denied | 请求被拒绝，请查看 Reason 列（所有原因） |
| Pending / Request received | 请求仍在处理中（暂时状态，通常在几秒钟内完成） |
| Timed out | 解锁命令已发送，但控制器未及时确认，通常是门处的网络连接问题 |
| Failed | 由于出错，解锁无法完成 |
| Locked by staff | 自动解锁时间表使门保持打开时，员工使用了 Lock now。这是时间表事件，而不是解锁尝试 |
| Schedule resumed | 自动解锁时间表重新接管，原因是到了其下一次变更时间，或员工按下了 Resume schedule。这是时间表事件，而不是解锁尝试 |
每一行显示时间戳、状态、门、人员、与门的距离和命令延迟（如有），对于被拒绝的事件还会显示拒绝原因。
未记录到访问
图 3：No visit recorded 视图
将 View 设置为 No visit recorded，可列出由管理员或集成添加的一次性 Access Time Windows，其中人员在时间窗口内（包括任何宽限期）从未解锁过门。列：Person、Scheduled period、Source / partner、Status。记录保留约 13 个月。
例如，办公室可以查看哪些拥有一次性时间窗口的承包商始终没有到场。
Access Policy 归因
由策略授权的事件会注明具名策略以及匹配的受众、目标和时间表。按时间表匹配的事件还可以包含当前生效的具体开始和结束时间。
管理员拥有的和集成拥有的 Access Time Windows 保留各自的归因路径（admin_time_window 和 source_time_window）；它们不会被重新标记为 Access Policies。策略拒绝会区分目标不匹配、受众不匹配和时间表未生效。未来的时段在已知时会使用带有结构化可用性信息的 outside_access_time_window。
事件详细信息
点击任意行即可打开 Access Details 对话框。
图 4：会员解锁的 Access Details 对话框
标题显示门、其位置、结果、适用时的 Admin override 徽章，以及被拒绝时的拒绝原因。在有数据时显示以下字段：
| 字段 | 说明 |
|---|---|
| Date / Time | 尝试发生的时间 |
| Coordinates | 手机报告的位置及 GPS 精度（±N m）；可复制 |
| Door / Gate | 门名称和位置 |
| Person 或 Admin | 尝试者；管理员解锁会显示管理员的账户 |
| Device | 使用的手机或设备 |
| IP Address | 发出请求的 IP；可复制 |
| Hold time | 门保持解锁的时长 |
| Distance from door | 与地理围栏中心的计算距离 |
| Event ID / Command ID | 可复制的标识符，用于向支持人员上报问题 |
| Latency | 控制器响应命令所用的时间 |
| Authorization source | Access Policy、永久授权、管理员时间窗口或集成时间窗口 |
| Policy | 策略 ID/名称，以及匹配的受众、门/访问范围目标和 Anytime/Scheduled 模式 |
| Window / Source ID | 当前生效的计划时间窗口或来源时间窗口的有界归因 |
| Active from / to | 用于时间窗口判定的具体时段（Unix 秒）；结束时间不包含在内 |
Unlock Location 会在地图上标出报告的坐标，并提供 Open in Google Maps 链接。没有坐标时，您会看到 “No location captured — unlocked from the Performance Hub.”（管理员覆盖）或 “No location data was reported for this unlock attempt.”
导出为 CSV
点击 导出 CSV 可下载当前筛选出的事件。文件包含身份、门、结果、拒绝、控制器、集成以及策略/时间窗口归因字段。筛选后的列表为空时，该按钮不可用。在 No visit recorded 视图中，导出 CSV 会改为下载该列表。
提示
- Doors 选项卡上的 Recent activity 卡片是进入此日志最近 24 小时记录的快捷方式，点击其中的事件会直接跳转到此处的对应事件。
- 要调查会员投诉？使用 State 或 Result 标记显示被拒绝的尝试，搜索其姓名并查看原因，然后参阅故障排除了解每种原因的解决方法。
- 对于与策略有关的投诉，请确认策略名称及其 Who/Where/When。对于集成时间窗口，还请检查来源数据的时效和
scope_key映射。 - 某扇门上集中出现 Timed out 事件，通常意味着该门的控制器存在网络问题，请在 Doors 选项卡中检查其状态。
- 您的人工智能代理可以通过 MCP 读取门禁事件，例如用于为每位访客显示的办公室大堂欢迎屏。门禁事件包含用户 ID，而不包含姓名或出生日期。