统计接口(新版)
更新时间:2023-08-17
这部分接口在文档统计接口中有详细说明。
api.QueryCondition
结构包含了最基本的查询条件,如下:
参数 | 类型 | 说明 |
---|---|---|
StartTime | string | 查询的时间范围起始值,默认为endTime前推24小时。格式为UTC时间字符串,如:"2019-09-01T07:12:00Z"。 |
EndTime | string | 查询的时间范围结束值,默认为当前时间。时间跨度最长90天,时间格式和StartTime一样。 |
Period | int | 查询结果的粒度,单位秒,可选值为60,300,3600,86400;默认为300,uv 默认3600(选60s的时间粒度时建议StartTime和EndTime区间跨度建议选择0.5到1h,否则可能会因为数据量太大无法正常返回) |
KeyType | int | 标识key的内容,0=>域名,1=>用户id,2=>tag,默认0。 |
Key | []string | 域名、用户Id或Tag。 |
GroupBy | string | 返回结果聚合粒度,key => 根据key聚合,每个key的每个时间段都对应一组数据;空 => 返回整体结果,最后的key是total 。 |
metric
表示查询的统计数据类型,如下,接口具体返回结果的格式在对应的函数中可以看到。
metric | 函数 | 接口类型 | 额外参数 |
---|---|---|---|
avg_speed | GetAvgSpeed | 查询平均速率 | 无。 |
avg_speed_region | GetAvgSpeedByRegion | 客户端访问分布查询平均速率 | prov和isp。prov是查询的省份全拼,默认为空,查询全国数据。isp是查询的运营商代码,默认为空,查询所有运营商数据。 |
pv | GetPv | pv/qps查询 | level,查询边缘节点或者中心节点pv。可填写"all"或"edge"或者"internal",默认为“all”。 |
pv_src | GetSrcPv | 回源pv/qps查询 | 无。 |
pv_region | GetPvByRegion | 查询pv/qps(分客户端访问分布) | prov和isp。prov是查询的省份全拼,默认为空,查询全国数据。isp是查询的运营商代码,默认为空,查询所有运营商数据。 |
uv | GetUv | uv查询 | 无。 |
flow | GetFlow | 查询流量、带宽 | level,查询边缘节点或者中心节点带宽。可填写"all"或"edge"或"internal",默认为"all"。 |
flow_protocol | GetFlowByProtocol | 查询流量、带宽(分协议) | protocol,查询http或https的流量、带宽, 取值"http", "https"或者 "all",默认"all"。 |
flow_region | GetFlowByRegion | 查询流量、带宽(分客户端访问分布) | prov和isp。prov是查询的省份全拼,默认为空,查询全国数据。isp是查询的运营商代码,默认为空,查询所有运营商数据。 |
src_flow | GetSrcFlow | 查询回源流量、回源带宽 | 无。 |
real_hit | GetRealHit | 字节命中率查询 | 无。 |
pv_hit | GetPvHit | 请求命中率查询 | 无。 |
httpcode | GetHttpCode | 状态码统计查询 | 无。 |
src_httpcode | GetSrcHttpCode | 回源状态码查询 | 无。 |
httpcode_region | GetHttpCodeByRegion | 状态码统计查询(分客户端访问分布) | prov和isp。prov是查询的省份全拼,默认为空,查询全国数据。isp是查询的运营商代码,默认为空,查询所有运营商数据。 |
top_urls | GetTopNUrls | TopN urls | extra,查询指定http状态码的记录,默认值: ""。 |
top_referers | GetTopNReferers | TopN referers | extra,查询指定http状态码的记录,默认值: ""。 |
top_domains | GetTopNDomains | TopN domains | extra,查询指定http状态码的记录,默认值: ""。 |
error | GetError | cdn错误码分类统计查询 | 无。 |