报警历史相关接口
更新时间:2024-09-09
报警历史相关接口
报警历史列表查询接口
接口描述
该接口可获取云产品监控、站点监控等相关报警的报警历史列表信息。
请求参数
名称 | 类型 | 描述 | 是否必须 | 参数位置 |
---|---|---|---|---|
userId | String | 用户id | 是 | RequestBody参数 |
alarmType | String | 警报类型,必填,可选值: ALARM_TYPE_CLOUD (云产品监控) ALARM_TYPE_SITE (站点监控) ALARM_TYPE_CUSTOM (自定义监控) ALARM_TYPE_APP (应用监控) |
是 | RequestBody参数 |
pageNo | Int | 第几页,从1开始计数,必填 | 是 | RequestBody参数 |
pageSize | Int | 每页展示数量,必填,最大值:100 | 是 | RequestBody参数 |
startTime | Int | 起始时间,Unix时间戳,单位:毫秒,选填,若未设置,默认为40天前 | 否 | RequestBody参数 |
endTime | Int | 结束时间,Unix时间戳,单位:毫秒,选填,若未设置,默认为当前时间 | 否 | RequestBody参数 |
scope | String | 云产品,选填,若未设置,表示返回所有云产品的警报 | 否 | RequestBody参数 |
resourceType | String | 监控对象类型,选填,若未设置,表示返回所有监控对象类型的警报 | 否 | RequestBody参数 |
states | List<String> | 警报状态,选填,可同时筛选多个状态,若未设置,表示返回所有状态的警报,可选值: OK (恢复正常) ALERT (异常中) INSUFFICIENT_DATA (数据不足) CLOSED (已关闭) |
否 | RequestBody参数 |
sort | String | 排序字段, 选填,若未设置,默认为startTime,可选项: startTime |
否 | RequestBody参数 |
ascending | Boolean | 是否升序,选填,默认false | 否 | RequestBody参数 |
level | String | 报警等级,选填,若未设置,表示返回所有等级的警报,可选值: ALARM_LEVEL_NOTICE (通知) ALARM_LEVEL_WARNING (警报) ALARM_LEVEL_MAJOR (重要) ALARM_LEVEL_CRITICAL (严重) |
否 | RequestBody参数 |
region | String | 地域,选填,若未设置,表示返回所有地域的警报 | 否 | RequestBody参数 |
alarmAliasName | String | 按策略名模糊查询,选填 | 否 | RequestBody参数 |
resource | ResourceKV | 按实例进行搜索,选填 | 否 | RequestBody参数 |
resources | List<ResourceKV> | 按多个实例进行搜索,选填 | 否 | RequestBody参数 |
ResourceKV
名称 | 类型 | 描述 | 是否必须 | 参数位置 |
---|---|---|---|---|
InstanceId | String | 实例id,选填 | 否 | RequestBody参数 |
taskId | String | 站点监控任务id,填写taskId指定站点监控任务 | 否 | RequestBody参数 |
响应参数
名称 | 类型 | 描述 |
---|---|---|
success | Boolean | 请求是否成功 |
msg | String | 若失败,返回失败原因 |
result | PageResult | 按页封装结果 |
PageResult
名称 | 类型 | 描述 |
---|---|---|
alarms | List<Alarm> | 报警历史列表 |
pageNo | Int | 页码编号 |
pageSize | Int | 页面大小 |
totalCount | Int | 报警历史历史总共个数 |
请求示例
GO
1// build client
2ak := "ALTA*********CYG"
3sk := "b2c5*********3ac1"
4endpoint := "bcm.bj.baidubce.com"
5
6bcmClient, _ := bcm.NewClient(ak, sk, endpoint)
7req := &model.AlarmListQuery{
8 UserID: "a0d*********52ce4",
9 Scope: "BCE_BCC",
10 AlarmType: "ALARM_TYPE_CLOUD",
11 StartTime: 1722927729703,
12 EndTime: 1723532529703,
13 PageNo: 1,
14 PageSize: 10,
15 Sort: "startTime",
16}
17response, _ := bcmClient.GetAlarmList(req)
18
19
20
21// Response
22{
23 "success": true,
24 "result": {
25 "alarms": [
26 {
27 "id": "4d38c*********4ede387",
28 "userId": "a0d*********ce4",
29 "seriesId": "8e7e04*********40198097c0",
30 "state": "OK",
31 "initState": "ALERT",
32 "startTime": 1723531319999,
33 "endTime": 1723531379999,
34 "alarmType": "ALARM_TYPE_CLOUD",
35 "resource": {
36 "scope": "BCE_BCC",
37 "resourceType": "Instance",
38 "region": "bj",
39 "identifiers": {
40 "InstanceId": "i-21*********"
41 },
42 "properties": {
43 "application": "bcc",
44 "shortInstanceId": "i-21*********"
45 }
46 },
47 "policy": {
48 "id": 226086,
49 "name": "b905*********343f",
50 "indexedName": "b905*********343f@0",
51 "aliasName": "qg*********",
52 "updateTime": 1715872066000,
53 "content": "CPU使用率1分钟内平均值\u003e3%,连续发生1次触发报警",
54 "contentEn": "the average of CPUUsagePercent within 1 minute \u003e 3%, occurring 1 time in a row",
55 "level": "ALARM_LEVEL_MAJOR"
56 },
57 "actions": [
58 {
59 "name": "li*********",
60 "type": "ACTION_TYPE_ALERT",
61 "executedTime": 1723531384,
62 "alias": "li*********",
63 "notifications": [
64 "EMAIL",
65 "SMS"
66 ],
67 "callBacks": [
68 "http://apiin.im**************90b0"
69 ],
70 "members": [
71 "li*********"
72 ]
73 }
74 ]
75 }
76 ],
77 "pageNo": 1,
78 "pageSize": 1,
79 "totalCount": 45
80 }
81}
报警历史详情查询接口
请求描述
可以根据报警id来获取报警的详情信息
请求参数
名称 | 类型 | 描述 | 是否必须 | 参数位置 |
---|---|---|---|---|
userId | String | 用户ID | 是 | RequestBody参数 |
alarmId | String | 警报id,全局唯一, 可以从报警历史列表接口获取 | 是 | RequestBody参数 |
响应参数
名称 | 类型 | 描述 |
---|---|---|
success | Boolean | 请求是否成功 |
msg | String | 若失败,返回失败原因 |
result | Alarm | 报警详情内容 |
请求示例
GO
1// build client
2ak := "ALTA*********CYG"
3sk := "b2c5*********3ac1"
4endpoint := "bcm.bj.baidubce.com"
5
6bcmClient, _ := bcm.NewClient(ak, sk, endpoint)
7
8req := &model.AlarmDetailQuery{
9 UserID: "a0d*********ce4",
10 AlarmID: "4d38c*********f35c4ede387",
11}
12response, _ := bcmClient.GetAlarmDetail(req)
13
14
15// Response
16{
17 "success": true,
18 "result": {
19 "id": "4d38c971ca**********35c4ede387",
20 "userId": "a0d**********52ce4",
21 "seriesId": "8e7e040**********4c40198097c0",
22 "state": "OK",
23 "initState": "ALERT",
24 "startTime": 1723531319999,
25 "endTime": 1723531379999,
26 "alarmType": "ALARM_TYPE_CLOUD",
27 "resource": {
28 "scope": "BCE_BCC",
29 "resourceType": "Instance",
30 "region": "bj",
31 "identifiers": {
32 "InstanceId": "i-21**********"
33 },
34 "properties": {
35 "application": "bcc",
36 "shortInstanceId": "i-21**********"
37 }
38 },
39 "policy": {
40 "id": 226086,
41 "name": "b905**********343f",
42 "indexedName": "b905e**********43f@0",
43 "aliasName": "qg**********o",
44 "updateTime": 1715872066000,
45 "content": "CPU使用率1分钟内平均值\u003e3%,连续发生1次触发报警",
46 "contentEn": "the average of CPUUsagePercent within 1 minute \u003e 3%, occurring 1 time in a row",
47 "level": "ALARM_LEVEL_MAJOR"
48 },
49 "actions": [
50 {
51 "name": "li**********",
52 "type": "ACTION_TYPE_ALERT",
53 "executedTime": 1723531384,
54 "alias": "li**********",
55 "notifications": [
56 "EMAIL",
57 "SMS"
58 ],
59 "callBacks": [
60 "http://apiin.im**********f10b72df694790b0"
61 ],
62 "members": [
63 "l**********"
64 ]
65 }
66 ],
67 "alertMetrics": [
68 {
69 "metric": {
70 "name": "CPUUsagePercent",
71 "value": 3.4226478835923735,
72 "aliasName": "CPU使用率1分钟内平均值",
73 "aliasNameEn": "1 min average of CPUUsagePercent",
74 "unit": "%"
75 },
76 "rule": {
77 "seq": 0,
78 "metricName": "thirdparty.bcm.CPUUsagePercent",
79 "operator": "OPERATOR_TYPE_GT",
80 "threshold": 3,
81 "statistics": "STATISTICS_TYPE_AVG",
82 "window": 60
83 }
84 }
85 ]
86 }
87}
附录
Alarm
名称 | 类型 | 描述 |
---|---|---|
id | String | 警报id,全局唯一 |
seriesId | String | 用户id |
userId | String | 警报序列id |
initState | String | 初始警报状态,可能值: OK (恢复正常) ALERT (异常中) INSUFFICIENT_DATA (数据不足) CLOSED (已关闭) |
state | String | 当前状态,一个警报最多有两个状态,若当前状态=初始状态,表示警报仍停留在初始状态 |
closeReason | String | 若警报已关闭,该字段填写关闭原因,可能值: INSUFFICIENT_DATA (无数据) POLICY_MODIFIED (策略更改或删除) |
startTime | Int | 警报开始时间,Unix时间戳,单位:毫秒 |
endTime | Int | 警报结束时间,Unix时间戳,单位:毫秒,若警报未结束,该字段填0 |
resource | Resource | 警报关联的资源 |
policy | Policy | 报警对应的报警策略 |
actions | List<Action> | 报警动作列表 |
alertMetrics | List<AlertMetrics> | 触发报警的指标信息,查询历史详情时会返回 |
Resource
名称 | 类型 | 描述 |
---|---|---|
scope | String | 所属云产品 |
resourceType | String | 云产品子资源类型 |
region | String | 地域 |
identifiers | Map<String, String> | 资源标识,不同云产品有不同的标识符 |
properties | Map<String, String> | 资源属性,不同云产品有不同的资源属性 |
Policy
名称 | 类型 | 描述 |
---|---|---|
name | String | 策略名,用于查询策略详情 |
aliasName | String | 策略显示名 |
content | String | 策略内容 |
contentEn | String | 英文策略内容 |
extra | Map<String, String> | 报警策略的一些额外属性,如果存在会返回 |
Action
名称 | 类型 | 描述 |
---|---|---|
type | String | 动作类型,可选值: ACTION_TYPE_OK (恢复通知) ACTION_TYPE_ALERT (异常通知) ACTION_TYPE_INSUFFICIENT_DATA (数据不足通知) ACTION_TYPE_CALLBACK (报警回调) |
name | String | 动作名称,当type=ACTION_TYPE_CALLBACK,该字段填写回调地址 |
executedTime | Int | 动作执行时间,Unix时间戳,单位:毫秒,若该字段为0或未设置,表示动作未执行 |
alias | String | 通知模板名称 |
notifications | List<String> | 通知的方式,仅包括三种:邮件、短信、电话 |
callBacks | List<String> | 报警回调链接 |
members | List<String> | 用户/用户组信息 |
AlertMetrics
名称 | 类型 | 描述 |
---|---|---|
metric | Metric | 触发报警的指标信息 |
rule | Rule | 触发指标报警的规则 |
Metric
名称 | 类型 | 描述 |
---|---|---|
name | String | 指标名称 |
value | Int | 报警触发时的指标值 |
dimensions | Map<String,String> | 指标维度 |
aliasName | String | 指标中文名 |
aliasNameEn | String | 指标英文名 |
unit | String | 指标单位 |
Rule
名称 | 类型 | 描述 |
---|---|---|
seq | Int | 规则报警策略中的序列,seq相同,表示是同一个规则 |
operator | String | 比较方式,可能值: OPER_TYPE_GT(大于) OPER_TYPE_GE(大于等于) OPER_TYPE_LT(小于) OPER_TYPE_LE(小于等于) OPER_TYPE_EQ(等于) OPER_TYPE_NE(不等于) 环比上升: OPER_TYPE_INC_RATE_GT(环比上周期增长大于) OPER_TYPE_INC_RATE_GE(环比上周期增长大于等于) OPER_TYPE_INC_RATE_LT(环比上周期增长小于) OPER_TYPE_INC_RATE_LE(环比上周期增长小于等于) OPER_TYPE_INC_RATE_EQ(环比上周期增长等于) OPER_TYPE_INC_RATE_NE(环比上周期增长不等于) 环比下降: OPER_TYPE_DEC_RATE_GT(环比上周期下降大于) OPER_TYPE_DEC_RATE_GE(环比上周期下降大于等于) OPER_TYPE_DEC_RATE_LT(环比上周期下降小于) OPER_TYPE_DEC_RATE_LE(环比上周期下降小于等于) OPER_TYPE_DEC_RATE_EQ(环比上周期下降等于) OPER_TYPE_DEC_RATE_NE(环比上周期下降不等于) |
threshold | Int | 报警阈值 |