指标
Metrics 页面(侧边栏 > Metrics)为您提供 API 使用情况的深度分析视图。它展示了您的整体 outcome 分布,并按 API key、client IP 或目标域名细分流量。
如需查看实时汇总卡片和时间线图表(Concurrency、Requests、Bytes、Response Time),请使用 Dashboard Overview 页面。
Filters
页面上方有两个控制项:API key 选择器和时间间隔选择器。
Key Filter
使用 API Key 下拉菜单将页面范围限定为特定 key。仅显示您访问权限范围内的 key:个人 key、您管理的组织 key 或通过团队共享的 key。
Interval Selector
使用时间间隔按钮控制时间窗口:
| 按钮 | 窗口 |
|---|---|
| 1M | 最近 1 分钟 |
| 5M | 最近 5 分钟 |
| 30M | 最近 30 分钟 |
| 1H | 最近 1 小时 |
| 6H | 最近 6 小时 |
| 1D | 最近 24 小时 |
环形图和表格都会根据您的选择进行更新。
Outcome Distribution
顶部的环形图展示了所选时间间隔内的成功/错误细分。将鼠标悬停在任何扇区上可查看确切的 request 数量和百分比。利用它可以快速发现成功率的突然下降是否与特定的 outcome 类别相关联。
Outcome Types
每个 API request 都会被精确归类为一种 outcome。只有 success 会计入您的计费额度。
| Outcome | 层级 | 含义 |
|---|---|---|
success |
n/a | request 成功返回了有效的 response。在没有 validate 规则的情况下,这意味着 HTTP 200。如果您发送了 validate 规则,则您的规则接受的任何 response 都算作成功,无论 HTTP 状态如何。 |
application_error |
target | 目标返回了 HTTP 200,但 response body 包含错误字段。 |
application_fail |
target | 目标返回了您的 validate 规则不接受的非 2xx 状态,或者根本没有返回 response。 |
client_error |
caller | 您的 request 在离开 FourA 之前被拒绝:参数错误、proxy 值格式错误,或者 URL 解析为私有/保留 IP(SSRF 防护)。 |
rate_limit |
FourA | request 被您的 RPM 或并发限制拒绝。请参阅 Rate Limits。 |
service_error |
FourA | 后端返回了 5xx,或者回复了我们无法解析的 body。 |
service_fail |
FourA | 网络故障:超时、连接被拒绝、DNS 错误、客户端断开连接。 |
layer 列说明了责任方:target 表示您调用的网站,caller 表示您的 request 有误,FourA 表示我们无法处理该请求。
如果您使用 validate.status.accept 来允许特定的非 200 代码(例如 [200, 403]),这些 response 将作为 success 返回,而不是 application_fail。分类遵循引擎对您规则的判定结果,而非原始 HTTP 代码。
有关完整分类及其与计费的对应关系,请参阅 Request Outcomes。
Multi-View Usage Table
在环形图下方,一个使用情况表通过三个视图标签页细分您的流量:
| 标签页 | 数据分组依据 |
|---|---|
| API Key | 您的每个 API key |
| Client IP | 发起 request 的源 IP 地址 |
| Domain | 您 request 中的目标域名 |
每个标签页右侧支持四个范围标签(scope chips),用于更改显示的列:
| 范围 | 显示内容 |
|---|---|
| Bandwidth | Request 数量、流入字节数、流出字节数 |
| Response Time | Request 数量、最小、平均和最大延迟 |
| Concurrency | Request 数量以及并发 request 数量(仅限 API Key 视图) |
| Outcomes | Request 数量以及每个 outcome 的细分 |
Related
- Dashboard Overview:实时统计数据和时间线图表
- Request Outcomes:详细解释的七个 outcome 值
- API Errors:错误如何通过网络返回