统计接口（新版）
更新时间：2025-08-05
新建查询参数
CdnStatsParam为统计相关接口的查询参数类，用户可参考如下代码新建一个CdnStatsParam：
Plain Text
1from baidubce.services.cdn.cdn_stats_param import CdnStatsParam
2
3CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
4 key=['opencdn3.sys-qa.com'], period=300, groupBy='')参数说明：
| 参数 | 可选 | 类型 | 说明 | 生效范围 |
|---|---|---|---|---|
| metric | 必选 | String | 指定查询的统计维度，例如pv、pv_region、flow等 | - |
| end_time | 可选 | String | 查询的时间范围结束值，默认为当前时间。时间跨度最长90天。格式为UTC时间字符串，如："2025-08-05T01:00:00Z"。 | ALL |
| start_time | 可选 | String | 查询的时间范围起始值，默认为endTime前推24小时。格式为UTC时间字符串，如："2025-08-05T00:00:00Z"。 | ALL |
| period | 可选 | Long | 查询粒度，单位秒，可选值为60,300,3600,86400；默认为300，uv 默认3600 | ALL |
| key_type | 可选 | Long | 标识key的内容，0=>域名，1=>用户id，2=>tag，默认0 | ALL |
| key | 可选 | list |
域名或用户Id或Tag | ALL |
| groupBy | 可选 | String | 返回结果聚合粒度，key => 根据key聚合，空 => 返回整体结果 | ALL |
| level | 可选 | String | 全节点（all）、边缘(edge) 或者 内部(internal)，默认all | pv、flow |
| prov | 可选 | String | 查询的省份全拼，默认为空，查询全国数据。 | region相关 |
| isp | 可选 | String | 查询的运营商代码，默认为空，查询所有运营商数据。 | region相关 |
| protocol | 可选 | String | 查询http或http的流量、带宽, 取值{'http', 'http', 'all'}，默认‘all’ | flow_protocol |
| extra | 可选 | Long | 查询指定http状态码的记录，默认值："" | top n 相关 |
备注：
生效范围指某些参数针对所有的metric生效，某些参数针对部分metric生效，详见测试用例。
平均速率
查询平均速率
Plain Text
1def test_get_domain_stats_avg_speed(c):
2 """
3 test_get_domain_stats_avg_speed
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'avg_speed'
8 response = c.get_domain_stats(param)
9 print(response)查询按客户端访问分布的平均速率
Plain Text
1def test_get_domain_stats_avg_speed_region(c):
2 """
3 test_get_domain_stats_avg_speed_region
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=None,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'avg_speed_region'
8 param.prov = 'beijing'
9 param.isp = 'ct'
10 response = c.get_domain_stats(param)
11 print(response)pv/qps相关数据查询
查询pv/qps
Plain Text
1def test_get_domain_stats_pv(c):
2 """
3 test_get_domain_stats_pv
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'pv'
8 param.level = 'edge'
9 response = c.get_domain_stats(param)
10 print(response)查询按客户端访问分布的pv/qps
Plain Text
1def test_get_domain_stats_pv_region(c):
2 """
3 test_get_domain_stats_pv_region
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'pv_region'
8 param.prov = 'beijing'
9 param.isp = 'ct'
10 response = c.get_domain_stats(param)
11 print(response)查询回源pv/qps
Plain Text
1def test_get_domain_stats_pv_src(c):
2 """
3 test_get_domain_stats_pv_src
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'pv_src'
8 response = c.get_domain_stats(param)
9 print(response)查询UV
Plain Text
1def test_get_domain_stats_uv(c):
2 """
3 test_get_domain_stats_uv
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T00:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=3600, groupBy='')
7 param.metric = 'uv'
8 response = c.get_domain_stats(param)
9 print(response)流量带宽相关查询
查询流量带宽
Plain Text
1def test_get_domain_stats_flow(c):
2 """
3 test_get_domain_stats_flow
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'flow'
8 param.level = 'edge'
9 response = c.get_domain_stats(param)
10 print(response)查询分协议的流量带宽
Plain Text
1def test_get_domain_stats_flow_protocol(c):
2 """
3 test_get_domain_stats_flow_protocol
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'flow_protocol'
8 param.protocol = 'http'
9 response = c.get_domain_stats(param)
10 print(response)查询分省份运营商的流量带宽
Plain Text
1def test_get_domain_stats_flow_region(c):
2 """
3 test_get_domain_stats_flow_region
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'flow_region'
8 param.prov = 'beijing'
9 param.isp = 'ct'
10 response = c.get_domain_stats(param)
11 print(response)查询回源流量带宽
Plain Text
1def test_get_domain_stats_src_flow(c):
2 """
3 test_get_domain_stats_src_flow
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'src_flow'
8 response = c.get_domain_stats(param)
9 print(response)命中率相关
查询字节命中率
Plain Text
1def test_get_domain_stats_real_hit(c):
2 """
3 test_get_domain_stats_real_hit
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'real_hit'
8 response = c.get_domain_stats(param)
9 print(response)查询请求命中率
Plain Text
1def test_get_domain_stats_pv_hit(c):
2 """
3 test_get_domain_stats_pv_hit
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'pv_hit'
8 response = c.get_domain_stats(param)
9 print(response)状态码相关
状态码统计查询
Plain Text
1def test_get_domain_stats_httpcode(c):
2 """
3 test_get_domain_stats_httpcode
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'httpcode'
8 response = c.get_domain_stats(param)
9 print(response)回源状态码查询
Plain Text
1def test_get_domain_stats_src_httpcode(c):
2 """
3 test_get_domain_stats_src_httpcode
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'src_httpcode'
8 response = c.get_domain_stats(param)
9 print(response)分省份运营商的状态码查询
Plain Text
1def test_get_domain_stats_httpcode_region(c):
2 """
3 test_get_domain_stats_src_httpcode
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'httpcode_region'
8 param.prov = 'beijing'
9 param.isp = 'ct'
10 response = c.get_domain_stats(param)
11 print(response)Top N 查询
Top Urls
Plain Text
1def test_get_domain_stats_top_urls(c):
2 """
3 test_get_domain_stats_top_urls
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'top_urls'
8 param.extra = 200
9 response = c.get_domain_stats(param)
10 print(response)Top Referers
Plain Text
1def test_get_domain_stats_top_referers(c):
2 """
3 test_get_domain_stats_top_referers
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'top_referers'
8 param.extra = 200
9 response = c.get_domain_stats(param)
10 print(response)Top Domains
Plain Text
1def test_get_domain_stats_top_domains(c):
2 """
3 test_get_domain_stats_top_domains
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', period=300, groupBy='')
6 param.metric = 'top_domains'
7 param.extra = 200
8 response = c.get_domain_stats(param)
9 print(response)错误状态码原因查询
Plain Text
1def test_get_domain_stats_error(c):
2 """
3 test_get_domain_stats_error
4 """
5 param = CdnStatsParam(start_time='2025-08-05T00:00:00Z', end_time='2025-08-05T01:00:00Z', key_type=0,
6 key=['opencdn3.sys-qa.com'], period=300, groupBy='')
7 param.metric = 'error'
8 response = c.get_domain_stats(param)
9 print(response)