查询告警列表- ListAlarmData
功能介绍
查询系统中存在的告警。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
apm:application:get
Read
-
g:EnterpriseProjectId
apm:apm2BusinessBusiness:get
-
URI
POST /v1/apm2/openapi/alarm/data/get-alarm-data-list
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
x-business-id |
是 |
Long |
应用id。 |
|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
alarm_data_list |
Array of AlarmDataVO objects |
告警列表。 |
|
total_count |
Integer |
消息总数。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
Long |
告警通知id。 |
|
gmt_create |
String |
创建时间。 |
|
gmt_create_timestamp |
Long |
创建的时间戳。 |
|
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 |
告警状态。 |
|
alarm_source |
String |
告警来源。 |
|
alarm_content |
String |
告警内容。 |
|
alarm_data_type |
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" : "****-***-2-process-unit",
"region" : "****-***-2",
"instance_id" : 8,
"ip_address" : "192.168.0.87",
"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" : "****-***-2-process-unit",
"region" : "****-***-2",
"instance_id" : 4,
"ip_address" : "192.168.0.87",
"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,没有找到要请求的资源。 |
错误码
请参见错误码。