tencent cloud

腾讯云可观测平台

动态与公告
产品动态
产品简介
产品概述
产品优势
基本功能
基本概念
应用场景
使用限制
购买指南
云产品监控
应用性能监控
终端性能监控
前端性能监控
云拨测
Prometheus 监控服务
Grafana 服务
事件总线
云压测
快速入门
监控概览
实例分组
云产品监控
应用性能监控
云拨测
云压测
Prometheus 监控服务
Grafana 服务
创建 Dashboard
事件总线
告警服务
云产品监控
云产品监控指标
控制台操作指南
云服务器监控组件
云产品监控对接 Grafana
故障处理
实践教程
应用性能监控
应用性能监控简介
接入指南
控制台操作指南
实践教程
参考信息
常见问题
终端性能监控
终端性能监控概述
控制台操作指南
接入指南
实践教程
前端性能监控
前端性能监控简介
控制台操作指南
接入指南
常见问题
云拨测
产品简介
控制台操作指南
常见问题
云压测
云压测概述
控制台操作指南
实践教程
JavaScript API 列表
常见问题
Prometheus 监控
Prometheus 监控简介
接入指南
控制台操作指南
实践教程
Terraform
常见问题
Grafana 服务
产品简介
控制台操作指南
Grafana 平台常用功能指引
常见问题
Dashboard
什么是 Dashboard
控制台操作指南
告警管理
控制台操作指南
故障处理
常见问题
事件总线
事件总线简介
控制台操作指南
实践教程
常见问题
报表管理
常见问题
腾讯云可观测平台常见问题
告警服务相关
一般性问题
监控图表相关
云服务器监控组件相关
动态阈值告警相关
云监控对接 Grafana 相关
文档阅读指南
相关协议
应用性能监控服务等级协议
APM 隐私协议
APM 数据处理和安全协议
前端性能监控服务等级协议
终端性能监控服务等级协议
云拨测服务等级协议
Prometheus 监控服务服务等级协议
Grafana 服务服务等级协议
云压测服务等级协议
云压测使用限制
Cloud Monitor Service Level Agreement
词汇表

使用 API 创建告警策略

PDF
聚焦模式
字号
最后更新时间: 2025-10-27 17:54:34
本文将为您介绍如何通过 创建告警策略接口API绑定策略对象API 创建告警策略并绑定告警对象。

准备工作

在调用创建 创建告警策略接口API 前需要准备以下入参资料。

准备个人密钥

1. 登录访问管理控制台 API 密钥管理 页面。
2. 单击显示即可获取 SecretKey。
说明:
如未创建密钥,请单击新建密钥创建密钥。

准备告警策略类型

通过 查询所有名字空间API 可以查询到所有策略类型。步骤如下:
1. 进入 API Explorer 在线调用控制台,参考下表填写输入参数。
参数名称
说明
SecretId、SecretKey
填写准备好的 SecretId、SecretKey
Region
选择对应的地域
SceneType
填写:ST_ALARM
Module
填写:monitor
MonitorTypes.N
非必填,无需填写
2. 单击在线调用>发送请求,获取响应结果。返回结果中 Response.QceNamespacesNew.N.Id 即创建告警策略需要的 Namespace。
注意:
此处 Namespace 为告警策略类型,与拉取监控数据时的云产品 Namespace 不同。

准备指标列表

通过 查询告警指标列表API 可以查询到策略类型下的所有告警指标。
1. 进入 API Explorer 在线调用控制台,参考下表填写输入参数。
参数名称
说明
SecretId、SecretKey
填写准备好的 SecretId、SecretKey
Region
选择对应的地域
Module
填写:monitor
MonitorType
填写:MT_QCE
Namespace
填写“准备告警策略类型”步骤获取的告警策略类型,即返回结果中的 Response.QceNamespacesNew.N.Id
2. 单击右侧在线调用>发送请求,获取响应结果。返回结果中 Response.Metrics.N 即该策略类型下的所有告警指标。

准备事件列表

通过 查询告警事件列表API 可以查询到策略类型下的所有告警指标。
1. 进入 API Explorer 在线调用控制台,参考下表填写输入参数。
参数名称
说明
SecretId、SecretKey
填写准备好的 SecretId、SecretKey
Region
选择对应的地域
Module
填写:monitor
Namespace
填写“准备告警策略类型”步骤获取的告警策略类型,即返回结果中的 Response.QceNamespacesNew.N.Id
2. 单击在线调用>发送请求,获取响应结果。返回结果 Response.Events.N.EventName 即告警策略需要的 EventName。

实践步骤

本文提供以下示例,为您介绍如何使用 创建告警策略接口API 等接口创建云服务器-基础监控告警策略。

创建告警策略

2. 准备好的个人密钥 对应复制到对应的 SecretId、SecretKey 文本框。
3. 输入参数配置项找到 Region,选择相关地域。
4. 在 Module 中填写“monitor”,PolicyName 中填写策略名称(策略名称由您自定义),MonitorType 中填写“MT_QCE”。
5. 在 Namespace 中填写上述 准备告警策略类型 步骤中获取的告警策略类型。例如,云服务器-基础监控告警策略类型为 cvm_device。
6. 在云服务器-基础监控场景下 Remark、Enable 为选填,ProjectId 为必填。
Remark:备注,可不填。
Enable:是否启用告警策略。0=停用,1=启用。可不传,默认为1。
ProjectId:项目 Id。云服务器-基础监控需填写0
说明:
ProjectId 项目 Id,-1=无项目,0=默认项目,根据策略类型而定可不传,默认为-1。例如部分告警策略类型下无项目概念(例如私有网络),可使用默认传参-1 。若该告警策略类型有项目概念(例如云服务器-基础监控),默认传参-1会报错,入参需要修改为0。
7. Condition 配置说明如下:
参数名称
是否必填
说明
IsUnionRule
指标触发与或条件,0=或,1=与,或表示触发任一条件时发送告警,与为触发所有条件后发送告警
Rules.N
告警触发条件列表。可参考在线调用 AlarmPolicyRule 参数说明进行配置
MetricName:填写 准备指标列表 步骤返回中的 MetricName(Metrics.N.MetricName)
Period:填写 准备指标列表 步骤返回中的 Period(Metrics.N.MetricConfig.Period)
Operator:填写 准备指标列表 步骤返回中的 Operator(Metrics.N.MetricConfig.Operator)
Value:填写阈值,不需要填写单位,例如80
ContinuePeriod:填写 准备指标列表 步骤返回中的 ContinuePeriod(Metrics.N.MetricConfig.ContinuePeriod)
NoticeFrequency:告警频率(按秒计算)。参数说明:告警间隔,0=不重复 ;300=每5分钟告警一次; 600=每10分钟告警一次 ;900=每15分钟告警一次 1800=每30分钟告警一次;3600=每1小时告警一次; 7200=每2小时告警一次 ;10800=每3小时告警一次; 21600=每6小时告警一次; 43200=每12小时告警一次 ;86400=每1天告警一次
IsPowerNotice:告警频率是否指数增长,0=否,1=是
其他参数无需填写

8. 如需触发事件告警,需要填 EventCondition 参数。在 EventCondition 下,仅需要在 Rules.N.MetricName 中填写 准备事件列表 步骤获得的 EventName,其他参数可不填。
9. 在 NoticeIds.N 填写告警通知模板 Id ,例如 notice-qvq836vc。可通过 查询通知模板列表API 获得。
10. 填写完以上参数后,单击在线调用>发送请求,如下图为成功创建云服务器—基础监控告警策略。
11. 创建成功后,即可在腾讯云可观测平台控制台 告警策略 页面查看该告警策略。

绑定告警对象

2. 准备好的个人密钥 对应复制到对应的 SecretId、SecretKey 文本框。
3. 输入参数配置项找到 Region,选择相关地域。
4. 在 Module 中填写“monitor”。
5. 在 GroupId 中填写0。
6. InstanceGroupId 和 Dimensions 选一项填写,说明如下:
InstanceGroupId:实例分组 ID。如需按照实例分组绑定告警对象,则需要传实例分组 ID(例如1234),可在腾讯云可观测平台控制台 实例分组 页面中,单击对应的实例名称获取。
Dimensions.N: 如需按照实例 ID 绑定告警策略,则需要填写 Dimensions。说明如下:
参数名称
说明
RegionId、Region
请参见 实例地域说明,例如广州,RegionId 为1,Region 为 gz
Dimensions
填写云服务器实例 ID,可通过 查看实例列表API 获取。入参格式为:{"unInstanceId":"ins-xxxxxxxx'"}。
EventDimensions
填写实例全局唯一 ID,可通过 查看实例列表API 获取。入参格式为:{"uuid":"9d51a69e-0e4a-4120-ae58- 9c073c851e24"}
7. 在 PolicyId 中填写 创建告警策略 步骤返回的 PolicyId(Response.PolicyId)。例如 policy-zg2sk27j。
8. 填写完以上参数后,单击在线调用>发送请求,如下图即成功绑定告警策略。
9. 创建成功后, 即可在腾讯云可观测平台控制台 告警策略 页面查看对应告警策略关联实例数量。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈