PreviewAlarmLogRecord
更新时间：2024-09-11
描述
- 预览告警任务的日志记录（LogRecord），最多返回1000条日志
- 查询语句不支持纯检索语句
match ...， 可以支持查询语句select ...以及带有检索条件的查询语句match ...| select ...
请求
- 请求语法
Http
1GET /v1/alarm/{logStoreName}/logrecord?project={project}&query={query}&startDateTime={startDateTime}&endDateTime={endDateTime} HTTP/1.1
2Host: bls-log.bj.baidubce.com
3Authorization: authorization string- 请求头域
除公共请求头域外，无其它特殊头域。
- 请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| project | String | no | Query | 日志组名称，默认default |
| logStoreName | String | yes | Path | 日志集名称 |
| query | String | yes | Query | 查询 Query |
| startDateTime | DateTime | yes | Query | 起始日期时间，包括起始时间, UTC格式 |
| endDateTime | DateTime | yes | Query | 结束日期时间，不包括结束时间, UTC格式 |
响应
- 响应头域
除公共响应头域外，无其它特殊头域。
- 响应参数
| 参数名称 | 类型 | 是否必须 | 描述 | 取值格式 |
|---|---|---|---|---|
| columns | LIST[String] | no | 数据集的column名字 | 未查询到结果时返回为空 |
| rows | LIST[LIST[Obj]] | no | 每一行对应columns中列名的值 | obj为每一列对应的值，未查询到结果时返回为空 |
| isTruncated | Bool | yes | 结果集是否被截断 | true/false |
| truncatedReason | String | no | 结果集被截断的原因，如果没有被截断，就没有原因 | - |
| metricExtractErr | String | no | 根据query信息提取推送指标过程中err | 如果没有错误则不包括该字段 |
| metricNameList | LIST[String] | yes | 提取到的可以成为推送指标的字段信息 | - |
错误码
除了通用的错误码，还可能出现如下错误码：
| 错误码 | 错误消息 | 描述 | HTTP状态码 |
|---|---|---|---|
| LogStoreNotFound | LogStore [logStoreName] not exists | LogStore 不存在 | 404 |
注：错误消息中 [logStoreName] 部分会用具体的名称来替换
示例
- 请求示例
Http
1POST /v1/alarm/store/logrecord?project=default&startDateTime=2019-09-01T22:00:00Z&endDateTime=2019-09-01T23:00:00Z&query=select t, cast(t as timestamp), count(1) HTTP/1.1
2Host: bls-log.bj.baidubce.com
3Authorization:bce-auth-v1/18717522d39411e9b721df098b0b908c/2019-09-10T07:00:20Z/1800/content-type;host;x-bce-date;x-bce-request-id/6a7cb6c9ac7ec156c805e55e7d0bcfc443b47feee97cf099c1c0d93a0b4c8304
4Content-Type: application/json; charset=utf-8- 响应示例
Http
1HTTP/1.1 201
2Content-Type: application/json; charset=utf-8
3{
4 "columns": [
5 "t",
6 "cast(t as timestamp)",
7 "count(1)"
8 ],
9 "rows": [
10 [
11 1573603200000,
12 "2019-11-13T00:00:00Z",
13 6151
14 ],
15 [
16 1573603260000,
17 "2019-11-13T00:01:00Z",
18 4880
19 ]
20 ],
21 "isTruncated": true,
22 "truncatedReason": "PiecesQuotaExceed",
23 "metricNameList": ["t", "cast(t as timestamp)", "count(1)"]
24}