流量与统计
四个接口分别对应大盘上的四类图。时间字段统一是毫秒时间戳。
流量总览
GET/api/me/dashboard/traffic
| 参数 | 说明 |
|---|---|
range | 时间范围,如 today |
| 字段 | 说明 |
|---|---|
start end | 统计区间(毫秒时间戳) |
bucketMs | 每个数据点的时间粒度(毫秒) |
trend | 数据点数组,元素含 time bandwidth requests traffic bytes_in bytes_out |
totalBytes | 区间内总流量 |
cacheHitRate | 缓存命中率 |
originRequestRate | 回源率 |
topDomainsByTraffic | 按流量排序的域名 |
topNodes | 按流量排序的节点 |
画图时请用响应里的
bucketMs 作为 X 轴步长,不要写死 5 分钟 —— 区间越长粒度越粗,写死会让长区间的图被拉扁。带宽趋势
GET/api/me/dashboard/trend
只要趋势曲线时用它,比 traffic 轻。返回 trend 数组:
{
"ok": true,
"trend": [
{"time": 1788451200000, "bandwidth": 39574.72, "requests": 69, "traffic": 1484052}
]
}
热门排行
GET/api/me/dashboard/top
返回 topDomains 等排行,元素形如 {"name": "www.example.com", "count": 85}。
GET/api/me/dashboard/top-ips
按来源 IP 的请求量排行。
攻击统计
GET/api/me/stats/attack
按时间返回各类防护动作的计数,data 数组元素含 time、rate_blocks、conn_blocks 等。适合画「攻击趋势」图;要看具体是谁被拦了,用防护日志。
轮询频率
统计数据按分钟粒度聚合,秒级轮询拿不到更新的数,只会更快撞上频率限制。建议 1 分钟以上。