流量与统计

四个接口分别对应大盘上的四类图。时间字段统一是毫秒时间戳

流量总览

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 数组元素含 timerate_blocksconn_blocks 等。适合画「攻击趋势」图;要看具体是谁被拦了,用防护日志

轮询频率

统计数据按分钟粒度聚合,秒级轮询拿不到更新的数,只会更快撞上频率限制。建议 1 分钟以上。