告警相关接口

更新时间：2024-09-24

查询告警模板列表

请求方法 GET

请求路径：/v2/alerting_rule_template

请求结构

Plain Text

1GET /v2/alerting_rule_template HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

无

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
ruleTemplates	List< RuleTemplate>	告警模板列表

RuleTemplate：

字段	类型	说明
alertName	String	告警名称
expr	String	告警规则，promQL查询语句
for	String	告警持续时间
description	String	告警内容

请求示例

Plain Text

1GET /v2/alerting_rules/templates?instanceId=cprom-sfdjf*****  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "ruleTemplates": [
7        {
8            "alertName": "CCE-节点不可用报警",
9            "expr": "sum(kube_node_status_condition{condition=\"Ready\",status=\"false\",region=\"\", clusterID=~\"\"}) \u003e 0",
10            "for": "2m",
11            "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node not Ready \u003e 0, current: {{ $value | printf \"%.2f\" }}"
12        },
13        {
14            "alertName": "CCE-节点不可调度报警",
15            "expr": "sum(kube_node_spec_unschedulable{region=\"\", clusterID=~\"\"}) \u003e 0",
16            "for": "2m",
17            "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node unschedulable \u003e 0, current: {{ $value | printf \"%.2f\" }}"
18        }
19      ]
20
21}

查询通知策略列表

请求方法 GET

请求路径：/v2/notify_rule

请求结构

Plain Text

1GET /v2/notify_rule?pageNo=1&pageSize=10  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
pageSize	Integer	否	QueryString	分页查询监控实例列表每页监控实例个数，范围为1-100，缺省值为10
pageNo	Integer	否	QueryString	分页查询监控实例列表分页页码数，缺省值为1
keywordType	String	否	QueryString	筛选条件类型，默认为notifyRuleName，只支持notifyRuleName
keyword	String	否	QueryString	筛选条件关键字

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
keywordType	String	筛选条件类型
keyword	String	筛选条件关键字
orderBy	String	通知策略列表排序依据字段
order	String	通知策略列表排序方式：desc倒序，asc升序
pageNo	Integer	通知策略分页当前页码数
pageSize	Integer	当前页页通知策略个数
totalCount	Integer	通知策略总个数
items	List< NotifyRule >	通知策略列表

NotifyRule：

字段	类型	说明
notifyRuleId	String	通知策略ID
notifyRuleName	String	通知名称
startTime	String	通知时段开始时间
endTime	String	通知时段终止时间
channel	List< String >	通知渠道，phone:电话 , sms: 短信, email: 邮件
receiverType	String	接收者类型，user：用户，userGroup：用户组
users	List< User >	用户列表
userGroups	List< UserGroup >	用户组列表
webhookConfigList	List< CallbackConfig >	webhook 回调配置信息列表
escalateConfigList	List< EscalateParam >	通知策略升级参数列表
createTime	String	创建时间
updateTime	String	更新时间

User：

字段	类型	说明
userId	String	用户ID
userName	String	用户名称
userType	String	用户类型, 默认identity
phoneNumber	String	用户手机号码
email	String	用户邮箱

UserGroup：

字段	类型	说明
groupId	String	用户组ID
groupName	String	用户组名称
description	String	用户组描述

CallbackConfig：

字段	类型	说明
webhookType	String	回调类型，weCom:企业微信，dingTalk:钉钉，lark:飞书，custom:自定义webhook
webhookList	List< WebhookDetail >	webhook配置详情列表

WebhookDetail：

字段	类型	说明
hookName	String	机器人名称
hookMethod	String	webhook请求的HTTP方法，默认post
hookUrl	String	机器人地址
headers	Map<String,String>	webhook请求的HTTP头部信息
params	Map<String,String>	webhook请求参数

EscalateParam：

字段	类型	说明
rank	Integer	升级通知策略级别，1，2，3, xx时间未响应升级到1级->2级->3级
Condition.stayInUnclaimTime	String	超过多长时间未认领
Condition.stayInClaimTime	String	认领后多久未恢复
notifyAction.channel	List< String >	通知渠道，phone:电话 , sms: 短信, email: 邮件
notifyAction.receiverType	String	接受者类型，user：用户，userGroup：用户组
notifyAction.users	List< User >	用户列表
notifyAction.userGroups	List< UserGroup>	用户组列表
notifyAction.webhookConfigList	List< CallbackConfig >	webhook 回调配置信息列表

请求示例

Plain Text

1GET /v2/notify_rule/templates?pageNo=1&pageSize=10  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "orderBy": "updateTime",
7    "order": "decs",
8    "pageNo": 1,
9    "pageSize": 10,
10    "totalCount": 2,
11    "items": [
12        {
13            "notifyRuleId": "notify-********",
14            "notifyRuleName": "d-test",
15            "startTime": "00:00:00",
16            "endTime": "23:59:59",
17            "channel": [
18                "email"
19            ],
20            "receiverType": "user",
21            "users": [
22                {
23                    "userId": "2e*************************",
24                    "userName": "d*******",
25                    "userType": "",
26                    "phoneNumber": "",
27                    "email": ""
28                }
29            ],
30            "userGroups": [],
31            "webhookConfigList": [],
32            "createTime": "2024-05-14T14:22:21Z",
33            "updateTime": "2024-05-14T14:22:21Z"
34        },
35        {
36            "notifyRuleId": "notify-b*********",
37            "notifyRuleName": "d**",
38            "startTime": "00:00:00",
39            "endTime": "23:59:59",
40            "channel": [
41                "email"
42            ],
43            "receiverType": "userGroup",
44            "users": [],
45            "userGroups": [
46                {
47                    "groupId": "c************************",
48                    "groupName": "d-****",
49                    "description": ""
50                }
51            ],
52            "webhookConfigList": [],
53            "createTime": "2024-05-14T14:15:08Z",
54            "updateTime": "2024-05-14T14:15:09Z"
55        }
56    ]
57}

创建通知策略

请求方法 POST

请求路径：/v2/notify_rule

请求结构

Plain Text

1POST /v2/notify_rule  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
notifyRuleName	String	是	Body参数	通知策略名称
startTime	String	是	Body参数	通知开始时间，时间格式 00：00：00
endTime	String	是	Body参数	通知结束时间，时间格式 23：59：59
channel	List< String >	否	Body参数	通知渠道，phone:电话 , sms: 短信, email: 邮件。若选择phone:电话 , sms: 短信, email: 邮件这三种方式通知则必选，webhook为非必选。
receiverType	String	否	Body参数	接受者类型，user：用户，userGroup：用户组，若选择phone:电话 , sms: 短信, email: 邮件这三种方式receiverType为必选参数，webhook为非必选。
users	List< User >	receiverType=user时必需	Body参数	用户列表
userGroups	List< UserGroup >	receiverType=userGroup时必需	Body参数	用户组列表
webhookConfigList	List< CallbackConfig >	否	Body参数	webhook 回调配置信息列表
escalateConfigList	List< EscalateParam >	否	Body参数	通知策略升级参数列表

User：

字段	类型	是否必需
userId	String	是
userName	String	是
userType	String	是
phoneNumber	String	否
email	String	否

UserGroup：

字段	类型	是否必需
groupId	String	是
groupName	String	是
description	String	否

CallbackConfig：

字段	类型	是否必需
webhookType	String	是
webhookList	List< WebhookDetail >	是

WebhookDetail：

字段	类型	是否必需
hookName	String	是
hookMethod	String	是
hookUrl	String	是
headers	Map<String,String>	否
params	Map<String,String>	否

EscalateParam：

字段	类型	是否必需	说明
rank	Integer	是	升级通知策略级别，1，2，3, xx时间未响应升级到1级->2级->3级
Condition.stayInUnclaimTime	String	是	超过多长时间未认领
Condition.stayInClaimTime	String	是	认领后多久未恢复
notifyAction.channel	List< String >	否	通知渠道，phone:电话 , sms: 短信, email: 邮件，若选择phone:电话 , sms: 短信, email: 邮件这三种方式通知则必选，webhook为非必选。
notifyAction.receiverType	String	否	接受者类型，user：用户，userGroup：用户组，若选择phone:电话 , sms: 短信, email: 邮件这三种方式receiverType为必选参数，webhook为非必选。
notifyAction.users	List< User >	receiverType=user时必需	用户列表
notifyAction.userGroups	List< UserGroup >	receiverType=userGroup时必需	用户组列表
notifyAction.webhookConfigList	List< CallbackConfig >	否	webhook 回调配置信息列表

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
notifyRuleId	String	通知策略ID

请求示例

Plain Text

1POST /v2/notify_rule  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5{
6  "notifyRuleName": "test",
7  "startTime": "00:00:00",
8  "endTime": "23:59:59",
9  "receiverType": "user",
10  "channel": [
11    "email","phone",
12  ],
13  "users": [
14    {
15      "userId": "6***********************",
16      "userName": "w****25",
17      "userType": "identity",
18      "phoneNumber": "***********",
19      "email": "w****25@baidu.com"
20    }
21  ],
22  "userGroups": [],
23  "webhookConfigList": [
24        {
25            "webhookType": "custom",
26            "webhookList": [
27                {
28                    "hookName": "test",
29                    "hookMethod": "post",
30                    "hookUrl": "http://apiin.im.baidu.com/api/msg/groupmsgsend?access_token=dec67******************",
31                    "headers": null,
32                    "params": null
33                }
34            ]
35        }
36  ],
37  "escalateConfigList": [
38          {
39            "rank": 1,
40            "condition": {
41                "stayInUnclaimTime": 10
42            },
43            "notifyAction": {
44                "channel": [
45                    "phone"
46                ],
47                "receiverType": "userGroup",
48                "users": [],
49                "userGroups": [
50                    {
51                        "description": "",
52                        "groupId": "a0d*******************6",
53                        "groupName": "userGroupTest"
54                    }
55                ]
56            }
57        }
58   ]
59}

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "notifyRuleID": "notify-*********"
7}

更新通知策略

请求方法 PUT

请求路径：/v2/notify_rule/{notifyRuleId}

请求结构

Plain Text

1POST /v2/notify_rule/{notifyRuleId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
notifyRuleId	String	是	Path参数	通知策略ID
notifyRuleName	String	是	Body参数	通知策略名称
startTime	String	是	Body参数	通知开始时间，时间格式 00：00：00
endTime	String	是	Body参数	通知结束时间，时间格式 23：59：59
channel	List< String >	是	Body参数	通知渠道，phone:电话 , sms: 短信, email: 邮件
receiverType	String	是	Body参数	接受者类型，user：用户，userGroup：用户组
users	List< User >	receiverType=user时必需	Body参数	用户列表
userGroups	List< UserGroup >	receiverType=userGroup时必需	Body参数	用户组列表
webhookConfigList	List< CallbackConfig >	否	Body参数	webhook 回调配置信息列表
escalateConfigList	List< EscalateParam >	否	Body参数	通知策略升级参数列表

返回头域

除公共头域，无其它特殊头域。

返回参数

无

请求示例

Plain Text

1POST /v2/notify_rule/notify-q9s*****  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5{
6  "notifyRuleName": "test",
7  "startTime": "00:00:00",
8  "endTime": "23:59:59",
9  "receiverType": "user",
10  "channel": [
11    "email"， "phone"
12  ],
13  "users": [
14    {
15      "userId": "6***************************",
16      "userName": "test25",
17      "userType": "identity",
18      "phoneNumber": "***********",
19      "email": "test25@baidu.com"
20    }
21  ]
22}

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8

查看通知策略

请求方法 GET

请求路径：/v2/notify_rule/{notifyRuleId}

请求结构

Plain Text

1GET /v2/notify_rule/{notifyRuleId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
notifyRuleId	String	是	Path参数	通知策略ID

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
notifyRuleId	String	通知策略ID
notifyRuleName	String	通知策略名称
startTime	String	通知开始时间，时间格式 00：00：00
endTime	String	通知结束时间，时间格式 23：59：59
channel	List< String >	通知渠道，phone:电话 , sms: 短信, email: 邮件
receiverType	String	接受者类型，user：用户，userGroup：用户组
users	List< User >	用户列表
userGroups	List< UserGroup >	用户组列表
webhookConfigList	List< CallbackConfig >	webhook 回调配置信息列表
escalateConfigList	List< EscalateParam >	通知策略升级参数列表
createTime	String	创建时间
updateTime	String	更新时间

请求示例

Plain Text

1GET /v2/notify_rule/notify-q9sie****  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "notifyRuleId": "notify-q9si*****",
7    "notifyRuleName": "test",
8    "startTime": "00:00:00",
9    "endTime": "23:59:59",
10    "channel": [
11        "email"
12    ],
13    "receiverType": "user",
14    "users": [
15        {
16            "userId": "6****************************",
17            "userName": "test25",
18            "userType": "",
19            "phoneNumber": "168********",
20            "email": ""
21        }
22    ],
23    "userGroups": [],
24    "webhookConfigList": [],
25    "createTime": "2024-05-22T08:08:44Z",
26    "updateTime": "2024-05-22T08:08:44Z"
27}

删除通知策略

请求方法 DELETE

请求路径：/v2/notify_rule/{notifyRuleId}

请求结构

Plain Text

1DELETE /v2/notify_rule/{notifyRuleId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
notifyRuleId	String	是	Path参数	通知策略ID

返回头域

除公共头域，无其它特殊头域。

返回参数

无

请求示例

Plain Text

1DELETE /v2/notify_rule/notify-q9sie****  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8

创建告警

请求方法 POST

请求路径：/v2/alerting_rule

请求结构

Plain Text

1POST /v2/alerting_rule?instanceId={instanceId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

字段	类型	是否必需	参数位置	描述
instanceId	String	是	QueryString	Cprom实例ID
alertName	String	是	Body参数	告警名称
expr	String	是	Body参数	告警规则，promQL查询语句
for	String	是	Body参数	告警持续时间
description	String	是	Body参数	告警内容
notifyRuleId	String	是	Body参数	通知策略ID
enable	Boolen	否	Body参数	是否开启告警，创建时默认为true
severity	String	否	Body参数	告警级别，notice/warning/major/critical
labels	Map<Stirng,String>	否	Body参数	自定义label键值对
annotations	Map<Stirng,String>	否	Body参数	自定义注解键值对

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
alertId	String	告警规则ID

请求示例

Plain Text

1POST /v2/alerting_rule?instanceID=cprom-djskf******  HTTP/1.1
2Host: cprom.bj.baidubce.comContentType: application/jsonAuthorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
3{  
4    "alertName": "CCE-节点不可用报警",
5    "expr": "sum(kube_node_status_condition{condition=\"Ready\",status=\"false\",region=\"\", clusterID=~\"\"}) > 0",
6    "for": "2m",
7    "notifyRuleId": "notify-lv8c2ornb",
8    "severity": "notice",
9    "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node not Ready > 0, current: {{ $value | printf \"%.2f\" }}"
10}

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "alertId": "alerting-*********"
7}

更新告警

请求方法 PUT

请求路径：/v2/alerting_rule/{alertingRuleId}

请求结构

Plain Text

1PUT /v2/alerting_rule/{alertingRuleId}?instanceID={instanceId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

字段	类型	是否必需	参数位置	描述
alertingRuleId	String	是	Path参数	告警ID
instanceId	String	是	QueryString	Cprom实例ID
alertName	String	是	Body参数	告警名称
expr	String	是	Body参数	告警规则，promQL查询语句
for	String	是	Body参数	告警持续时间
description	String	是	Body参数	告警内容
notifyRuleId	String	是	Body参数	通知策略ID
severity	String	否	Body参数	告警级别，notice/warning/major/critical
enable	Boolen	否	Body参数	是否开启告警，开启为true，关闭为false
labels	Map<Stirng,String>	否	Body参数	自定义label键值对
annotations	Map<Stirng,String>	否	Body参数	自定义注解键值对

返回头域

除公共头域，无其它特殊头域。

返回参数

无

请求示例

Plain Text

1PUT /v2/alerting_rule/alerting-sfo*****?instanceID=cprom-sdffjdk*****   HTTP/1.1
2Host: cprom.bj.baidubce.comContentType: application/jsonAuthorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
3{
4    "alertName": "CCE-节点不可用报警",
5    "expr": "sum(kube_node_status_condition{condition=\"Ready\",status=\"false\",region=\"\", clusterID=~\"\"}) > 0",
6    "for": "2m",
7    "enable": false,
8    "notifyRuleId": "notify-lv8c2ornb",
9    "severity": "notice",
10    "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node not Ready > 0, current: {{ $value | printf \"%.2f\" }}"
11}

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8

查看告警

请求方法 GET

请求路径：/v2/alerting_rule/{alertingRuleId}

请求结构

Plain Text

1GET /v2/alerting_rule/{alertingRuleId}?instanceId={instanceId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
alertingRuleId	String	是	Path参数	告警ID
instanceId	String	是	QueryString	Cprom实例ID

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
alertId	String	告警ID
alertName	String	告警名称
expr	String	告警规则，promQL查询语句
for	String	告警持续时间
description	String	告警内容
enable	Boolen	是否开启告警
notifyRuleId	String	通知策略ID
labels	Map<Stirng,String>	标签列表, 如：告警级别，notice/warning/major/critical
annotations	Map<Stirng,String>	注解列表，支持自定义注解

请求示例

Plain Text

1GET /v2/alerting_rule/alerting-sfo*****?instanceId=cprom-sdffjdk*****   HTTP/1.1
2Host: cprom.bj.baidubce.comContentType: application/jsonAuthorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "alertId": "alerting-*********",
7    "alertName": "CCE-节点不可用报警2",
8    "expr": "sum(kube_node_status_condition{condition=\"Ready\",status=\"false\",region=\"\", clusterID=~\"\"}) > 0",
9    "for": "2m",
10    "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node not Ready > 0, current: {{ $value | printf \"%.2f\" }}",
11    "notifyRuleId": "notify-lv8c2ornb",
12    "labels": {
13        "cprom_severity": "notice"
14    }
15}

删除告警

请求方法 DELETE

请求路径：/v2/alerting_rule/{alertingRuleId}

请求结构

Plain Text

1DELETE /v2/alerting_rule/{alertingRuleId}?instanceId={instanceId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
alertingRuleId	String	是	Path参数	告警ID
instanceId	String	是	QueryString	Cprom实例ID

返回头域

除公共头域，无其它特殊头域。

返回参数

无

请求示例

Plain Text

1DELETE /v2/alerting_rule/alerting-sfo5*****?instanceId=cprom-u02*****  HTTP/1.1
2Host: cprom.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8

查看告警列表

请求方法 GET

请求路径：/v2/alerting_rule

请求结构

Plain Text

1GET /v2/alerting_rule?instanceId={instanceId}  HTTP/1.1
2Host: cprom.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

参数名称	类型	是否必需	参数位置	描述
instanceId	String	是	QueryString	Cprom实例ID
pageSize	Integer	否	QueryString	分页查询监控实例列表每页监控实例个数，范围为1-100，缺省值为10
pageNo	Integer	否	QueryString	分页查询监控实例列表分页页码数，缺省值为1
keywordType	String	否	QueryString	筛选条件类型，默认为alertName，只支持alertName
keyword	String	否	QueryString	筛选条件关键字

返回头域

除公共头域，无其它特殊头域。

返回参数

参数名称	类型	描述
keywordType	String	筛选条件类型
keyword	String	筛选条件关键字
orderBy	String	告警列表排序依据字段
order	String	告警列表排序方式：desc倒序，asc升序
pageNo	Integer	分页当前页码数
pageSize	Integer	当前页告警个数
totalCount	Integer	告警总个数
items	List< RuleDetail >	告警列表

RuleDetail：

字段	类型	描述
alertId	String	告警ID
alertName	String	告警名称
expr	String	告警规则，promQL查询语句
for	String	告警持续时间
description	String	告警内容
enable	Boolen	是否开启告警
notifyRuleId	String	通知策略ID
labels	Map<Stirng,String>	标签列表, 告警级别等
annotations	Map<Stirng,String>	注解列表

请求示例

Plain Text

1GET /v2/alerting_rule?instanceId=cprom-sdffjdk*****&keywordType=AlertName&keyword=scrapejob-exidjf-cce-esfsf  HTTP/1.1
2Host: cprom.bj.baidubce.comContentType: application/jsonAuthorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

返回示例

Plain Text

1HTTP/1.1200 OK     
2x-bce-request-id: 1214cca7 4ad5 451d 9215 71cb844c0a50     
3Date: Fri,20 May 202208:23:14 GMT    
4Content Type: application/json;charset=UTF-8
5{
6    "keywordType": "AlertName",
7    "keyword": "scrapejob-cce-*****",
8    "pageNo": 1,
9    "pageSize": 10,
10    "totalCount": 1,
11    "items": [
12        {
13            "alertId": "alerting-********",
14            "alertName": "scrapejob-cce-*****",
15            "expr": "sum(kube_node_status_condition{condition=\"Ready\",status=\"false\",region=\"\", clusterID=~\"\"}) > 0",
16            "for": "2m",
17            "description": "cluster: {{ $labels.clusterID }}, region: {{ $labels.region }} SUM of node not Ready > 0, current: {{ $value | printf \"%.2f\" }}",
18            "notifyRuleId": "notify-********",
19            "labels": {
20                "cprom_severity": "notice"
21            }
22        }
23    ]        
24}

创建采集任务接口

错误返回

百度智能云

Prometheus监控服务 CProm

Prometheus监控服务 CProm

告警相关接口

查询告警模板列表

查询通知策略列表

NotifyRule：

User：

UserGroup：

CallbackConfig：

WebhookDetail：

EscalateParam：

创建通知策略

User：

UserGroup：

CallbackConfig：

WebhookDetail：

EscalateParam：

更新通知策略

查看通知策略

删除通知策略

创建告警

更新告警

查看告警

删除告警

查看告警列表