活动日志
活动日志实时显示您最近的 API request。使用它来调试单个 request,检查 response 状态码,并验证您的集成是否正常运行。
查看内容
日志显示过去一小时内的 request,最新的排在最前面。整行包含九列数据:
| 列 | 显示内容 |
|---|---|
| 时间 | request 发起的时间 |
| 密钥 | 使用的 API 密钥 |
| Request | 调用本身:彩色产品圆点 (single, proxy 或 browser),HTTP 方法和目标域名。按域名排序。 |
| 状态 | 单元格内包含两个值,由斜杠分隔:您调用 FourA 的 HTTP 状态,然后是目标返回的状态。破折号表示目标未响应。 |
| 结果 | request 分类 (Success,Client Error,Rate Limited 等) |
| 时长 | 总 response 时间,以毫秒为单位 |
| 字节 | 单元格内显示双向传输:向下箭头表示 request payload,向上箭头表示 response |
| 积分 | 调用消耗的积分 (请参阅 Response Headers) |
| 客户端 IP | 发起 request 的地址 |
单击任意列标题可按该列对表格排序,顺序依次为降序、升序和取消排序。按住 Ctrl 或 Cmd 键单击可重置为默认值 (最新优先)。
过滤
三个控件可用于筛选日志。
按 API 密钥
使用 API 密钥下拉菜单显示单个密钥的 request。下拉菜单中仅显示在您访问范围内的密钥。
按产品
使用 single / proxy / browser 选择器过滤单个 endpoint。当您希望将 browser 独有故障与 single request 分开调试时,这非常有用。
按限制
活动日志默认显示 50 条条目。使用限制选择器可更改显示的条目数量:
| 限制 | 说明 |
|---|---|
| 10 | 快速扫描 |
| 50 | 默认 |
| 100 | 扩展视图 |
| 200 | 最大值 |
所有条目均来自过去一小时。如需查看历史数据,请使用 Metrics 部分,它会汇总数天和数周的数据。
打开 Request
单击任意行可打开一个详情面板,其中包含完整的 request 和 response payload 预览。该面板在从行本身构建的元数据网格上打开,因此即使存储的 payload 已过期,它仍然有用:时间戳,密钥,HTTP 状态,应用状态,结果,时长,积分,proxy 以及 request 的 X-FourA-Request-Id。
在网格下方,每次显示一个窗格,通过选项卡选择:
| 选项卡 | 显示内容 |
|---|---|
| Request | 发送的确切 body 的格式化 JSON |
| Response headers | 目标返回的 header,并在选项卡上带有计数 |
| Response body | 存储的 body 预览,在适用时带有截断和二进制徽章 |
| 其他字段 | 引擎返回的除状态,时间,proxy 和 header 之外的任何其他内容。如果没有额外内容则隐藏。 |
Copy 按钮会复制当前打开的窗格。Payload 保留 24 小时,每个 API key 最多保留最近的 200 个。超过此时间的行仅显示行信息,不包含 payload。
Body 窗格消息
根据发生的情况,body 窗格会使用不同的占位符文本:
| 消息 | 含义 |
|---|---|
(no body — the request failed: <error>) |
请求在目标返回 body 前出错 |
(no body captured for this request) |
Payload 已过期或未存储 |
(empty body — the server returned 0 bytes) |
目标返回了真实的空响应 |
在 Playground 中打开
详情对话框有一个 Open in Playground 按钮。点击它可将已归档的 request 和 response 加载到 Playground 表单中。然后您可以调整参数并针对实时 API 重新运行,或仅检查返回的内容而不重新发送请求。
对于不可重放的 payload (超大的 request 存根和非 API 路由),该按钮将被禁用,并附有解释原因的提示。
使用 Request ID
每个 API response 都带有一个 X-Foura-Request-Id header。在您的一侧记录它,您可以将其粘贴到支持工单中,以指向 Activity Log 中确切的请求。该 ID 与此对话框中使用的 ID 相同,并与 API 返回的 X-Foura-Request-Id 匹配。有关详细信息,请参阅 Response Headers。
相关内容
- 指标与分析: 较长时期内的聚合性能数据
- Playground: 从 Activity 重放请求
- Response Headers: request ID 和额度的来源
- API Endpoints: Request 和 response 的结构
- 故障排除: 常见问题与解决方案