全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
云监控

查看报警规则详情

更新时间:2017-06-27 14:40:41

描述

查询指定或全部报警规则设置。

请求类型

GET/POST

请求参数

名称 类型 是否必须 描述
Action String 必选 系统规定参数,取值:ListAlarm
Namespace String 必选 产品名称,参考各产品对应的project,例如 acs_ecs_dashboard, acs_rds_dashboard等
Id String 可选 报警规则的id
Name String 可选 报警规则名称,支持模糊查询
Dimensions String 可选 规则关联的实例信息,为json object对应的字符串,例如{“instacnce”:”name1”}。可以查询用于查询关联该实例的所有规则,应用该字段时必须指定Namespace
State String 可选 报警规则状态, ALARM, INSUFFICIENT_DATA,OK
IsEnable Boolean 可选 true为启用,false为禁用
PageNumber Int 可选 页码,默认值:1
PageSize Int 可选 每页记录数,默认值:100

返回参数

名称 类型 描述
NextToken Integer 下一页,为空代表没有下一页
AlarmList List 报警规则详情列表
Total Integer 符合条件数据总数
Success Boolean 请求是否成功
RequestId String 请求的uuid,便于查询日志
Code String 请求失败状态码,200为成功,非200为失败
Message String 请求失败的提示信息

Alarm的参数

名称 类型 描述
Id String 报警规则id
Name String 报警规则名称
Namespace String 报警规则对应的产品
MetricName String 报警规则对应的监控项
Dimensions String 报警规则关联的实例列表,为json array对应的字符串,例如[{“instanceId”:”name1”},{“iinstance”:”name2”}]
Period Int 查询指标的周期,单位秒
Statistics String 统计方法,例如Average、Maximum、Minimum
ComparisonOperator String 比较符
Threshold String 阈值
EvaluationCount Int 连续探测几次都满足阈值条件时报警,默认3次
ContactGroups String 通知的联系组,为json array对应的string,如 [“联系组1”,”联系组2”]
StartTime Int 生效时间的开始时间
EndTime Int 生效时间的结束时间
SilenceTime Int 一直处于报警的沉默周期,单位为秒
NotifyType Int 通知类型,值为0是旺旺+邮件,值为1是旺旺+邮件+短信
Enable Boolean 该规则是否启用,true为启动
State String 报警规则的状态,有一个实例报警就是ALARM,所有都没数据是INSUFFICIENT_DATA,其它情况为OK

错误编码

错误代码 描述 语义
400 Bad Request 客户端请求中的语法错误
403 Forbidden 没有权限
404 Not Found 客户端错误,未找到
500 Internal Server Error 服务器内部错误
200 OK 正常

示例

  • 请求示例
  1. http://metrics.cn-hangzhou.aliyuncs.com/?Action=ListAlarm
  2. &PageSize=2
  3. &Dimension=%7B%22instanceId%22%3A%22 i-abcdefgh123456%22%7D
  4. &Namespace=acs_ecs_dashboard
  5. &PageNumber=1
  6. &<公共请求参数>
  • 返回示例

XML格式

  1. <ListAlarmResponse>
  2. <NextToken>2</NextToken>
  3. <RequestId>CC2CDD2B-4EA5-43CD-BEE3-758E93C36B7F</RequestId>
  4. <AlarmList>
  5. <Alarm>
  6. <Period>300</Period>
  7. <Statistics>Average</Statistics>
  8. <Name>ecs_cpu_total</Name>
  9. <MetricName>cpu_total</MetricName>
  10. <State>OK</State>
  11. <Threshold>90</Threshold>
  12. <Enable>true</Enable>
  13. <SilenceTime>86400</SilenceTime>
  14. <NotifyType>1</NotifyType>
  15. <Dimensions>["{\"instanceId\":\" i-abcdefgh123456\"}"]</Dimensions>
  16. <Namespace>acs_ecs_dashboard</Namespace>
  17. <ContactGroups>["test4nudou"]</ContactGroups>
  18. <Id>putNewAlarm_group_e8da18b9-bc95-4edf-a8bf-159eb6c8286b</Id>
  19. <EndTime>24</EndTime>
  20. <StartTime>0</StartTime>
  21. <ComparisonOperator>&gt;=</ComparisonOperator>
  22. </Alarm>
  23. <Alarm>
  24. <Period>300</Period>
  25. <Statistics>Average</Statistics>
  26. <Name>ecs_diskusage_utilization</Name>
  27. <MetricName>diskusage_utilization</MetricName>
  28. <State>OK</State>
  29. <Threshold>90</Threshold>
  30. <Enable>true</Enable>
  31. <SilenceTime>86400</SilenceTime>
  32. <NotifyType>1</NotifyType>
  33. <Dimensions>["{\"instanceId\":\" i-abcdefgh123456\"}"]</Dimensions>
  34. <Namespace>acs_ecs_dashboard</Namespace>
  35. <ContactGroups>["test4nudou"]</ContactGroups>
  36. <Id>putNewAlarm_group_3233eba5-0dd4-4e80-a5d5-7399dec3d7cc</Id>
  37. <EndTime>24</EndTime>
  38. <StartTime>0</StartTime>
  39. <ComparisonOperator>&gt;=</ComparisonOperator>
  40. </Alarm>
  41. </AlarmList>
  42. <Success>true</Success>
  43. <Code>200</Code>
  44. <Total>27</Total>
  45. </ListAlarmResponse>

JSON格式

  1. {
  2. "NextToken": 2,
  3. "RequestId": "EFD27F56-5799-4CE8-B625-56DF3332331C",
  4. "AlarmList": {
  5. "Alarm": [
  6. {
  7. "Period": 300,
  8. "Statistics": "Average",
  9. "Name": "ecs_cpu_total",
  10. "MetricName": "cpu_total",
  11. "State": "OK",
  12. "Threshold": "90",
  13. "Enable": true,
  14. "SilenceTime": 86400,
  15. "NotifyType": 1,
  16. "Dimensions": "[\"{\\\"instanceId\\\":\\\" i-abcdefgh123456\\\"}\"]",
  17. "Namespace": "acs_ecs_dashboard",
  18. "ContactGroups": "[\"test4nudou\"]",
  19. "Id": "putNewAlarm_group_e8da18b9-bc95-4edf-a8bf-159eb6c8286b",
  20. "EndTime": 24,
  21. "StartTime": 0,
  22. "ComparisonOperator": ">="
  23. },
  24. {
  25. "Period": 300,
  26. "Statistics": "Average",
  27. "Name": "ecs_diskusage_utilization",
  28. "MetricName": "diskusage_utilization",
  29. "State": "OK",
  30. "Threshold": "90",
  31. "Enable": true,
  32. "SilenceTime": 86400,
  33. "NotifyType": 1,
  34. "Dimensions": "[\"{\\\"instanceId\\\":\\\" i-abcdefgh123456\\\"}\"]",
  35. "Namespace": "acs_ecs_dashboard",
  36. "ContactGroups": "[\"test4nudou\"]",
  37. "Id": "putNewAlarm_group_3233eba5-0dd4-4e80-a5d5-7399dec3d7cc",
  38. "EndTime": 24,
  39. "StartTime": 0,
  40. "ComparisonOperator": ">="
  41. }
  42. ]
  43. },
  44. "Success": true,
  45. "Code": "200",
  46. "Total": 27
  47. }
本文导读目录