指标
Metrics 页面(侧边栏 > Metrics)为您提供 API 使用情况的深入分析视图。它显示您的整体结果分布,并按 API 密钥、客户端 IP 或目标域名细分流量。
有关实时摘要卡片和时间线图表(并发、请求数、字节数、响应时间、预算),请参阅 Dashboard Overview 页面。
Filters
页面顶部有两个控件:API 密钥选择器和时间间隔选择器。
Key Filter
使用 API 密钥下拉菜单将页面范围限定在特定密钥。仅显示您访问权限范围内的密钥:个人密钥、您管理的组织密钥或通过团队共享的密钥。
Interval Selector
使用时间间隔按钮控制时间窗口:
| Button | Window |
|---|---|
| 1M | 过去 1 分钟 |
| 5M | 过去 5 分钟 |
| 30M | 过去 30 分钟 |
| 1H | 过去 1 小时 |
| 6H | 过去 6 小时 |
| 1D | 过去 24 小时 |
环形图和表格都遵循您的选择。
Outcome Distribution
顶部的环形图显示所选时间间隔的成功/错误分类。将鼠标悬停在任何切片上即可查看确切的请求计数和百分比。使用它可快速发现成功率骤降是否与特定的结果类别一致。
Outcome Types
每个 API 请求都严格归类为一个结果。只有 success 会计入您的计费配额。
| Outcome | Layer | Meaning |
|---|---|---|
success |
n/a | 请求传递了有效响应。如果没有 validate 规则,这意味着 HTTP 200。如果您发送了 validate 规则,您的规则接受的任何响应都视为成功,无论 HTTP 状态如何。 |
application_error |
target | 目标返回 HTTP 200,但响应主体包含错误字段。 |
application_fail |
target | 目标返回您的 validate 规则未接受的非 2xx 状态,或根本没有响应。 |
client_error |
caller | 您的请求在离开 FourA 之前被拒绝:参数错误、代理值格式错误或解析为私有/保留 IP 的 URL(SSRF 保护)。 |
rate_limit |
FourA | 请求被您的 RPM 或并发限制拒绝。请参阅 Rate Limits。 |
service_error |
FourA | 后端返回 5xx,或回复我们无法解析的主体。 |
service_fail |
FourA | 网络故障:超时、连接被拒绝、DNS 错误、客户端断开连接。 |
Layer 列告诉您责任方:target 表示您调用的站点,caller 表示您的请求有误,FourA 表示我们无法处理它。
如果您使用 validate.status.accept 允许特定的非 200 代码(例如 [200, 403]),这些响应将作为 success 而不是 application_fail 返回。分类遵循引擎对您的规则的判定,而不是原始 HTTP 代码。
有关完整的分类及其映射到计费的方式,请参阅 Request Outcomes。
Multi-View Usage Table
圆环图下方有一个使用情况表格,通过三个视图选项卡细分您的流量:
| 选项卡 | 数据分组方式 |
|---|---|
| API Key | 您的每个 API 密钥 |
| Client IP | 发起请求的源 IP 地址 |
| Domain | 请求中的目标域名 |
每个选项卡右侧支持作用域标签,可更改显示的列:
| 作用域 | 显示内容 |
|---|---|
| Bandwidth | 请求数、输入字节数、输出字节数 |
| Response Time | 请求数,以及最小、平均和最大延迟 |
| Concurrency | 请求数加上并发请求数(仅限 API Key 视图) |
| Outcomes | 请求数及每个结果的细分 |
| Budget | 请求数和花费的点数,按产品(Single、Proxy、Browser)细分 |
Budget 作用域读取 API 在每个请求上写入的 credits 指标(请参阅 Response Headers)。总和是原始计量支出;计费仅将 success 结果计入您的套餐。
单击列标题可按该列排序。排序状态在页面加载之间按表格持久化保存。使用 Ctrl 或 Cmd 单击标题可重置。
相关内容
- Dashboard Overview:实时统计数据和时间线图表
- Request Outcomes:七种结果值的详细解释
- Response Headers:点数来源
- API Errors:错误如何通过网络返回