活动日志
Activity Log 实时显示您最近的 API request。使用它来调试单个 request,检查 response code,并验证您的集成是否正常工作。
您将看到的内容
该日志显示过去一小时内发送的 request,最新生成的排在最上方。每个条目包含:
| 字段 | 描述 |
|---|---|
| 时间戳 | 发送 request 的时间 |
| Method | 发送到目标服务器的 HTTP method(GET、POST 等) |
| Route | 使用了哪个 FourA endpoint(single、proxy 或 browser) |
| Domain | 从 request URL 中提取的目标域名 |
| Status | 目标服务器返回的 HTTP status code |
| App Status | response body 中返回的应用级状态 |
| Outcome | request 分类(success、client_error、rate_limit 等) |
| Duration | 以毫秒为单位的总 response 时间 |
| Bytes In | request payload 大小 |
| Bytes Out | response payload 大小 |
| Key Name | 使用了哪个 API key |
| Client IP | 发送 request 的客户端 IP 地址 |
过滤
通过三个控件可以缩小日志范围。
按 API Key
使用 API key 下拉菜单显示来自特定 key 的 request。下拉菜单中仅显示您访问权限范围内的 key。
按产品
使用 single / proxy / browser 选择器过滤到单个 endpoint。当您需要将仅限浏览器(browser-only)的失败与 single request 分开调试时,这非常有用。
按限制数量
Activity Log 默认显示 50 个条目。使用数量限制选择器更改显示的条目数:
| 限制数量 | 说明 |
|---|---|
| 10 | 快速浏览 |
| 50 | 默认 |
| 100 | 扩展视图 |
| 200 | 最大值 |
所有条目均来自过去一小时。如需历史数据,请使用 Metrics 部分,该部分汇总了数天和数周的数据。
打开 Request
点击任意行可打开详情对话框,其中包含完整的 request 和 response payload 预览。该对话框显示:
- Meta 网格: 时间戳、key、HTTP status、app status、outcome、duration 以及 request 的
X-Foura-Request-Id。 - Request: 发送的确切 body 的美化 JSON,带有“复制”按钮。
- Response: meta 条以及 body 预览,并在适用时带有 truncated 和 binary 徽章。
Payload 保留 24 小时,每个 API key 最多保留最新的 200 个。超过该时限的行仅显示行数据,不提供详情对话框。
Body 面板消息
根据发生的情况,body 面板会使用不同的占位符文本:
| 消息 | 含义 |
|---|---|
(no body — the request failed: <error>) |
在目标服务器返回 body 之前,request 发生错误 |
(no body captured) |
Payload 已过期或未存储 |
(empty body — the server returned 0 bytes) |
目标服务器返回了真正的空 response |
在 Playground 中打开
详情对话框中有一个 Open in Playground 按钮。点击它可将归档的 request 和归档的 response 同时加载到 Playground 表单中。在其中,您可以微调参数并针对实时 API 进行重放,或者仅检查返回的内容而无需重新运行 request。
对于不可重放的 payload(超大 request 存根和非 API 路由),该按钮将被禁用,并显示提示说明原因。
使用 Request ID
每个 API response 都包含一个 X-Foura-Request-Id header。在您端记录它,您就可以将其粘贴到支持工单中,以便在 Activity Log 中指向确切的 request。该 ID 与此对话框中使用的 ID 相同,并且与 API 返回的 X-Foura-Request-Id 一致。有关详细信息,请参阅 API Endpoints 参考文档。
相关内容
- Metrics and Analytics:更长时间段内的汇总性能数据
- Playground:从 Activity 重放 request
- API Endpoints:request 和 response 的结构,包括 request ID header
- Troubleshooting:常见问题及解决方案