- 最新动态
- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
- 常见问题
- 视频帮助
-
更多文档
-
用户指南(阿布扎比区域)
- 产品介绍
- 快速入门
- 监控看板
- 资源分组
- 使用告警功能
- 主机监控
- 自定义监控
- 事件监控
- 任务中心
- 数据转储
- 云服务监控
- 审计云监控服务操作记录
- 权限管理
- 配额调整
- 支持监控的服务列表
-
常见问题
- 产品咨询
-
主机监控
- 什么是插件修复配置?
- 怎样让新购ECS实例中带有操作系统监控功能?
- 裸金属服务器安装Agent后,裸金属实例为何出现在“主机监控 > 弹性云服务器”列表中?
- Agent支持的系统有哪些?
- Agent不同插件状态说明及处理方式
- Agent状态切换或监控面板有断点该如何处理?
- 业务端口被Agent占用该如何处理?
- 如何创建委托?
- 不能创建委托该如何处理?
- 委托被占用该如何处理?
- 委托已失效该如何处理?
- 主机监控Agent对主机的性能会有影响吗?
- Agent插件状态显示“故障”该如何处理?
- Agent插件状态显示“已停止”该如何处理?
- Agent插件状态显示“运行中”但没有数据该如何处理?
- 如何排查Agent一键修复失败问题?
- Agent一键修复后无监控数据问题排查
- 告警通知或误告警
- 监控数据异常
- 监控指标含义
- 用户权限
- API参考(阿布扎比区域)
- 用户指南(巴黎区域)
- API参考 (巴黎区域)
- 用户指南(吉隆坡区域)
- API参考(吉隆坡区域)
- 用户指南(安卡拉区域)
- API参考(安卡拉区域)
-
用户指南(阿布扎比区域)
- 通用参考
链接复制成功!
更新自定义告警模板
功能介绍
更新自定义告警模板。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
PUT /V1.0/{project_id}/alarm-template/{template_id}
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
项目ID。
获取方式请参见获取项目ID。
template_id
是
需要更新的自定义告警模板ID。
- 样例
PUT https://{云监控的endpoint}/V1.0/{project_id}/alarm-template/{template_id}
请求消息
- 请求参数
表2 请求参数 名称
是否必选
参数类型
说明
template_name
是
String
自定义告警模板名称,只能包含0-9/a-z/A-Z/_/-或汉字,长度为1-128。
template_description
否
String
自定义告警模板详细描述,长度为0-256。
namespace
是
String
创建自定义告警模板选择的资源类型,即服务命名空间,如选择弹性云服务器,则命名空间为SYS.ECS。
dimension_name
是
String
资源类型对应的指标监控维度,选择弹性云服务器,则维度为云服务器,dimension_name值为instance_id。
template_items
是
Array of objects
创建自定义告警模板添加一个或者多个指标的告警规则,目前最多可增加20组告警规则策略。
详细参数说明请参见表3。
表3 template_items字段数据结构说明 名称
是否必选
参数类型
说明
metric_name
是
String
告警模板添加的监控指标,如弹性云服务器可添加的监控指标为cpu_util等。
各资源的监控指标名称可查看支持监控的服务列表。
condition
是
Condition object
创建自定义告警模板的告警策略。
详细参数说明请参见表4。
alarm_level
否
Integer
设置告警级别,值为1、2、3、4。其中1为紧急,2为重要,3为次要,4为提示。
表4 condition字段数据结构说明 名称
是否必选
参数类型
说明
comparison_operator
是
String
告警阈值的比较条件,可以是>、=、<、>=、<=。
count
是
Integer
触发告警的连续发生次数,取值范围[1, 5]。
filter
是
String
数据聚合的方式,支持max、min、average、sum、variance,分别表示最大值、最小值、平均值、求和值、方差值。
period
是
Integer
监控数据粒度。
取值范围:
- 1,实时数据
- 300,5分钟粒度
- 1200,20分钟粒度
- 3600,1小时粒度
- 14400,4小时粒度
- 86400,1天粒度
unit
否
String
数据的单位,最大长度为32位。
value
是
Double
告警阈值。取值范围[0, Number.MAX_VALUE],Number.MAX_VALUE值为1.7976931348623157e+108。具体阈值取值请参见支持监控的服务列表中的取值范围,如支持监控的服务列表中ECS的CPU使用率cpu_util取值范围可配置80。
suppress_duration
否
Integer
发送告警的周期。值可为0、300、600、900、1800、3600、10800、21600、43200、86400。0表示只告警一次,300表示每5分钟告警一次,600表示每10分钟告警一次,900表示每15分钟告警一次,1800表示每30分钟告警一次,3600表示每1小时告警一次,10800表示每3小时告警一次,21600表示每6小时告警一次,43200表示每12小时告警一次,86400表示每1天告警一次。
- 请求样例
{ "template_name": "alarmTemplate-Test01", "template_description": "更新自定义告警模板", "namespace": "SYS.ECS", "dimension_name": "instance_id", "template_items": [ { "metric_name": "cpu_util", "condition": { "period": 1, "filter": "average", "comparison_operator": ">=", "value": 90, "unit": "%", "count": 3, "suppress_duration": 300 }, "alarm_level": 2 }, { "metric_name": "mem_util", "condition": { "period": 1, "filter": "average", "comparison_operator": ">=", "value": 90, "unit": "%", "count": 3, "suppress_duration": 600 }, "alarm_level": 2 } ] }
响应消息
无消息体。
返回值
错误码
请参考返回错误码说明。