产品文档

云监控

2022-03-16 13:05:16

describeAlarm

描述

查询规则详情

请求方式

GET

请求地址

https://monitor.jdcloud-api.com/v2/groupAlarms/{alarmId}

名称 类型 是否必需 默认值 描述
alarmId String True 规则id

请求参数

返回参数

名称 类型 描述
result Result
requestId String 请求的标识id

Result

名称 类型 描述
alarmId String 报警规则ID
alarmStatus Long 规则状态,当一个规则下同时存在报警、数据不足、正常的资源时,规则状态按 报警>数据不足>正常的优先级展示
监控项状态:-1 未启用 1正常,2告警,4数据不足
alarmStatusList Long[ ] 规则的状态列表,可能同时存在多个:1正常,2告警,4数据不足
baseContact BaseContact[ ] 告警通知联系人
createTime String 创建时间
dimension String 资源维度
dimensionName String 资源维度名称
enabled Long 是否启用, 1表示启用规则,0表示禁用规则,默认为1
multiWebHook WebHookOption[ ] url回调设置数组
noticeOption NoticeOption[ ] 通知策略
product String 资源类型
productName String 资源类型名称
resourceOption ResourceOption
ruleName String 规则名称,规则名称,最大长度42个字符,只允许中英文、数字、''-''和"_"
ruleOption RuleOptionDetail
ruleType String 规则类型, 默认为resourceMonitor
ruleVersion String 规则版本 v1 v2
tags Object 资源维度,指定监控数据实例的维度标签,如resourceId=id。(请确认资源的监控数据带有该标签,否则规则会报数据不足)
webHookOption WebHookOption

WebHookOption

名称 类型 描述
webHookContent String 回调content 注:仅webHookUrl和webHookProtocol均不为空时,才会创建webHook。当前支持的变量:${resourceId},${resourceName},${ipAddress},${requestId},${metric},${currentValue},${times},${tags},${alertTime},${region},${threshold},${serviceCode},${asGroupId},${unhealthyInstance}
webHookProtocol String webHook协议
webHookSecret String 回调secret,用户请求签名,防伪造
webHookUrl String 回调url

RuleOptionDetail

名称 类型 描述
rules BasicRuleDetail[ ] 规则触发条件,与模板参数同时指定时,优先使用rules
templateOption TemplateOption

TemplateOption

名称 类型 描述
templateId String 模板Id
templateType Long 模板类型.1-默认模板 2-自定义模板

BasicRuleDetail

名称 类型 描述
calculateUnit String 指标的计算单位,比如bit/s、%、k等
calculation String 统计方法,必须与定义的metric一致,可选值列表:avg,sum,max,min
downSample String 降采样函数
metric String 监控项唯一标识,可根据DescribeMetricsForCreateAlarm接口查询各产品线可用的监控项(创建规则时使用Metric字段)。格式:metric:downsample
metricName String 监控项名称
noticeLevel NoticeLevel
operation String 报警比较符,只能为以下几种lte(<=),lt(<),gt(>),gte(>=),eq(==),ne(!=)
period Long 查询指标的周期,单位为分钟,目前支持的取值:1,2,5,10,15,30,60
threshold Double 报警阈值,目前只开放数值类型功能
times Long 连续探测几次都满足阈值条件时报警,可选值:1,2,3,5,10,15,30,60

NoticeLevel

名称 类型 描述
custom Boolean 是否为用户自己定义的级别,自定义(true) or 固定(false)
levels Object 报警级别以及对应的阈值,是一个map[string]float64对象。key:common(一般)、critical(严重)、 fatal(紧急),value:各报警级别对应的阀值,要符合operation参数对应的递进关系。 eg: "levels":{"common":1000,"critical":10000,"fatal":15000}

ResourceOption

名称 类型 描述
resourceItems ResourceItem[ ] 指定具体资源ID设置报警规则,每次最多100个。优先resourceItems生效
tagsOption TagsOption
resourceGroups String[ ] 指定资源组设置报警规则
resourceFilterType Long 资源筛选的类型,1:指定具体资源 2:标签筛选 3:资源组筛选

TagsOption

名称 类型 描述
operator String 操作项(多个tagFilter之间关关系)默认是or
tags TagFilter[ ] 资源标签,对所有符合该标签的资源设置报警规则,对于新加入该标签的资源自动生效

TagFilter

名称 类型 描述
key String Tag键
values String[ ] Tag值

ResourceItem

名称 类型 描述
region String 资源所属的region
resourceId String 资源id

NoticeOption

名称 类型 描述
effectiveIntervalEnd String 生效截止时间,默认值:23:59:59
effectiveIntervalStart String 生效起始时间,默认值:00:00:00
noticeCondition Long[ ] 通知条件 1-告警 2-数据不足3-告警恢复
noticePeriod Long 通知沉默周期,单位:分钟,默认值:24小时,目前支持的取值“24小时、12小时、6小时、3小时、1小时、30分钟、15分钟、10分钟、5分钟”
noticeWay Long[ ] 通知方法 1-短信 2-邮件

BaseContact

名称 类型 描述
referenceId Long 联系人id。 注:ReferenceType=2时,联系人id请填0
referenceType Long 联系人id类型:0,联系人分组id;1,联系人id,2,pin帐号主联系人

返回码

返回码 描述
200 查询规则返回结果
文档反馈

开始与售前顾问沟通

可直接拨打电话 400-098-8505转1

我们的产品专家为您找到最合适的产品/解决⽅案

在线咨询 5*8⼩时

1v1线上咨询获取售前专业咨询

点击咨询
企微服务助手

专业产品顾问,随时随地沟通