开发者社区> 问答> 正文

云监控创建报警规则


创建报警规则
描述
创建报警规则,可以为某一个实例创建报警规则,也可以为多个实例同时创建报警规则。
请求方式
POST
请求参数

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

返回参数
名称类型描述
DataString返回的报警规则id
SuccessBoolean请求是否成功
RequestIdString请求的uuid,便于查询日志
CodeString请求失败状态码,200为成功,非200为失败
MessageString请求失败的提示信息

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

示例
  • 请求示例
  1. [backcolor=transparent]http[backcolor=transparent]:[backcolor=transparent]//metrics.cn-hangzhou.aliyuncs.com/
  2. [backcolor=transparent]POST[backcolor=transparent]请求体数据内容:
  3. [backcolor=transparent]Name[backcolor=transparent]:[backcolor=transparent] test_alarm
  4. [backcolor=transparent]Namespace[backcolor=transparent]:[backcolor=transparent] acs_ecs_dashboard
  5. [backcolor=transparent]MetricName[backcolor=transparent]:[backcolor=transparent] vm[backcolor=transparent].[backcolor=transparent]MemoryUtilization
  6. [backcolor=transparent]Dimensions[backcolor=transparent]:[{[backcolor=transparent]"instanceId"[backcolor=transparent]:[backcolor=transparent]"<your_ instanceId >"[backcolor=transparent],[backcolor=transparent]"userId"[backcolor=transparent]:[backcolor=transparent]"<your_ userId >"[backcolor=transparent]}]
  7. [backcolor=transparent]Period[backcolor=transparent][backcolor=transparent]900
  8. [backcolor=transparent]Statistics[backcolor=transparent][backcolor=transparent]Average
  9. [backcolor=transparent]ComparisonOperator[backcolor=transparent]:<=
  10. [backcolor=transparent]Threshold[backcolor=transparent][backcolor=transparent]35
  11. [backcolor=transparent]EvaluationCount[backcolor=transparent][backcolor=transparent]2
  12. [backcolor=transparent]ContactGroups[backcolor=transparent]:[[backcolor=transparent]"testgroup"[backcolor=transparent]]
  13. [backcolor=transparent]StartTime[backcolor=transparent][backcolor=transparent]6
  14. [backcolor=transparent]EndTime[backcolor=transparent][backcolor=transparent]20
  15. [backcolor=transparent]NotifyType[backcolor=transparent][backcolor=transparent]1
  • 返回示例

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

JSON格式
  1. [backcolor=transparent]{
  2. [backcolor=transparent]    [backcolor=transparent]"Data"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"0c4af0f1-a864-468b-bed3-15c7deff75ee"[backcolor=transparent],[backcolor=transparent]
  3. [backcolor=transparent]    [backcolor=transparent]"RequestId"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"910ABE4E-DC9D-4231-9DC0-C96835553327"[backcolor=transparent],[backcolor=transparent]
  4. [backcolor=transparent]    [backcolor=transparent]"Success"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]true[backcolor=transparent],[backcolor=transparent]
  5. [backcolor=transparent]    [backcolor=transparent]"Code"[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"200"
  6. [backcolor=transparent]}

展开
收起
反向一觉 2017-10-31 13:49:43 1929 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
《阿里云云拨测发布》PDF 立即下载
智能告警:IT系统神经中枢 立即下载
ARMS 智能告警套件最佳实践 立即下载