创建一个告警策略。
ServiceName : Volc_Observe Region : cn-beijing AccessKey : xxx SecretKey : xxx
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateRule | 接口名称。当前 API 的名称为 CreateRule 。 |
Version | String | 是 | 2018-01-01 | 接口版本。当前 API 的版本为 2018-01-01 。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
RuleName | String | 是 |
| 告警策略名称。
|
Description | String | 否 |
| 策略描述。
|
RuleType | String | 是 |
| 告警策略的类型。
|
Namespace | String | 是 | VCM_ECS | 此策略的监控指标所属的产品空间。参见云产品监控指标下各产品的Namespace。 |
SubNamespace | String | 是 | Instance | 此策略引用的指标所属的维度。参见云产品监控指标下各产品的SubNamespace。 |
Level | String | 是 |
| 告警级别。
|
Conditions | Array of RuleCondition | 是 |
| 告警条件。 |
OriginalDimensions | JSON Map | 是 | - | 告警资源。 |
EvaluationCount | Integer | 是 | 5 | 触发告警需要持续的周期。单位为分钟。支持配置为1、3、5、10、15、30、60、120。 |
EffectStartAt | String | 是 | 00:00 | 策略生效窗口的开始时间。表达方式为HH:MM。 |
EffectEndAt | String | 是 |
| 策略生效窗口的截止时间。表达方式为HH:MM。
|
EnableState | String | 是 |
| 开启状态。
|
Regions | Array of String | 是 |
| 当前云产品的所属可用区。
|
SilenceTime | Integer | 是 | 5 | 告警发送周期。单位为分钟。支持配置为5、10、15、30、60、180、360、720、1440。 |
Webhook | String | 否 | http://alert.volc.com/callback | 告警发生时回调的地址。限制条件,请参见告警回调使用说明 。 |
WebhookIds | Array of String | 否 | ["1"] | 告警回调ID列表。WebhookIds和Webhook参数二选一,不能同时填写。 |
ConditionOperator | String | 否 |
| 多指标判定条件。
|
RecoveryNotify | Object of RecoveryNotify | 否 | - | 告警恢复通知。 |
AlertMethods | Array of String | 是 |
| 告警策略的通知方式。
|
ContactGroupIds | Array of String | 否 |
| 告警通知组ID列表。
|
MultipleConditions | Boolean | 否 |
| 告警策略是否用多指标。
|
NoData | Object of NoData | 否 | - | 无数据告警。 |
DimensionConditions | Object of DimensionConditions | 否 | - | dimension配置。目前仅在RuleType为dynamic时有效,支持 project、tag、meta三种匹配方式。 |
NotifyMode | String | 否 |
| 告警发送聚合策略。
|
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
MetricName | String | 否 | Instance_CpuBusy | 监控指标的名称。参见云产品监控指标下各产品的MetricName。 |
Statistics | String | 否 |
| 统计方法。目前支持avg、max、min。 |
ComparisonOperator | String | 否 |
| 比较符号。支持普通阈值告警: >、>=、<、<=、!=、= ,以及以下同环比告警:
|
Threshold | String | 否 |
| 此指标的判断阈值。
|
MetricUnit | String | 否 |
| 监控指标的单位。参见云产品监控指标下各产品的MetricUnit。 说明
|
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
key | String | 是 | ResourceID | 指标的Dimensions名称,例如:ResourceID、NodeName等。 |
value | Array of String | 是 |
| 指标的Dimension的值,是一个数组。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Enable | Boolean | 否 | true | 是否开启告警恢复通知。默认自动开启。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Enable | Boolean | 否 | true | 是否开启无数据告警。默认关闭。 |
EvaluationCount | Integer | 否 |
| 连续几次检测无数据才告警。
|
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Type | String | 否 |
| Dimensions类型。
|
TagCondition | Object of TagCondition | 否 | - | Type为tag时必填,标签的匹配条件。 |
MetaCondition | Object of MetaCondition | 否 | - | Type为meta时必填,资源名称的匹配条件。 |
ProjectCondition | Object of ProjectCondition | 否 | - | Type为project时必填,项目的匹配条件。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Tags | Array of KVComparator | 否 |
| 标签列表。
|
Condition | String | 否 |
| 判断条件。
|
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Metas | Array of MetaKVComparator | 否 |
| 资源列表。
|
Condition | String | 否 |
| 判断条件。
|
AllDimensions | Boolean | 否 |
| 是否为全量资源。
|
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Projects | Array of String | 否 | ["testDefault1", "testDefault2"] | 项目名称列表。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Key | String | 否 | testKey | 标签的key。 |
Values | Array of String | 否 |
| 标签的key对应的value。
|
Comparator | String | 否 |
| 比较符。
|
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Key | String | 否 | ResourceName | 资源的Key。目前只能配置为ResourceName。 |
Values | Array of String | 否 |
| 资源的Values。
|
Comparator | String | 否 |
| 比较符。
|
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Array of String | ["1354766247190******"] | 告警策略ID。 |
POST https://open.volcengineapi.com?Action=CreateRule&Version=2018-01-01 ServiceName: Volc_Observe Region: cn-beijing AccessKey: xxx SecretKey: xxx { "RuleName": "testabc", "RuleType": "static", "Namespace": "VCM_ECS", "SubNamespace": "Instance", "Regions": [ "cn-beijing" ], "Conditions": [ { "MetricName": "Instance_CpuBusy", "Statistics": "avg", "ComparisonOperator": ">", "Threshold": "4", "MetricUnit": "Percent" }, { "MetricName": "MemoryUsedUtilization", "Statistics": "avg", "ComparisonOperator": ">", "Threshold": "3", "MetricUnit": "Percent" } ], "EffectStartAt": "00:00", "EffectEndAt": "23:59", "MultipleConditions": true, "Level": "critical", "SilenceTime": 5, "EnableState": "enable", "OriginalDimensions": { "ResourceID": [ "i-123oiuoiu23uiow*****","i-123oiuoiu23uiow*****" ] }, "ConditionOperator": "&&", "EvaluationCount": 1, "NoData": { "Enable": true, "EvaluationCount": 10 }, "NotifyMode": "rule", "WebHook":"http://alert.volc.com/callback", "RecoveryNotify": { "Enable": true } }
{ "ResponseMetadata": { "RequestId": "", "Action": "CreateRule", "Version": "2018-01-01", "Service": "", "Region": "" }, "Result": { "Data": [ "1354766247190******" ] } }
本接口无特有的错误码。更多信息请参见错误码。