调查示例
本页内容
这些示例展示了如何使用审计日志回答常见问题。每个示例都给出问题、要使用的筛选器和点击操作,以及需要关注的内容。相同的步骤适用于任何类型的场所,请根据您自己的问题调整筛选器。
快速参考
**位置:**Settings(左下角的齿轮图标)→ 审计日志
**谁可以使用:**您需要在组织中拥有包含审计日志和 Identity & Access Management 的角色,例如 Organisation Administrator。请参阅谁可以使用审计日志。
**用途:**从一个问题出发,找到能够回答它的请求
谁解锁了前门入口?
健身房或休闲中心:前门入口被远程解锁,值班经理想知道是谁解锁的以及原因。
- 在 Logs 选项卡上,点击 Endpoint,输入
/api/door-gate-access/*,然后点击 Apply。列表只显示 Door & Gate Access 请求。 - 将 Range 设置为涵盖解锁发生的时间。
- 点击端点以
/front-entrance/unlock结尾的请求。


图 1:所有门的请求,前门入口解锁请求已打开
**需要关注的内容:**User 显示解锁门的人员,此处为 oscar.tran@example.com。Request POST Body 显示其给出的原因 "Member forgot access card",Response Body 显示门已解锁。
**下一步:**查看该门在 Door & Gate Access 访问日志中的独立记录,其中记录了该门的每一次解锁尝试,包括来自移动应用的尝试。
为什么某位员工无法更改他人的角色?
一家理疗诊所:一位协调员尝试为同事分配新角色,但没有成功。
- 在 Logs 选项卡上,点击 Status 并选择 403 Forbidden。
- 点击角色更改时间的 403 Forbidden 请求。
- 在 AI Error Summary 中,点击 Generate summary。


图 2:摘要说明了角色更改被拒绝的原因
**需要关注的内容:**摘要指出此人 "does not have permission to assign that role"。将其与 Response Body 进行核对,后者显示 "You don't have permission to assign this role."。Request POST Body 显示其尝试分配的角色。
**下一步:**请 Organisation Administrator 进行更改,或检查此人的角色。请参阅更改用户的角色和角色模板。
我们的预订集成在夜间停止了同步
水上运动中心或市政设施:来自预订系统的签到记录在夜间不再出现。
- 在 Logs 选项卡上,点击 Endpoint,输入
/partner/v1/*,然后点击 Apply。 - 将 Range 设置为 Last 24 hours。
- 查看每一行开头的状态,然后点击失败的请求阅读其 Response Body。
**需要关注的内容:**来自 integrations@example.org、带有 api-key 标记的请求。此处列表显示 429 Too Many Requests(集成在短时间内发送了过多请求)和 503 Service Unavailable。记下失败开始的时间,以及之后是否有成功的请求。
下一步:点击导出 CSV,并将文件发送给集成合作伙伴,以便对方检查其一侧的情况。请参阅导出日志和 Partner API 错误页面。
Webhook 未能保存
咖啡馆、门店或酒店餐饮场所:一位经理设置了一个 Webhook,用于将访客详细信息发送到另一个系统,但未能保存。
- 在 Logs 选项卡上,点击 Email 并输入该经理的完整电子邮件地址,此处为 leo.hargreaves@example.com。
- 找到经理保存 Webhook 时发出的两个 POST 请求:同一端点上的一个 400 Bad Request 和一个 201 Created。
- 点击 400 Bad Request,然后点击几分钟后的 201 Created,并对两者进行比较。
**需要关注的内容:**400 的 Response Body 显示 "url must start with https://"。在其 Request POST Body 中,地址开头没有 https://。在 201 中,经理已添加了 https://,Webhook 已保存。
**下一步:**对于失败的请求,点击 Generate summary 获取通俗易懂的解释。请参阅 AI Error Summary。
即将离职的员工上周做了什么?
办公室或联合办公场所:在一位员工离职之前,其经理希望获得此人近期活动的记录。
- 在 Logs 选项卡上,点击 Email 并输入此人的完整电子邮件地址。
- 将 Range 设置为 Last 7 days。
- 滚动到列表底部,以加载所有请求。导出只包含已加载的行。
- 点击导出 CSV,然后点击 Export。
**需要关注的内容:**更改操作而非读取操作。依次将 Method 设置为 POST、PUT、PATCH 或 DELETE,查看创建、更改或删除内容的请求。对于任何意外的情况,打开该请求并阅读其 Request POST Body。
**下一步:**此人离职时,移除其访问权限。请参阅移除用户。按照您组织的政策存储 CSV 文件。
哪个场所的失败请求最多?
多场所运营商:昨天有多个场所报告了问题,总部想知道应从哪里着手。
- 在仪表板选项卡上,将 Window 设置为涵盖当天。
- 在 Errors Over Time 中,点击错误最多的时间段。Logs 选项卡会打开,显示该时间段的失败请求。
- 点击设施,依次选择每个场所,并比较各场所的失败请求数量。
**需要关注的内容:**失败次数远多于其他场所的场所,或集中在某一个端点上的失败。打开其中几个请求,阅读 Response Body 或点击 Generate summary。
**下一步:**有关其他图表,请参阅仪表板;有关您组织中的场所,请参阅设施。