查询活动或历史告警列表
功能介绍
该接口用于查询告警列表
URI
POST /v2/{project_id}/{domain_id}/lts/alarms/sql-alarm/query
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID 最小长度:32 最大长度:32 |
domain_id |
是 |
String |
账号ID,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID 最小长度:32 最大长度:32 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
type |
是 |
String |
是活动告警还是历史告警。 |
marker |
否 |
String |
取值为上一页数据的最后一条记录的id(填写上一页数据返回得previous_marker或者next_marker值)。 最小长度:0 最大长度:1000 |
limit |
否 |
Integer |
每页数据量 最小值:0 最大值:1000 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token,获取方式请参见:获取用户Token 最小长度:1000 最大长度:2000 |
Content-Type |
是 |
String |
该字段填为:application/json;charset=UTF-8。 最小长度:30 最大长度:30 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
whether_custom_field |
是 |
Boolean |
是否自定义查询时间段 |
start_time |
否 |
Long |
自定义时间段开始时间(时间戳) 最小值:13 最大值:13 |
end_time |
否 |
Long |
自定义时间段结束时间(时间戳) 最小值:13 最大值:13 |
time_range |
否 |
String |
timeRange用于指标查询时间范围,主要用于解决客户端时间和服务端时间不一致情况下,查询最近N分钟的数据。另可用于精确查询某一段时间的数据。 如:
最小长度:1 最大长度:32 |
search |
否 |
String |
模糊查询匹配字段,可以为空。如果值不为空,可以模糊匹配。metadata字段为必选字段。 最小长度:1 最大长度:1024 |
alarm_level_ids |
否 |
Array of strings |
告警级别("Critical","Major","Minor","Info")
说明:
alarmLevelIds为旧版参数,目前兼容该参数,建议使用 alarm_level_ids |
sort |
否 |
Sort object |
返回列表的排序方式,可以为空。 |
step |
否 |
Integer |
统计步长。毫秒数,例如一分钟则填写为60000。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
annotations |
Annotations object |
告警详情 |
metadata |
Metadata object |
告警信息 |
arrives_at |
Long |
到达时间(时间戳) |
ends_at |
Long |
告警清除时间(时间戳) |
id |
String |
告警id |
starts_at |
Long |
告警产生时间(时间戳) |
timeout |
Long |
告警自动清除时间(时间戳) |
type |
String |
告警规则类型(SQL/关键词) |
参数 |
参数类型 |
描述 |
---|---|---|
message |
String |
告警列表详情 |
log_info |
String |
日志组/流id名称 |
current_value |
String |
当前值 |
old_annotations |
String |
(sql/关键词)告警详情原始数据 |
参数 |
参数类型 |
描述 |
---|---|---|
event_type |
String |
告警类型 |
event_id |
String |
告警id |
event_severity |
String |
告警级别 |
event_name |
String |
告警名称 |
resource_type |
String |
资源类型 |
resource_id |
String |
日志组/流名称 |
resource_provider |
String |
告警源 |
lts_alarm_type |
String |
告警规则类型(SQL/关键词) |
参数 |
参数类型 |
描述 |
---|---|---|
next_marker |
String |
返回下一页查询地址(为空时,代表后面没有数据) |
previous_marker |
String |
返回前一页查询地址 |
current_count |
String |
本页返回条目数量 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误内容 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误内容 |
请求示例
查询活动或历史告警列表
POST https://{endpoint}/v2/{project_id}/{domain_id}/lts/alarms/sql-alarm/query?type=active_alert { "whether_custom_field" : false, "start_time" : 0, "end_time" : 0, "time_range" : "30", "search" : "", "alarm_level_ids" : [ "Critical", "Major", "Minor", "Info" ], "sort" : { "order_by" : [ "starts_at" ], "order" : "desc" } }
响应示例
状态码:200
请求响应成功。
{ "events" : [ { "annotations" : { "current_value" : "{\"pv\":30}", "log_info" : "[{\"log_group_id\":\"50bcab14-xxxx-xxxx-xxxx-41ae4a6e3401\",\"log_group_name\":\"lts-test-group\",\"log_group_name_alias\":\"lts-test-group\",\"log_stream_id\":\"90727e60-xxxx-xxxx-xxxx-19ba53adcbc5\",\"log_stream_name\":\"lts-test-topic\",\"log_stream_name_alias\":\"lts-test-topic\"}]", "message" : "{\"alarm_action_rule_name\":\"testlts\",\"alarm_rule_alias\":\"lts001\",\"alarm_rule_id\":\"2ef849e9-afb4-4983-9197-9049c3460b9d\",\"alarm_rule_name\":\"lts001\",\"closed_alarm_time\":0,\"condition_expression\":\"pv > 0\",\"condition_expressions\":[{\"condition_expression\":\"pv > 0\"}],\"create_time\":0,\"domain_id\":\"1d26cc8c86a840e28a4f8dxxxxxxxxxx\",\"frequency\":{\"day_of_week\":1,\"fixed_rate\":1,\"fixed_rate_unit\":\"minute\",\"hour_of_day\":0,\"type\":\"FIXED_RATE\"},\"is_css_sql\":true,\"ltsAlarmInfos\":[{\"conditions\":[],\"is_time_range_relative\":true,\"log_group_id\":\"50bcab14-xxxx-xxxx-xxxx-41ae4a6e3401\",\"log_group_name\":\"lts-test-group\",\"log_group_name_alias\":\"lts-test-group\",\"log_stream_id\":\"90727e60-xxxx-xxxx-xxxx-19ba53adcbc5\",\"log_stream_name\":\"lts-test-topic\",\"log_stream_name_alias\":\"lts-test-topic\",\"search_time_range\":5,\"search_time_range_unit\":\"minute\",\"sql\":\"* | SELECT count(*) as pv\",\"sql_request_title\":\"\"}],\"notification_frequency\":0,\"projectId\":\"\",\"status\":\"RUNNING\",\"topics\":[],\"type\":\"sql\",\"update_time\":0,\"whether_recovery_policy\":false}" }, "metadata" : { "event_type" : "alarm", "event_id" : "2ef849e9-xxxx-xxxx-xxxx-9049c3460b9d", "lts_alarm_type" : "search_analysis", "event_severity" : "Critical", "resource_type" : "日志组/流", "event_name" : "lts001", "resource_id" : "lts-test-group/lts-test-topic", "event_subtype" : "sql", "resource_provider" : "LTS" }, "type" : "search_analysis" } ] }
状态码:400
响应内容
{ "error_code" : "LTS.2005", "error_msg" : "Find alarm error start_time or end_tim must not be empty." }
状态码:500
响应内容
{ "error_code" : "LTS.0010", "error_msg" : "Internal Server Error" }
状态码
状态码 |
描述 |
---|---|
200 |
请求响应成功。 |
400 |
响应内容 |
500 |
响应内容 |
错误码
请参见错误码。