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}