检索分析日志QueryLogRecord
更新时间：2026-06-02
- 用户通过提交 Query 检索或分析指定日志集中的数据，每次只能查询一个日志集的内容。
Query 语句支持三种格式，形如:
match 检索语句：需要开启全文索引或者字段索引，根据条件检索日志内容，例如match method:GET and status >= 400SQL 分析语句：执行 SQL 语句，例如select * limit 10match 检索语句 | SQL 语句：需要开启全文索引或者字段索引，在符合检索条件的结果集上执行 SQL 语句，检索语句和 SQL 语句通过竖线分隔，例如match method:GET and status >= 400 | select host, count(*) group by host
查询相关限制如下：
- 每个账户支持最多的查询并发数是 15 个
- 限制检索语句返回的结果集大小不超过 1000 条记录
- 限制分析语句返回的结果集大小不超过 100000 条记录
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1GET /v{version}/logstore/{logStoreName}/logrecord?project={project} HTTP/1.1
2Host: xxx.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为1 |
| project | String | 否 | Query参数 | 日志组名称 |
| logStoreName | String | 是 | URL参数 | 日志集名称 |
| logStreamName | String | 否 | Query参数 | 日志流名称，长度不能超过 192 字符，包含的字符仅限于：a-z, A-Z, 0-9, '_', '-', '.' '/' |
| query | String | 是 | Query参数 | 输入的 Query参数 语句 |
| startDateTime | DateTime | 是 | Query参数 | 起始日期时间，包括起始时间 |
| endDateTime | DateTime | 是 | Query参数 | 结束日期时间，不包括结束时间 |
| marker | string | 否 | Query参数 | 仅当 query 参数为检索语句时，该参数有效，表示查询开始行。默认值为空字符串。 |
| limit | Int | 否 | Query参数 | 仅当 query 参数为检索语句时，该参数有效，表示请求返回的最大日志条数。最小值为 0，最大值为 1000，默认值为 100。（当存在分页参数时此参数被忽略） |
| sort | string | 否 | Query参数 | 仅当 query 参数为检索语句时，该参数有效，表示日志的排序方式。desc：按照日志时间戳降序返回日志，asc：按照日志时间戳升序返回日志，默认值为 desc。 |
| pageNo | int | 否 | Query参数 | 表示检索日志的起始页。仅当 query 参数为检索语句时，并且pageSize参数存在时，该参数有效 |
| pageSize | int | 否 | Query参数 | 表示检索日志的每一页的大小。仅当 query 参数为检索语句时，并且pageNo参数存在时，该参数有效。 |
注：日期时间均为UTC时间，格式ISO8601，例如：2020-01-10T13:23:34Z，startDateTime 和 endDateTime 的范围约束的是 LogRecord 的 timestamp
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| nextMarker | string | 当query为检索语句时，如果还有日志数据，将会返回nextMarker字段，标记下一条位置，用于获取下一页日志数据 |
| resultSet | ResultSet | 返回符合条件的结果集 |
| datasetScanInfo | DatasetScanInfo | 扫描原始数据集的统计信息 |
请求示例
Plain Text
1GET /v1/logstore/demo/logrecord?project=default&logStreamName=my-stream&marker=CNCetPuLMhD__4vWtPuLMg&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响应示例
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 "resultSet": {
10 "queryType": "match",
11 "columns": [
12 "@timestamp",
13 "@seq",
14 "@stream",
15 "@raw"
16 ],
17 "columnTypes": [
18 "int",
19 "int",
20 "string",
21 "string"
22 ],
23 "rows": [
24 [
25 1721198514000,
26 28200116569702400,
27 "wang_test",
28 "{\"@raw\": \"hello test1004\", \"level\": \"info\"}"
29 ]
30 ]
31 },
32 "datasetScanInfo": {
33 "statistics": {
34 "executionTimeInMs": 23,
35 "scanCount": 23,
36 "scanBytes": 3159
37 },
38 "isTruncated": false
39 }
40}评价此篇文章