调用SearchAlertRules接口查询报警规则。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SearchAlertRules |
系统规定参数,取值为 |
RegionId | String | 是 | cn-hangzhou |
地域ID。 |
ProxyUserId | String | 否 | 123412** |
内部参数。 |
Title | String | 否 | AlertRuleTitle |
报警规则名称。 |
Type | String | 否 | 4 |
报警规则类型:
|
CurrentPage | Integer | 否 | 1 |
查询结果分页的页码。默认为 |
PageSize | Integer | 否 | 20 |
查询结果分页的每页项目数量。默认为 |
Pid | String | 否 | atc889zkcf@d8deedfa9bf**** |
报警规则关联的ARMS应用ID,分为以下类型:
|
AppType | String | 否 | TRACE |
报警规则对应的应用类型,分为以下类型:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
PageBean | Struct |
返回结构体。 |
|
AlertRules | Array |
报警规则列表。 |
|
AlarmContext | Struct |
报警发送消息格式。 |
|
AlarmContentSubTitle | String | TestSubTitle |
报警内容子标题。 |
AlarmContentTemplate | String | 报警名称:$报警名称\n筛选条件: $筛选\n报警时间: $报警时间\n报警内容: $报警内容\n注意:该报警未收到恢复邮件之前,正在持续报警中,24小时后会再次提醒您! |
报警通知内容模板。 |
AlertLevel | String | WARN |
报警通知级别,目前只支持 |
AlertRule | Struct |
报警规则判断条件列表。支持多个条件,条件间用“与逻辑”或“或逻辑”连接。 |
|
Operator | String | | |
报警规则判断逻辑。 |
Rules | Array |
报警规则判断条件。 |
|
Aggregates | String | AVG |
报警判断规则的聚合逻辑:
|
Alias | String | 调用响应时间_ms |
报警指标的展示文本。 |
Measure | String | appstat.jvm.SystemDiskFree |
报警规则数据指标,根据这些指标判断是否符合报警规则条件。详情请参见报警指标取值枚举。 |
NValue | Integer | 5 |
报警规则判断条件的数据请求范围,单位为分钟。例如,NValue=5表示每分钟报警将请求最近5分钟的数据。 |
Operator | String | CURRENT_GTE |
报警规则判断条件的判断符号:
|
Value | Float | 30 |
报警规则判断条件的判断阈值。 |
AlertTitle | String | TestAlertRule |
报警规则名称。 |
AlertType | Integer | 4 |
报警规则类型:
|
AlertVersion | Integer | 1 |
报警规则版本,默认为 |
AlertWays | List | ["MAIL", "SMS", "DING_ROBOT"] |
报警通知发送方式:
|
Config | String | {\"continuous\":true,\"dataRevision\":2} |
报警规则的配置项,格式为JSON字符串。 continuous的值包括:
dataRevision表示未取得数据或者或数据为null值时的数据修订策略,包括:
|
ContactGroupIdList | String | 381*,572* |
报警规则中联系人分组ID,多个ID以半角逗号(,)分隔。 |
CreateTime | Long | 1579508519683 |
报警规则创建时间的时间戳。 |
Id | Long | 123 |
报警规则ID。 |
MetricParam | Struct |
报警规则关联应用信息配置。 |
|
AppGroupId | String | DEFAULT |
报警关联应用的应用子分组ID,适用于EDAS应用分组场景。 |
AppId | String | 123 |
ARMS应用的自增ID,可忽略。 |
Dimensions | Array |
报警规则判断条件中的维度条件。 |
|
Key | String | rootIp |
维度名称,包括以下值:
|
Type | String | DISABLED |
维度条件的类型,包含以下可选值:
|
Value | String | "127.0.0.1" |
维度选项的值。 |
Pid | String | 9870ca99-8105-4da7-a3a4-d72dd1b1**** |
报警规则关联的应用的ID。 |
Type | String | DB |
报警规则指标的类型。
|
Notice | Struct |
报警规则的生效时间范围和通知时间范围。 |
|
EndTime | Long | 1480607940000 |
报警规则生效时间范围的结束时间的时间戳,控制报警规则在每天24小时中的生效时间范围。格式为UNIX时间戳,其中年月日不生效,只有时分秒生效。 |
NoticeEndTime | Long | 1480607940000 |
报警规则通知时间范围的结束时间的时间戳,控制报警规则在每天24小时中的通知时间范围。格式为UNIX时间戳,其中年月日不生效,只有时分秒生效。 |
NoticeStartTime | Long | 1480521600000 |
报警规则通知时间范围的开始时间的时间戳,控制报警规则在每天24小时中的通知时间范围。格式为UNIX时间戳,其中年月日不生效,只有时分秒生效。 |
StartTime | Long | 1480521600000 |
报警规则生效时间范围的开始时间的时间戳,控制报警规则在每天24小时中的生效时间范围。格式为UNIX时间戳,其中年月日不生效,只有时分秒生效。 |
RegionId | String | cn-hangzhou |
报警规则所属的地域ID。 |
Status | String | RUNNING |
报警规则状态。 |
TaskId | Long | 123 |
基于任务的自定义监控报警规则所关联的ARMS任务ID。 |
TaskStatus | String | "" |
内部字段。 |
UpdateTime | Long | 1480521600000 |
报警规则更新时间的时间戳。 |
UserId | String | 113197164949**** |
报警规则所属用户的ID。 |
PageNumber | Integer | 1 |
查询结果分页页码。 |
PageSize | Integer | 20 |
查询结果分页的每页项目数量。 |
TotalCount | Integer | 23 |
查询结果总数。 |
RequestId | String | 34ED024E-9E31-434A-9E4E-D9D15C3**** |
请求ID。 |
报警指标取值枚举
- 报警类型(metricParam.type):TXN(应用监控入口调用量)
- 此类报警维度(dimensions.key):rpc(接口名称)
- 此类报警数据请求指标(alertRule.rules.measure):
- appstat.txn.rt:入口调用响应时间(毫秒)
- appstat.txn.count:入口调用次数
- appstat.txn.errcount:入口调用错误次数
- 报警类型(metricParam.type):TXN_TYPE(应用监控调用类型统计)
- 此类报警维度(dimensions.key):rpcType(接口调用类型,如HTTP、DUBBO)
- 此类报警数据请求指标(alertRule.rules.measure):
- appstat.inbound.rt:应用提供服务调用响应时间(毫秒)
- appstat.inbound.count:应用提供服务调用次数
- appstat.inbound.error:应用提供服务调用错误数
- appstat.outbound.rt:应用依赖服务调用响应时间(毫秒)
- appstat.outbound.count:应用依赖服务调用次数
- appstat.outbound.error:应用依赖服务调用错误数
- 报警类型(metricParam.type):DB(数据库指标)
- 此类报警维度(dimensions.key):endpoint(数据库名称)
- 此类报警数据请求指标(alertRule.rules.measure):
- appstat.database.rt:数据库调用响应时间(毫秒)
- appstat.database.count:数据库调用次数
- appstat.database.errcount:数据库调用错误次数
- 报警类型(metricParam.type):JVM(JVM监控)
- 此类报警维度(dimensions.key):rootIp(机器IP地址)
- 此类报警数据请求指标(alertRule.rules.measure):
- appstat.jvm.heap_used:JVM堆内总内存量(字节)
- appstat.jvm.GcPsScavengeCount:JVM垃圾回收次数
- appstat.jvm.GcPsMarkSweepCount:JVM标记清除次数
- appstat.jvm.GcG1OldGenCount:JVM_Old区G1GC次数
- appstat.jvm.GcG1YoungGenCount:JVM_Young区G1GC次数
- appstat.jvm.gc.YoungGcCountInstant:JVM_YoungGC次数
- appstat.jvm.gc.OldGcCountInstant:JVM_FullGC次数
- appstat.jvm.gc.YoungGcTimeInstant:JVM_YoungGC耗时(毫秒)
- appstat.jvm.gc.OldGcTimeInstant:JVM_FullGC耗时(毫秒)
- appstat.jvm.ThreadCount:JVM_线程总数
- appstat.jvm.non_heap_used:JVM非堆总使用内存量(字节)
- appstat.jvm.non_heap_max:JVM非堆内存最大值(字节)
- appstat.jvm.non_heap_init:JVM非堆内存初始值(字节)
- appstat.jvm.non_heap_committed:JVM非堆内存提交值(字节)
- 报警类型(metricParam.type):HOST(主机监控)
- 此类报警维度(dimensions.key):rootIp(机器IP地址)
- 此类报警数据请求指标(alertRule.rules.measure):
- appstat.jvm.SystemCpuUser:节点机用户使用CPU(百分比)
- appstat.jvm.SystemMemFree:节点机空闲内存(字节)
- appstat.jvm.SystemDiskFree:节点机空闲磁盘(字节)
- appstat.jvm.SystemNetInErrs:节点机接收错误报文数
- appstat.jvm.SystemNetOutErrs:节点机发送错误报文数
- appstat.jvm.SystemLoad:节点机系统负载
- 报警类型(metricParam.type):EXCEPTION(异常接口调用)
- 此类报警维度(dimensions.key):rpc(接口名称)
- 此类报警数据请求指标(alertRule.rules.measure):
- appstat.exception.rt:应用异常接口调用响应时间(毫秒)
- appstat.exception.count:应用异常接口调用次数
示例
请求示例
http(s)://[Endpoint]/?Action=SearchAlertRules
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<SearchAlertRulesResponse>
<PageBean>
<TotalCount>1</TotalCount>
<PageSize>10</PageSize>
<PageNumber>1</PageNumber>
<AlertRules>
<Status>RUNNING</Status>
<AlertVersion>1</AlertVersion>
<TaskId>0</TaskId>
<MetricParam>
<Type>TXN</Type>
<AppId>537118</AppId>
<AppGroupId>DEFAULT</AppGroupId>
<Dimensions>
<Type>ALL</Type>
<Value></Value>
<Key>rpc</Key>
</Dimensions>
<Pid>9870ca99-8105-4da7-a3a4-d72dd1b1****</Pid>
</MetricParam>
<Config>{"continuous":false,"dataRevision":2,"ownerId":"1084900439941126"}</Config>
<CreateTime>1594195623000</CreateTime>
<AlertWays>SMS</AlertWays>
<AlertWays>MAIL</AlertWays>
<AlertWays>DING_ROBOT</AlertWays>
<TaskStatus></TaskStatus>
<AlarmContext>
<AlarmContentTemplate>报警名称:$报警名称\n筛选条件: $筛选\n报警时间: $报警时间\n报警内容: $报警内容\n注意!:该报警未收到恢复邮件之前,正在持续报警中,24小时后会再次提醒您!</AlarmContentTemplate>
<AlarmContentSubTitle></AlarmContentSubTitle>
</AlarmContext>
<AlertType>7</AlertType>
<ContactGroupIdList>572*</ContactGroupIdList>
<Notice>
<EndTime>1480607940000</EndTime>
<NoticeStartTime>1480521600000</NoticeStartTime>
<StartTime>1480521600000</StartTime>
<NoticeEndTime>1480607940000</NoticeEndTime>
</Notice>
<UserId>113197164949****</UserId>
<AlertTitle>TestAlertRule</AlertTitle>
<UpdateTime>1594195623000</UpdateTime>
<AlertLevel>WARN</AlertLevel>
<Id>123</Id>
<RegionId>cn-hangzhou</RegionId>
<AlertRule>
<Operator>|</Operator>
<Rules>
<NValue>5</NValue>
<Operator>CURRENT_GTE</Operator>
<Aggregates>AVG</Aggregates>
<Alias>调用响应时间_ms</Alias>
<Measure>appstat.transaction.rt</Measure>
<Value>2000</Value>
</Rules>
<Rules>
<NValue>5</NValue>
<Operator>CURRENT_GTE</Operator>
<Aggregates>AVG</Aggregates>
<Alias>调用错误次数</Alias>
<Measure>appstat.transaction.error</Measure>
<Value>1</Value>
</Rules>
</AlertRule>
</AlertRules>
</PageBean>
<RequestId>34ED024E-9E31-434A-9E4E-D9D15C3C****</RequestId>
</SearchAlertRulesResponse>
JSON
格式
{
"PageBean": {
"TotalCount": 1,
"PageSize": 10,
"PageNumber": 1,
"AlertRules": [
{
"Status": "RUNNING",
"AlertVersion": 1,
"TaskId": 0,
"MetricParam": {
"Type": "TXN",
"AppId": "537118",
"AppGroupId": "DEFAULT",
"Dimensions": [
{
"Type": "ALL",
"Value": "",
"Key": "rpc"
}
],
"Pid": "9870ca99-8105-4da7-a3a4-d72dd1b1****"
},
"Config": "{\"continuous\":false,\"dataRevision\":2,\"ownerId\":\"1084900439941126\"}",
"CreateTime": 1594195623000,
"AlertWays": [
"SMS",
"MAIL",
"DING_ROBOT"
],
"TaskStatus": "",
"AlarmContext": {
"AlarmContentTemplate": "报警名称:$报警名称\n筛选条件: $筛选\n报警时间: $报警时间\n报警内容: $报警内容\n注意!:该报警未收到恢复邮件之前,正在持续报警中,24小时后会再次提醒您!",
"AlarmContentSubTitle": ""
},
"AlertType": 7,
"ContactGroupIdList": "572*",
"Notice": {
"EndTime": 1480607940000,
"NoticeStartTime": 1480521600000,
"StartTime": 1480521600000,
"NoticeEndTime": 1480607940000
},
"UserId": "113197164949****",
"AlertTitle": "TestAlertRule",
"UpdateTime": 1594195623000,
"AlertLevel": "WARN",
"Id": 123,
"RegionId": "cn-hangzhou",
"AlertRule": {
"Operator": "|",
"Rules": [
{
"NValue": 5,
"Operator": "CURRENT_GTE",
"Aggregates": "AVG",
"Alias": "调用响应时间_ms",
"Measure": "appstat.transaction.rt",
"Value": 2000
},
{
"NValue": 5,
"Operator": "CURRENT_GTE",
"Aggregates": "AVG",
"Alias": "调用错误次数",
"Measure": "appstat.transaction.error",
"Value": 1
}
]
}
}
]
},
"RequestId": "34ED024E-9E31-434A-9E4E-D9D15C3C****"
}
在文档使用中是否遇到以下问题
更多建议
匿名提交