查找请求

本页内容

Logs 选项卡列出您组织中发出的请求，最新的排在最前。使用顶部的筛选器将列表缩小到某一个人、某一个 IP 地址、Performance Hub 的某一部分或某一类结果，然后点击某个请求查看其详细信息。

快速参考

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

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

**用途：**找出某个问题背后的请求，例如谁更改了某项内容，或某项操作为何失败

Logs 选项卡，顶部是筛选栏，左侧是请求列表，右侧是所选请求的详细信息

图 1：Logs 选项卡：顶部是筛选器，左侧是匹配的请求，右侧是所选请求

Logs 选项卡

筛选栏：顶部的筛选器，右侧是 Live、刷新和导出 CSV。
**列表：**匹配的请求，最新的排在最前。列表上方显示 "Viewing logs for 1 organisation"（或您可以查看的组织数量）。每一行显示状态代码、方法、来源标记、日期和时间、端点、用户的电子邮件地址以及以毫秒为单位的响应时间。
**详细信息：**您所选的请求。请参阅阅读日志条目。

滚动时，列表会加载更多请求。列表末尾会显示匹配的请求数量，例如 "End of results · 5 logs"。

筛选列表

点击筛选栏中的某个筛选器，例如 Endpoint。
选择一个选项或输入一个值。例如，在 Endpoint 中输入 /api/door-gate-access/*，然后点击 Apply。
筛选器会显示您选择的值，列表随之更新。添加更多筛选器可进一步缩小范围：请求必须匹配所有筛选器才会显示。
要移除某个筛选器，请点击其上的 ×。要全部移除，请点击 Clear，该按钮在设置了任意筛选器后出现。

图 2：筛选栏：Range、Email、IP、Endpoint、Org、设施、Method 和 Status，然后是 Live、刷新和导出 CSV

筛选器	匹配内容
Range	请求发出的时间。默认为 Last 24 hours。请参阅 Range。
Email	用户的完整电子邮件地址，例如 `priya.shah@example.com`。输入时可能会提示地址。
IP	请求来源的完整 IP 地址，例如 `203.0.113.140`
Endpoint	请求所针对的 Performance Hub 部分。路径的任意部分均可匹配，并且可以使用 `*` 通配符。请参阅端点与通配符。
Org	某一个组织，或 Any org。当您有权访问至少一个组织时显示。
设施	某一个设施，或任意设施。当您有权访问至少一个设施时显示。
Method	GET、POST、PUT、PATCH 或 DELETE
Status	响应状态。请参阅 Status。

Email 和 IP 需要完整的值

Email 和 IP 只查找完全匹配的结果。请输入完整的电子邮件地址（例如 ruby.castellano@example.com）或完整的 IP 地址。地址的一部分（例如 ruby 或 203.0.113）找不到任何结果。

要在不知道完整地址的情况下查找某个人，请使用仪表板上的 Top Users，或打开此人的某个请求，从 User 字段中复制地址。

范围

点击 Range 选择要回溯的时间范围。

**预设：**Last 15 minutes、Last hour、Last 12 hours、Last 24 hours、Last 7 days、Last 30 days 和 Last 90 days。
**日期：**在双月日历上选择开始日期和结束日期，然后点击 Apply。点击 Cancel 可关闭菜单而不更改范围。无法选择 90 天以前的日期。

菜单底部的说明指出日志的保留时长："Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)."

图 3：Range：选择预设或在日历上选择日期。说明显示日志的保留时长

端点与通配符

端点是请求发送到的路径，例如 /api/door-gate-access/doors/front-entrance/unlock。它表明请求所针对的 Performance Hub 部分。

不使用 * 时，路径的任意部分均可匹配。例如，unlock 会找到路径中包含 "unlock" 的所有请求。
使用 * 时，星号之间的每一段都必须出现在路径中。例如，/api/door-gate-access/* 会找到所有 Door & Gate Access 请求，/partner/v1/* 会找到来自使用 Partner API 的集成的所有请求。

打开的 Endpoint 筛选器，其中已输入 /api/door-gate-access/*，并显示 Cancel 和 Apply 按钮

图 4：Endpoint 接受 * 通配符，例如查找所有门的请求

按 /api/door-gate-access/* 筛选后的 Logs 选项卡，列出五个门的请求，第一个已打开

图 5：按端点模式筛选后的列表

不确定该使用哪个端点？请打开一个您了解的请求（例如您自己解锁某扇门的请求），然后从详细信息中复制其端点的开头部分。

状态

点击 Status 按响应状态筛选。在 Search… 中输入可快速查找状态，例如 "403"。选择 Any 可显示所有状态。

状态会连同其名称一起列出，例如 200 OK、201 Created、400 Bad Request、401 Unauthorised、403 Forbidden、404 Not Found、409 Conflict、429 Too Many Requests、500 Server Error 和 503 Service Unavailable。有关它们的含义，请参阅状态代码。