审计日志

审计日志记录了您组织中向 Performance Hub 发出的请求。它涵盖人员在浏览器或应用中使用 Performance Hub 时发出的请求，以及来自已连接工具（例如 API 密钥、通过 MCP 连接的 AI 代理和 Model Router）的请求。无论您的场所是办公室、门店、咖啡馆、场馆、诊所、校园还是健身房，都可以用它来回答诸如谁解锁了某扇门、某项更改为何没有保存，或某个集成何时停止工作等问题。

快速参考

**位置：**Settings（左下角的齿轮图标）→ 审计日志

**谁可以使用：**您需要在组织中拥有包含审计日志和 Identity & Access Management 的角色，例如 Organisation Administrator。请参阅谁可以使用审计日志。

**用途：**查看谁在 Performance Hub 中执行了什么操作，并找出请求失败的原因

图 1：审计日志仪表板：时间窗口、关键指标和请求时间线

记录哪些内容

每条日志条目对应向 Performance Hub 发出的一个请求。它显示：

• 请求由谁发出：用户的电子邮件地址。
• **来自何处：**IP 地址，以及发送请求的浏览器或工具。
• **调用了什么：**方法（例如 GET 用于读取，POST 用于创建）和端点，即请求所针对的 Performance Hub 部分，例如 /api/door-gate-access/doors/front-entrance/unlock。
• **结果：**响应状态，例如 200 表示成功，403 表示该人员没有权限。
• 耗时多久，以毫秒为单位。
• **来源：**来源标记，例如 web 表示人员在使用 Performance Hub，api-key 表示集成。请参阅来源标记。

对于最近的请求，日志条目还会保存发送的内容和返回的内容。请参阅阅读日志条目。

两个选项卡

谁可以使用审计日志

您需要在组织中拥有包含审计日志和 Identity & Access Management 的角色，例如 Organisation Administrator。如果您在设置菜单中看不到审计日志，说明您的角色不包含它。

• **您能看到哪些组织：**您的角色同时包含审计日志和 Identity & Access Management 的组织。Logs 选项卡会显示组织数量，例如 "Viewing logs for 1 organisation"。
• **角色模板：**Organisation Administrator 模板包含审计日志。Site Manager 和 Site Owner 模板不包含。请参阅角色模板。
• **自定义角色：**要让自定义角色使用审计日志，请在其模块访问中同时包含审计日志和 Identity & Access Management。请参阅访问范围与模块访问。

审计日志会显示人员的电子邮件地址、IP 地址及其发送的内容，因此请仅授予需要的人员。

日志保留多久

审计日志保留期设定了审计日志的保留时长：每条日志条目保留 90 天，其完整的请求和响应负载保留 7 天。

Logs 选项卡上的 Range 菜单显示：

"审计日志保留 90 天。完整的请求和响应有效负载保留 7 天，之后将仅保留简短预览。需要更长的历史记录？请联系支持团队（将产生额外费用）。"

因此您可以回溯 90 天。在前 7 天内，日志条目保存完整的请求和响应。之后，较长的正文会被截断为简短预览。请参阅7 天后：预览。

您可以执行的操作

• 阅读仪表板：查看某个时间窗口内的请求量、错误率以及最繁忙的端点和用户。
• 查找请求：按时间范围、电子邮件地址、IP 地址、端点、组织、设施、方法和状态进行筛选，并共享筛选后的视图。
• 阅读日志条目：查看请求由谁发出、来自何处，以及发送和返回了什么。对于失败的请求，可获得以通俗语言表述的错误摘要。
• 导出日志：将已加载的日志下载为 CSV 文件。
• 参考调查示例：针对常见问题的分步解答，例如谁解锁了某扇门，或某个集成为何停止同步。
• 常见问题

相关页面

• 角色模板：哪些模板包含审计日志
• 访问范围与模块访问：为自定义角色授予审计日志
• Door & Gate Access：访问日志：每次门和闸门解锁尝试的独立记录