全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
云监控

创建报警规则

更新时间:2017-06-07 13:26:11

创建报警规则

描述

创建报警规则,可以为某一个实例创建报警规则,也可以为多个实例同时创建报警规则。

请求方式

POST

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:CreateAlarm
Name String 必选 报警规则名称
Namespace String 必选 产品名称,参考各产品对应的project,例如acs_ecs_dashboard, acs_rds_dashboard等
MetricName String 必选 相应产品对应的监控项名称,参考各产品metric定义
Dimensions String 必选 报警规则对应实例列表,为json array对应的string,例如[{“instanceId”:”name1”},{“iinstance”:”name2”}]
Period Integer 可选 查询指标的周期,必须与定义的metric一致,默认300,单位为秒
Statistics String 必选 统计方法,必须与定义的metric一致,例如Average
ComparisonOperator String 必选 报警比较符,只能为以下几种<=,<,>,>=,==,!=
Threshold String 必选 报警阈值,目前只开放数值类型功能
EvaluationCount Int 可选 连续探测几次都满足阈值条件时报警,默认3次
ContactGroups String 必选 报警规则通知的联系组,必须在控制台上已创建,为json array对应的string,例如 [“联系组1”,”联系组2”]
StartTime Int 可选 报警生效时间的开始时间,默认0,代表0点
EndTime Int 可选 报警生效时间的结束时间,默认24,代表24点
SilenceTime Int 可选 一直处于报警状态的通知沉默周期,默认86400,单位s,最小1小时
NotifyType Int 可选 通知类型,为0是旺旺+邮件,为1是旺旺+邮件+短信

返回参数

名称 类型 描述
Data String 返回的报警规则id
Success Boolean 请求是否成功
RequestId String 请求的uuid,便于查询日志
Code String 请求失败状态码,200为成功,非200为失败
Message String 请求失败的提示信息

错误编码

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

示例

  • 请求示例
  1. http://metrics.cn-hangzhou.aliyuncs.com/
  2. POST请求体数据内容:
  3. Name: test_alarm
  4. Namespace: acs_ecs_dashboard
  5. MetricName: vm.MemoryUtilization
  6. Dimensions:[{"instanceId":"<your_ instanceId >","userId":"<your_ userId >"}]
  7. Period900
  8. StatisticsAverage
  9. ComparisonOperator:<=
  10. Threshold35
  11. EvaluationCount2
  12. ContactGroups:["testgroup"]
  13. StartTime6
  14. EndTime20
  15. NotifyType1
  • 返回示例

XML格式

  1. <CreateAlarmResponse>
  2. <Data>576fbae7-2fd1-411a-ae13-6f09f4fafdde</Data>
  3. <RequestId>58C699ED-84BE-44D5-B55F-84AFE73932AB</RequestId>
  4. <Success>true</Success>
  5. <Code>200</Code>
  6. </CreateAlarmResponse>

JSON格式

  1. {
  2. "Data": "0c4af0f1-a864-468b-bed3-15c7deff75ee",
  3. "RequestId": "910ABE4E-DC9D-4231-9DC0-C96835553327",
  4. "Success": true,
  5. "Code": "200"
  6. }
本文导读目录