Cloudflare 测量每个连接的以下指标。
| 指标 | 名称 | 示例 | 单位 |
|---|---|---|---|
| count | 总事件数 | 1000 |
计数 |
| bytesIngress | 入站字节总和 | 1000 |
总和 |
| bytesEgress | 出站字节总和 | 1000 |
总和 |
| durationAvg | 平均连接持续时间 | 1.0 |
时间（毫秒） |
| durationMedian | 中位数连接持续时间 | 1.0 |
时间（毫秒） |
| duration90th | 第 90 百分位连接持续时间 | 1.0 |
时间（毫秒） |
| duration99th | 第 99 百分位连接持续时间 | 1.0 |
时间（毫秒） |
您可以通过以下维度进一步划分您的分析。
| 维度 | 名称 | 示例 |
|---|---|---|
| event | 连接事件 | connect, progress, disconnect, originError, clientFiltered |
| appID | 应用程序 ID | 40d67c87c6cd4b889a4fd57805225e85 |
| coloName | 数据中心名称 | SFO |
| ipVersion | 客户端使用的 IP 版本 | 4, 6 |
使用以下运算符来过滤数据。
| 运算符 | 名称 | URL 编码 |
|---|---|---|
== |
等于 | %3D%3D |
!= |
不等于 | !%3D |
> |
大于 | %3E |
< |
小于 | %3C |
>= |
大于或等于 | %3E%3D |
<= |
小于或等于 | %3C%3D |
使用 OR 和 AND 布尔逻辑组合筛选器：
-
在所有表达式中，
AND的优先级高于OR。 -
OR运算符使用逗号,或前后带空格的OR关键字定义。 -
AND运算符使用分号;或前后带空格的AND关键字定义。
/api/v4/zones/{zone_id}/spectrum/analytics/events/summary?metrics=METRICS&dimensions=DIMENSIONS&filters=FILTERS&since=FROM_TS&sort=SORT&until=TO_TS&limit=LIMIT
/api/v4/zones/{zone_id}/spectrum/analytics/events/bytime?metrics=METRICS&dimensions=DIMENSIONS&filters=FILTERS&since=FROM_TS&sort=SORT&until=TO_TS&limit=LIMIT- METRICS 是计算的一个或多个指标（如 count）
- DIMENSIONS 可用于按给定属性细分数据
- FILTERS 用于按一个或多个维度过滤行（参见下面的“过滤器”部分）
- SORT 是结果集的排序顺序；排序字段必须包含在 METRICS 或 DIMENSIONS 中
- TO_TS 是要查询的时间区间的结束时间，默认为当前时间
- FROM_TS 是要查询的时间区间的开始时间，默认为 TO_TS - 6 小时
- STEP 用于在使用端点时选择时间序列分辨率：
- auto 或省略 - 选择最适合时间区间的时间步长
- year
- quarter
- month
- week
- day
- hour
Required API token permissions
At least one of the following token permissions is required:Analytics Read
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/spectrum/analytics/events/summary" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"有关 API 请求的更多示例，请参考 Spectrum API 文档。