直方图接口QueryLogHistogram
更新时间：2026-06-02
- 用户通过提交 Query 检索语句，分析数据量统计直方图，每次只能查询一个日志集的内容。
- Query 语句支持三种格式，形如:
- match 检索语句：根据检索条件，返回满足检索条件的日志直方图统计
- SQL 语句：返回全部日志的直方图统计
- match 检索语句 | SQL 语句：根据检索条件，返回满足检索条件的日志直方图统计 查询相关限制如下：
- 日志集必须开启索引，若未开启索引，直方图查询返回报错
- 查询时间上限60秒，超过60秒未统计出结果会返回报错
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1GET /v{version}/logstore/{logStoreName}/loghistogram?project={project} HTTP/1.1
2Host: xxx.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为2 |
| project | String | 否 | Query参数 | 日志组名称 |
| logStoreName | String | 是 | URL参数 | 日志集名称 |
| logStreamName | String | 否 | Query参数 | 日志流名称 |
| query | String | 是 | Query参数 | 输入的 Query 语句 |
| startDateTime | DateTime | 是 | Query参数 | 起始日期时间，UTC时间，包括起始时间 |
| endDateTime | DateTime | 是 | Query参数 | 结束日期时间，UTC时间，不包括结束时间 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| searchInfo | SearchInfo | 检索汇总信息 |
| searchStatistic | SearchStatistic | 直方图统计信息 |
请求示例
Plain Text
1GET /v2/logstore/demo/loghistogram?project=default&logStreamName=my-stream&startDateTime=2019-09-01T22:00:00Z&endDateTime=2019-09-01T23:00:00Z&query=match * HTTP/1.1
2HOST bls-log.bj.baidubce.com
3Authorization bce-auth-v1/5e5a8adf11ae475ba95f1bd38228b44f/2016-04-10T08:26:52Z/1800/host;x-bce-date/ec3c0069f9abb1e247773a62707224124b2b31b4c171133677f9042969791f02
4
5{
6 "name":"eip-for-test"
7}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 946002ee-cb4f-4aad-b686-5be55df27f09
3Date: Wed, 10 Apr 2016 08:26:52 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "searchInfo":{
10 "queryType":"match",
11 "took":1320,
12 "hits":86354
13 },
14 "searchStatistic":{
15 "interval":60000,
16 "startTime":"2019-12-01T00:00:00Z",
17 "endTime":"2019-12-01T00:00:00Z",
18 "histogram":[
19 {
20 "key":1704763500000,
21 "doc_count":316860
22 },
23 {
24 "key":1704763800000,
25 "doc_count":769180
26 },
27 {
28 "key":1704764100000,
29 "doc_count":788788
30 }
31 ]
32}评价此篇文章