统计接口(新版)
接口
本接口用于查询用户或域名的统计指标信息。
Method | Path | 说明 |
---|---|---|
POST | /v2/stat/query | 所有统计数据的路径,不同的统计指标由post参数中的metric指定。 |
默认接口请求频率限制:30次/秒。
默认请求体(Request Body)
所有metric支持的参数以此进行扩展。
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
metric | 必选 | String | 示例:src_flow、flow、pv、pv_region、avg_speed等等。更多metric参数值请查看本页面中对应接口metric值。 |
endTime | 可选 | Timestamp | 查询的时间范围结束值,默认为当前时间,UTC时间 |
startTime | 可选 | Timestamp | 查询的时间范围起始值,默认为endTime前推24小时,UTC时间。60s查询粒度只能查询最近7天数据,300s粒度可查询最近90天数据,其他粒度可查询最近180天数据 |
period | 可选 | Long | 查询结果的粒度,单位秒,可选值为60、300、3600、86400,默认为300。uv 默认3600,topN查询最小3600。(选60s的时间粒度时建议startTime和endTime区间跨度建议选择0.5到1h,300s建议查询时间跨度在1天内,否则可能会因为数据量太大无法正常返回或返回数据粒度不正确) |
key_type | 可选 | Long | 标识key的内容,0=>域名,1=>用户id,2=>tag,默认0 |
key | 可选 | list<String> | 域名或用户Id或Tag,当查询key_type为tag时,key的格式为标签键或标签键:标签值。例如:标签键=默认项目,标签值=test,查询key参数key=["默认项目:test"]。当没有标签值时,key=["默认项目"] |
groupBy | 可选 | String | 返回结果聚合粒度,key => 根据key聚合, 空 => 返回整体结果 |
默认响应体(Response Body)
所有metric的响应结果以此扩展。
参数 | 类型 | 说明 |
---|---|---|
status | String | 正常返回的时候为"ok" |
details | list<Details> | list类型 |
count | Long | list的长度 |
Details 内容
参数 | 类型 | 说明 |
---|---|---|
timestamp | Timestamp | 时间点 UTC时间 |
key | String | 聚合粒度(groupBy):key => key,其他 => total |
... | Object | 扩展字段,metric对应的统计指标 |
平均速率相关接口
查询平均速率
metric:avg_speed
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
avgspeed | Long | 统计时间段内的平均速率 |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"avg_speed","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net","avgspeed": 1219463},
{"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net","avgspeed": 1289562}
],
"count": 2
}
客户端访问分布查询平均速率
metric:avg_speed_region
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
prov | 可选 | String | 查询的省份全拼,默认为空,查询全国数据。 |
isp | 可选 | String | 查询的运营商代码,默认为空,查询所有运营商数据。 |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
distribution | list<DistributionData> | 客户端访问分布数据 |
DistributionData内容
参数 | 类型 | 说明 |
---|---|---|
location | String | 客户端所在省份、地区 |
isp | String | 客户端所属运营商 |
avgspeed | Long | 统计时间段内的平均速率 |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"avg_speed_region","startTime":"2019-03-19T06:00:00Z","endTime":"2019-03-19T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key","prov":"beijing","isp":"ct"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"timestamp": "2019-03-19T06:00:00Z","key": "cdaa.wonter.net","distribution": [{"location": "北京","isp": "电信","avgspeed": 1683448}]},
{"timestamp": "2019-03-19T06:05:00Z","key": "cdaa.wonter.net","distribution": [{"location": "北京","isp": "电信","avgspeed": 1964874}]}
],
"count": 2
}
pv/qps相关接口
pv/qps查询
metric:pv
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
level | 可选 | String | 查询边缘节点或者中心节点pv。可填写"all"或"edge"或者"internal",默认为“all” |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
pv | Long | 统计时间段内的请求量 |
qps | Long | 统计时间段内的平均qps |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"pv","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key","level":"all"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"pv": 2145,"qps": 7,"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net"},
{"pv": 2950,"qps": 9,"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net"}
],
"count": 2
}
pv/qps https协议查询
metric:pv_protocol
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
protocol | 可选 | String | 查询指定协议的pv。可填写http、https、http3、all,默认all |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
pv | Long | 统计时间段内的请求量 |
qps | Long | 统计时间段内的平均qps |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"pv","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key","protocol":"https"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"pv": 2145,"qps": 7,"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net"},
{"pv": 2950,"qps": 9,"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net"}
],
"count": 2
}
回源pv/qps查询
metric:pv_src
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
pv | Long | 统计时间段内的回源请求量 |
qps | Long | 统计时间段内的平均qps |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"pv_src","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"pv": 0,"qps": 0,"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net"},
{"pv": 0,"qps": 0,"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net"}
],
"count": 2
}
查询pv/qps(分客户端访问分布)
metric: pv_region
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
prov | 可选 | String | 查询的省份全拼,默认为空,查询全国数据 |
isp | 可选 | String | 查询的运营商代码,默认为空,查询所有运营商数据 |
protocol | 可选 | String | 查询的协议,可填写http3、all,默认all |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
distribution | list<DistributionData> | 客户端访问分布数据 |
DistributionData内容
参数 | 类型 | 说明 |
---|---|---|
location | String | 客户端所在省份、地区 |
isp | String | 客户端所属运营商 |
pv | Long | 统计时间段内的请求量 |
qps | Long | 统计时间段内的平均qps |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"pv_region","startTime":"2019-03-19T06:00:00Z","endTime":"2019-03-19T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key","prov":"beijing","isp":"ct"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"timestamp": "2019-03-19T06:00:00Z","key": "cdaa.wonter.net","distribution": [{"location": "北京","isp": "电信","pv": 148,"qps": 0}]},
{"timestamp": "2019-03-19T06:05:00Z","key": "cdaa.wonter.net","distribution": [{"location": "北京","isp": "电信","pv": 142,"qps": 0}]}
],
"count": 2
}
uv查询
metric:uv
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
uv | Long | 统计时间段内的请求量 |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"uv","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"uv": 127994,"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net"},
{"uv": 12700,"timestamp": "2019-03-20T06:05:00Z",key": "cdaa.wonter.net"}
],
"count": 2
}
流量带宽接口
查询流量、带宽
metric: flow
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
level | 可选 | String | 查询边缘节点或者中心节点带宽。可填写"all"或"edge"或"internal",默认为"all" |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
flow | Long | 统计时间段内的传输字节数 |
bps | Long | 统计时间段内的平均bps |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"flow","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key","level":"all"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"flow": 88186275,"bps": 2351634,"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net"},
{"flow": 90383520,"bps": 2410227,"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net"}
],
"count": 2
}
查询流量、带宽(静态)
metric: flow_static
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
level | 可选 | String | 查询边缘节点或者中心节点静态带宽。可填写"all"或"edge"或"internal",默认为"all" |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
flow | Long | 统计时间段内的传输字节数 |
bps | Long | 统计时间段内的平均bps |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"flow_static","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key","level":"all"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"flow": 88186275,"bps": 2351634,"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net"},
{"flow": 90383520,"bps": 2410227,"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net"}
],
"count": 2
}
查询流量、带宽(动态)
metric: flow_dynamic
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
level | 可选 | String | 查询边缘节点或者中心节点动态带宽。可填写"all"或"edge"或"internal",默认为"all" |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
flow | Long | 统计时间段内的传输字节数 |
bps | Long | 统计时间段内的平均bps |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"flow_dynamic","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key","level":"all"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"flow": 88186275,"bps": 2351634,"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net"},
{"flow": 90383520,"bps": 2410227,"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net"}
],
"count": 2
}
查询流量、带宽(分协议)
metric: flow_protocol
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
protocol | 可选 | String | 查询各个协议的流量、带宽。可填写http、https、http3、all,默认all |
level | 可选 | String | 支持查询边缘的分协议流量。可填写all或edge,默认all |
注:protocol指定http3时,只有边缘流量,level参数无用
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
flow | Long | 统计时间段内的传输字节数 |
bps | Long | 统计时间段内的平均bps |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"flow_protocol","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key","protocol":"all"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"flow": 88186275,"bps": 2351634,"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net"},
{"flow": 90383520,"bps": 2410227,"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net"}
],
"count": 2
}
查询流量、带宽(分客户端访问分布)
metric: flow_region
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
prov | 可选 | String | 查询的省份全拼,默认为空,查询全国数据 |
isp | 可选 | String | 查询的运营商代码,默认为空,查询所有运营商数据 |
protocol | 可选 | String | 查询的协议,可填写http3、all,默认all |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
distribution | list<DistributionData> | 客户端访问分布数据 |
DistributionData内容
参数 | 类型 | 说明 |
---|---|---|
location | String | 客户端所在省份、地区 |
isp | String | 客户端所属运营商 |
flow | Long | 统计时间段内的传输字节数 |
bps | Long | 统计时间段内的平均bps |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"flow_region","startTime":"2019-03-19T06:00:00Z","endTime":"2019-03-19T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key","prov":"beijing","isp":"ct"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"timestamp": "2019-03-19T06:00:00Z","key": "cdaa.wonter.net","distribution": [{"location": "北京","isp": "电信","flow": 918742,"bps": 24499}]},
{"timestamp": "2019-03-19T06:05:00Z","key": "cdaa.wonter.net","distribution": [{"location": "北京","isp": "电信","flow": 881491,"bps": 23506}]}
],
"count": 2
}
查询月95峰值带宽
method | path | 说明 |
---|---|---|
POST | /v2/billing | 开放查询统计接口 |
请求参数
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
domains | 可选 | string | 为','分隔的域名或标签 |
type | 必选 | string | 值为peak95,表查询月95带宽数据 |
withTag | 可选 | bool | 表示查询对象为tag还是domain,默认按 domain 查询,当参数值为 true时表按 tag 查询 |
byTime | 可选 | bool | 表示是否按整月查询,默认按整月查询,当参数值为true时按输入时间查询 |
billingMonth | 可选 | string | 整月查询时的开始查询月份,格式形如"year-month"。默认值为本月 |
startTime | 可选 | string | 开始时间,UTC格式。默认值为当前时间前24小时 |
endTime | 可选 | string | 结束时间,UTC格式。默认值为当前时间 |
注1:指定startTime和endTime时,byTime必须设置为true,否则指定时间不生效,按照整月查询。
注2:查询指定月份整月数据时,必须指定billingMonth,否则返回当前月份数据。
返回参数
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
billing_details | 必选 | billing_detail | 查询的数据 |
billing_detail 类型说明
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
bill_band | 必选 | int | 95带宽值 |
bill_time | 必选 | string | 该数据点的时间 |
请求示例
HTTP/1.1 200 OK
Server: nginx
Date: Thu, 19 Dec 2019 04:26:40 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: PHP/7.1.5
x-bce-request-id: aca2dd9e-77a6-7de8-b9d9-7561fb330ba5
{
"type": "peak95",
"byTime": false, // byTime 为 false 时 startTime,endTime 参数无效
"startTime": "2019-12-17T16:00:00Z",
"endTime": "2019-12-18T06:53:33Z",
"billingMonth": "2018-11"
}
返回示例
{
"billing_details": {
"bill_band": 14536504775,
"bill_time": "2018-11-17T12:20:00Z"
}
}
查询回源流量、回源带宽
metric:src_flow
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
flow | Long | 统计时间段内的传输字节数 |
bps | Long | 统计时间段内的平均bps |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"src_flow","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"flow": 0,"bps": 0,"timestamp": "2019-03-20T06:00:00Z"},
{"flow": 0,"bps": 0,"timestamp": "2019-03-20T06:05:00Z"}
],
"count": 2
}
命中率类接口
字节命中率查询
metric:real_hit
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
hitrate | Double | 统计时间段内的字节命中率 |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"real_hit","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net","hitrate": 1},
{"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net","hitrate": 1}
],
"count": 2
}
请求命中率查询
metric:pv_hit
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
hitrate | Double | 统计时间段内的pv命中率 |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"pv_hit","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net","hitrate": 1},
{"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net","hitrate": 1}
],
"count": 2
}
状态码类接口
状态码统计查询
metric:httpcode
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
level | 可选 | String | 支持查询边缘节点状态码。可填写all或edge,默认all |
protocol | 可选 | String | 查询的协议,可填写http3、all,默认all |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
counters | list<KvCounter> | HTTP状态码计数 |
KvCounter内容
参数 | 类型 | 说明 |
---|---|---|
name | Long | HTTP状态码 |
count | Long | 统计计数 |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"httpcode","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"counters": [{"name": 200,"count": 14205},{"name": 499,"count": 27}],"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net"},
{"counters": [{"name": 200,"count": 14558}],"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net"}
],
"count": 2
}
回源状态码查询
metric:src_httpcode
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
counters | list<KvCounter> | HTTP状态码计数 |
KvCounter内容
参数 | 类型 | 说明 |
---|---|---|
name | Long | HTTP状态码 |
count | Long | 统计计数 |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"src_httpcode","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"counters": [{"name": 200,"count": 14205},{"name": 499,"count": 27}],"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net"},
{"counters": [{"name": 200,"count": 14558}],"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net"}
],
"count": 2
}
状态码统计查询(分客户端访问分布)
metric:httpcode_region
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
prov | 可选 | String | 查询的省份全拼,默认为空,查询全国数据 |
isp | 可选 | String | 查询的运营商代码,默认为空,查询所有运营商数据 |
protocol | 可选 | String | 查询的协议,可填写http3、all,默认all |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
distribution | list<HttpCodeDistributionData> | 按客户端访问地域分布的数据详情 |
HttpCodeDistributionData 内容
参数 | 类型 | 说明 |
---|---|---|
location | String | 客户端所在省份、地区 |
isp | String | 客户端所属运营商 |
counters | list<KvCounter> | HTTP状态码计数 |
KvCounter内容
参数 | 类型 | 说明 |
---|---|---|
name | Long | HTTP状态码 |
count | Long | 统计计数 |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"httpcode_region","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key","prov":"beijing","isp":"ct"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net","distribution": [{"location": "北京","isp": "电信","counters": [{"name": 200,"count": 137}]}]},
{"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net","distribution": [{"location": "北京","isp": "电信","counters": [{"name": 200,"count": 141}]}]}
],
"count": 2
}
TopN查询接口
注意:
TopN urls
按pv/flow排序的top urls
metric:top_urls
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
extra | 可选 | Long | 查询指定http状态码的记录,例如200,403,不传默认所有状态码 |
sortKey | 可选 | String | 值为pv或者flow,指定按pv排序还是按flow排序,默认按pv排序 |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
counters | list<TopNCounter> | Top100 统计 |
total_pv | Long | 总pv |
total_flow | Long | 总流量 |
TopNCounter
参数 | 类型 | 说明 |
---|---|---|
name | String | url |
pv | Long | pv |
flow | Long | flow |
filesize | Long | 文件大小 单位byte |
filetype | String | 文件类型 url资源后缀 |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{
"metric": "top_urls",
"startTime": "2023-08-01T00:00:00Z",
"endTime": "2023-08-01T01:00:00Z",
"period": 3600,
"key_type": 0,
"key": [
"baidu.com"
],
"groupBy": "key"
}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{
"timestamp": "2023-08-01T00:00:00Z",
"key": "baidu.com",
"counters": [
{
"name": "https://baidu.com/1.txt",
"flow": 100,
"pv": 2,
"filetype": "txt",
"filesize": 3
},
{
"name": "https://baidu.com/2.txt",
"flow": 200,
"pv": 3,
"filetype": "txt",
"filesize": 3
}
],
"total_pv": 5,
"total_flow": 300
}
],
"count": 1
}
TopN referers
metric:top_referers
说明:按pv排序的top referers
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
extra | 可选 | Long | 查询指定http状态码的记录,例如200,403,不传默认所有状态码 |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
counters | list<TopNCounter> | Top100 统计 |
total_pv | Long | 总pv |
total_flow | Long | 总流量 |
TopNCounter
参数 | 类型 | 说明 |
---|---|---|
name | String | refer |
pv | Long | pv |
flow | Long | flow |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{
"metric": "top_referers",
"startTime": "2023-08-01T00:00:00Z",
"endTime": "2023-08-01T01:00:00Z",
"period": 3600,
"key_type": 0,
"key": [
"baidu.com"
],
"groupBy": "key"
}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{
"counters": [
{
"name": "baidu.com",
"flow": 2649952,
"pv": 21
}
],
"timestamp": "2023-08-01T00:00:00Z",
"key": "baidu.com",
"total_pv": 21,
"total_flow": 2649952
}
],
"count": 1
}
TopN domains
metric:top_domains
说明:按pv排序的top domains
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
extra | 可选 | Long | 查询指定http状态码的记录,例如200,403,不传默认所有状态码 |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
counters | list<TopNCounter> | Top100 统计 |
total_pv | Long | 总pv |
total_flow | Long | 总流量 |
TopNCounter
参数 | 类型 | 说明 |
---|---|---|
name | String | domains |
pv | Long | pv |
flow | Long | flow |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{
"metric": "top_domains",
"startTime": "2023-08-01T07:00:00Z",
"endTime": "2023-08-01T08:00:00Z",
"period": 3600,
"key": [
"your user id"
],
"key_type": 1
}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{
"counters": [
{
"name": "www.baidu.com",
"flow": 75385,
"pv": 119
},
{
"name": "test.baidu.com",
"flow": 6780,
"pv": 13
},
{
"name": "baidu.com",
"flow": 6705,
"pv": 18
}
],
"timestamp": "2023-08-01T07:00:00Z",
"key": "total",
"total_pv": 150,
"total_flow": 88870
}
],
"count": 1
}
TopN clientIP
metric:top_clientip
说明:按pv排序的top clientip
请求体扩展字段:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
extra | 可选 | Long | 查询指定http状态码的记录,例如200,403,不传默认所有状态码 |
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
counters | list<TopNCounter> | Top100 统计 |
total_pv | Long | 总pv |
total_flow | Long | 总流量 |
TopNCounter
参数 | 类型 | 说明 |
---|---|---|
name | String | ip |
pv | Long | pv |
flow | Long | flow |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{
"metric": "top_clientip",
"startTime": "2023-08-01T07:00:00Z",
"endTime": "2023-08-01T08:00:00Z",
"period": 3600,
"key": [
"your user id"
],
"key_type": 1
}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{
"counters": [
{
"name": "87.236.176.0",
"flow": 2640611,
"pv": 1
},
{
"name": "111.206.214.32",
"flow": 9341,
"pv": 20
}
],
"timestamp": "2023-08-01T07:00:00Z",
"key": "total",
"total_pv": 21,
"total_flow": 2649952
}
],
"count": 1
}
查询 IPV6 数据接口
method | path | 说明 |
---|---|---|
post | /v2/stat/ipv6?stat_type=http/https/all | 查询ipv6的统计,stat_type 表查询的数据类型,值为为 http 时表查询的 http 数据;值为 https 时表查询的 https 的数据;值为 all 时表查询的包含http,https的总数据;值为region时表示查询分省份-运营商的数据;默认查询all |
请求体(Request Body)
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
startTime | 可选 | Timestamp | 查询的时间范围起始值,默认为endTime前推24小时 UTC时间 |
endTime | 可选 | Timestamp | 查询的时间范围结束值,默认为当前时间。时间跨度最长90天 UTC时间 |
period | 可选 | int | 查询的时间粒度,单位为s,默认值为 300s |
keys | 可选 | list |
查询的域名列表,当该列表为空是查询该用户的所有域名的数据 |
prov | 可选 | string | 查询的省份拼音全拼,默认为空,查询全国数据,仅当stat_type为region表示查询ipv6分区域数据时此值有效 |
isp | 可选 | string | 查询的运营商代码,默认为空,查询所有运营商数据,仅当stat_type为region表示查询ipv6分区域数据时此值有效 |
响应体(Request Body)
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
details | 必选 | map<timesmap:map<domain:Data>> | 查询结果,其中 timesmap 为 UTC 格式时间,domain 为域名或者 userId。Data 为某个时间点某个域名/用户的数据 |
count | 必选 | int | 查询到到数据条数 |
Data 类型说明:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
flow | 必选 | int | 查询的流量数据 |
bps | 可选 | int | 查询的带宽数据,仅当stat_type不为region时此值有效 |
pv | 必选 | int | 查询的pv数据 |
code | 可选 | list<map<int: int> | 查询的code码数据,仅当stat_type不为region时此值有效 |
distribution | 可选 | map<string, string> | 区域信息,仅当stat_type为region时此值有效,示例数据:{"location":"广东", "isp": "电信"} |
请求示例 1:查询某个域名的全局ipv6统计
POST /v2/stat/ipv6?stat_type=all
Host: cdn.baidubce.com
{
"startTime": "2020-12-21T06:25:00Z",
"endTime": "2020-12-21T07:25:00Z",
"period": 3600,
"keys": [
"www.example.com"
]
}
响应示例 1
{
"count": 3,
"details": {
"2020-12-21T06:00:00Z": {
"www.example.com": {
"flow": 822846778444,
"bps": 1828548396,
"pv": 5953881,
"code": {
"200": 5718978,
"206": 4888,
"304": 230015,
"400": 37,
"403": 77,
"404": 64,
"408": 19,
"499": 15810
}
}
},
"2020-12-21T07:00:00Z": {
"www.example.com": {
"flow": 794698943871,
"bps": 1765997653,
"pv": 5995772,
"code": {
"200": 5733844,
"206": 4908,
"304": 257020,
"400": 32,
"403": 57,
"404": 42,
"408": 17,
"499": 16057
}
}
},
"2020-12-21T08:00:00Z": {
"www.example.com": {
"flow": 767797627279,
"bps": 1706216949,
"pv": 6043410,
"code": {
"200": 5790261,
"206": 4893,
"304": 248256,
"400": 31,
"403": 81,
"404": 32,
"408": 15,
"416": 1,
"499": 15975
}
}
}
}
}
请求示例 2:查询某2个域名在广东电信区域的ipv6统计
POST /v2/stat/ipv6?stat_type=region
Host: cdn.baidubce.com
{
"startTime":"2021-08-31T10:00:00Z",
"endTime":"2021-08-31T10:10:00Z",
"keys":[
"www.example.com",
"www.test.com"
],
"period":300,
"isp":"ct",
"prov":"guangdong"
}
响应示例 2
{
"count":3,
"details":{
"2021-08-31T10:10:00Z":{
"www.example.com":[
{
"flow":2329321827,
"pv":873,
"distribution":{
"location":"广东",
"isp":"电信"
}
}
],
"www.test.com":[
{
"flow":3460533,
"pv":156,
"distribution":{
"location":"广东",
"isp":"电信"
}
}
]
},
"2021-08-31T10:05:00Z":{
"www.example.com":[
{
"flow":4975040172,
"pv":2570,
"distribution":{
"location":"广东",
"isp":"电信"
}
}
],
"www.test.com":[
{
"flow":50829586,
"pv":1400,
"distribution":{
"location":"广东",
"isp":"电信"
}
}
]
},
"2021-08-31T10:00:00Z":{
"www.example.com":[
{
"flow":11245259964,
"pv":3735,
"distribution":{
"location":"广东",
"isp":"电信"
}
}
],
"www.test.com":[
{
"flow":37659121,
"pv":1119,
"distribution":{
"location":"广东",
"isp":"电信"
}
}
]
}
}
}
cdn错误码分类统计查询
metric:error
响应体扩展字段:
参数 | 类型 | 说明 |
---|---|---|
counters | list<KvCounter> | 错误状态码类型及对应计数 |
KvCounter内容
参数 | 类型 | 说明 |
---|---|---|
code | String | 错误码 |
counters | list<DetailData> | 错误类型及计数 |
DetailData 内容
参数 | 类型 | 说明 |
---|---|---|
name | String | 错误类型 |
count | Long | 统计计数 |
请求示例
POST /v2/stat/query HTTP/1.1
Host: cdn.baidubce.com
{"metric":"error","startTime":"2019-03-20T06:00:00Z","endTime":"2019-03-20T06:10:00Z","period":300,"key_type":0,"key":["cdaa.wonter.net"],"groupBy":"key"}
返回示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "ok",
"details": [
{"timestamp": "2019-03-20T06:00:00Z","key": "cdaa.wonter.net","counters": [{"code": 499,"counters": [{"name": "未知","count": 27}]}]},
{"timestamp": "2019-03-20T06:05:00Z","key": "cdaa.wonter.net","counters": [{"code": 499,"counters": [{"name": "未知","count": 18}]}]}
],
"count": 2
}
错误类型分类
名称 | 备注 |
---|---|
源站错误 | 4xx和5xx |
源站错误,CDN已缓存 | 4xx和5xx |
CDN错误 | 4xx和5xx |
未命中499 | 499 |
命中499 | 499 |
CDN连接源站读超时 | 5xx |
CDN连接源站失败 | 5xx |
CDN连接源站失败(SSL) | 5xx |
CDN解析源站域名失败 | 5xx |
CDN与源站交互失败 | 5xx |
未知 | 未匹配到的错误类型 |