更新时间:2024-04-29 GMT+08:00
分享

查询告警列表

功能介绍

查询系统中存在的告警。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1/apm2/openapi/alarm/data/get-alarm-data-list

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

x-business-id

Long

应用id。

X-Auth-Token

String

从IAM服务获取的用户Token。

表2 请求Body参数

参数

是否必选

参数类型

描述

page

Integer

页码。

page_size

Integer

每页数量。

region

String

region英文名称。

app_name

String

组件环境名称。

business_id

Long

应用id。

monitor_item_id

Long

监控项id。

status

String

告警状态 RECOVER:已恢复 ABNORMAL:异常 ALERT:告警中。

alarm_level

String

告警级别 COMMON:轻微 CRITICAL:严重。

keyword

String

关键字。

alarm_start_time

String

告警开始时间。

alarm_end_time

String

告警结束时间。

collector_id

Integer

采集器id。

ip_address

String

实例ip地址。

env_list

Array of integers

环境集合。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

alarm_data_list

Array of AlarmDataVO objects

告警列表。

total_count

Integer

消息总数。

表4 AlarmDataVO

参数

参数类型

描述

id

Long

告警通知id。

gmt_create

String

创建时间。

region_alarm_event_id

Long

region中事件的id。

business_name

String

应用名称。

app_name

String

组件名称。

version_number

Integer

版本。

alarm_rule_type

String

告警规则类别。

gmt_modify

String

修改时间。

process_unit

String

处理单元。

region

String

区域名称。

instance_id

Long

实例id。

ip_address

String

实例ip地址。

instance_name

String

实例名称。

env_id

Long

环境id。

business_id

Long

应用id。

template_id

Long

模板id。

alarm_rule_id

Long

告警规则id。

monitor_item_id

Long

监控项id。

collector_id

Integer

采集器id。

collector_name

String

采集器名称。

alarm_rule_name

String

告警规则名称。

alarm_rule_expression

String

告警表达式。

alarm_first_time

String

开始报警时间。

alarm_last_time

String

最后一次报警时间。

alarm_level

String

告警级别。

restrain_key

String

唯一告警标识符。

status

String

告警状态。

请求示例

分页查询应用ID为1,告警状态为告警中的告警列表。

/v1/apm2/openapi/alarm/data/get-alarm-data-list

{
  "business_id" : 1,
  "page" : 1,
  "page_size" : 10,
  "status" : "ALERT"
}

响应示例

状态码: 200

OK,请求响应成功。

{
  "alarm_data_list" : [ {
    "id" : 42,
    "gmt_create" : null,
    "version_number" : null,
    "alarm_rule_type" : "TEMPLATE",
    "gmt_modify" : null,
    "process_unit" : "xxx-roma-2-process-unit",
    "region" : "xxx-roma-2",
    "instance_id" : 8,
    "ip_address" : "*.*.*.*",
    "instance_name" : "ins11_3",
    "env_id" : 7,
    "business_id" : 1,
    "template_id" : 2,
    "alarm_rule_id" : 3,
    "monitor_item_id" : 46,
    "collector_id" : 28,
    "collector_name" : "JVM监控",
    "alarm_rule_name" : "alarm",
    "alarm_rule_expression" : "(cpuRatio>0)",
    "alarm_first_time" : "2022-10-23 18:12:53",
    "alarm_last_time" : "2022-10-25 16:05:55",
    "alarm_level" : "COMMON",
    "restrain_key" : "7:8:3:TEMPLATE",
    "status" : "ALERT",
    "alarm_content" : "CPU0.025使用率为0.025",
    "alarm_data_type" : "SINGLE",
    "region_alarm_event_id" : 122,
    "business_name" : "default",
    "app_name" : "app_new3"
  }, {
    "id" : 41,
    "gmt_create" : null,
    "version_number" : null,
    "alarm_rule_type" : "TEMPLATE",
    "gmt_modify" : null,
    "process_unit" : "xxx-roma-2-process-unit",
    "region" : "xxx-roma-2",
    "instance_id" : 4,
    "ip_address" : "*.*.*.*",
    "instance_name" : "ins10_5",
    "env_id" : 5,
    "business_id" : 1,
    "template_id" : 2,
    "alarm_rule_id" : 3,
    "monitor_item_id" : 28,
    "collector_id" : 28,
    "collector_name" : "JVM监控",
    "alarm_rule_name" : "alarm",
    "alarm_rule_expression" : "(cpuRatio>0)",
    "alarm_first_time" : "2022-10-23 18:02:44",
    "alarm_last_time" : "2022-10-25 16:05:46",
    "alarm_level" : "COMMON",
    "restrain_key" : "5:4:3:TEMPLATE",
    "status" : "ALERT",
    "alarm_content" : "CPU0.025使用率为0.025",
    "alarm_data_type" : "SINGLE",
    "region_alarm_event_id" : 121,
    "business_name" : "default",
    "app_name" : "app_new5"
  } ],
  "total_count" : 2
}

状态码

状态码

描述

200

OK,请求响应成功。

400

Bad Request,语义或参数有误。

401

Unauthorized,没有权限。

403

Forbidden,禁止访问。

404

Not Found,没有找到要请求的资源。

错误码

请参见错误码

相关文档