alibabacloud-cms-alert-rule-create

阿里云告警规则管理

此技能用于创建和查询告警规则。系统会通过意图路由自动选择 CMS 1.0 或 CMS 2.0 工作流。

---

CLI 设置（执行前必需）

aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-cms-alert-rule-create"
aliyun plugin update

---

步骤 0：意图路由

确定用户的监控目标 → 路由到正确的工作流。请参阅 step0-intent-routing.md。

用户场景	路由到
云产品系统指标（ECS、RDS、SLB、OSS、Redis、MongoDB……）	CMS 1.0 工作流
Prometheus / APM / UModel / 自定义指标	CMS 2.0 工作流

---

支持的告警类型

版本	类型	创建 API	查询 API
CMS 1.0	云资源（ECS/RDS/SLB/OSS/Redis/MongoDB……）	PutResourceMetricRule	DescribeMetricRuleList
CMS 2.0	Prometheus（PROMETHEUS）	ManageAlertRules	QueryAlertRules
CMS 2.0	APM（APM）	ManageAlertRules	QueryAlertRules
CMS 2.0	UModel（UMODEL）	ManageAlertRules	QueryAlertRules

---

CMS 1.0 工作流

对于查询请求 → step-query.md

对于创建请求：

步骤	说明	参考
1	上下文锁定 — 命名空间、地域、实例	step1-context-lock.md
2	查询生成 — 通过 API 发现指标，并与用户意图匹配	step2-query-generation.md
3	检测配置 — 阈值、频率（默认 1min）	step3-detection-config.md
4	通知 — 查询联系人 → 选择或创建	step4-notification.md
5	预览并执行 — 显示摘要 → 确认 → CLI	step5-preview-execute.md
6	验证 — 检查状态	step6-verification.md

---

CMS 2.0 工作流

对于查询请求 → cms2-step-query.md

对于创建请求：

步骤	说明	参考
1	上下文锁定 — 构建 datasourceConfig（类型、instanceId、地域）	cms2-step1-context-lock.md
2	查询配置 — 构建 queryConfig（PromQL / APM 指标 / UModel 实体）	cms2-step2-query-config.md
3	检测配置 — 构建 conditionConfig（P1-P4、阈值、持续时间）	cms2-step3-detection-config.md
4	Webhook 查询 — 调用 list-alert-webhooks，由用户选择；其他类型 → 控制台	cms2-step5-preview-execute.md
5	预览并执行 — 显示摘要 → 确认 → manage-alert-rules CLI	cms2-step5-preview-execute.md

---

关键规则

完整详情 → references/critical-rules.md

1. 意图路由 — 将云资源指标路由到 CMS 1.0，将 Prometheus/APM/UModel 路由到 CMS 2.0。绝不混用 API。
2. CMS 2.0 API 强制要求 — CMS 2.0 告警规则必须且只能通过 ManageAlertRules 创建，并通过 QueryAlertRules 查询。禁止使用其他 API（例如 PutResourceMetricRule、DescribeMetricRuleList、ARMS CreateOrUpdateAlertRule、ARMS CreatePrometheusAlertRule）创建或查询 CMS 2.0 告警规则。如果 ManageAlertRules 返回错误，切勿回退到其他 API；向用户报告错误并停止执行。CLI 格式：aliyun cms manage-alert-rules --body '{"action":"CREATE",...}'
3. 先查询联系人/Webhook — CMS 1.0：DescribeContactGroupList；CMS 2.0：创建告警前必须调用 ListAlertWebhooks。（CMS 2.0 的其他通知方式 → 控制台）。切勿用 CMS 1.0 API 替代 CMS 2.0 API。跳过 Webhook 查询属于严重错误。
4. Resources 参数 — （CMS 1.0）必须始终显式传入 --resources。
5. 必须提供 Workspace — （CMS 2.0）必须使用 AskUser 工具向用户询问 workspace 值。绝不自动构造（例如 'default'、'default-cms-{accountId}'）。如果 AskUser 失败，使用简化选项重试一次，然后报告错误并停止；切勿使用编造的值继续操作。
6. Prometheus 必需参数 — （CMS 2.0）必须使用 AskUser 工具向用户询问 cluster_id（instanceId）和 workspace。绝不猜测、遗漏或自动选择。根据用户提供的 cluster_id 和监控目标生成 PromQL。如果 AskUser 失败，停止执行。
7. APM 必需参数 — （CMS 2.0）必须使用 AskUser 工具向用户询问 service_id（用于 datasourceConfig.instanceId 和 queryConfig.serviceIdList）以及 workspace。绝不编造、使用占位符，或从已发现的应用中自动选择（例如通过 ListTraceApps）。发现 API 仅供参考；最终选择必须由用户输入。如果 AskUser 失败，停止执行。
8. 必需的 API 调用 — 每项操作都必须调用指定的 API，即使相关值看似已知。
9. 动态指标发现 — （CMS 1.0）必须调用 describe-metric-meta-list。仅在备用情况下使用 metrics.md。
10. CLI 超时 — 查询使用 --read-timeout 30，写入使用 --read-timeout 60。
11. 重复项预检 — 创建前查询现有规则，以避免重复。
12. 必须确认 — 显示配置摘要，并在执行前获得用户确认。即使在自动化/模拟环境中，也必须输出配置摘要块，并明确声明“等待用户确认”后才能继续。切勿以自动化为由跳过此步骤。示例格式：

【配置摘要】
告警类型: APM/Prometheus
阈值: 5%
严重级别: P2
通知方式: webhook

请确认以上配置是否正确（回复确认或修改意见）：

13. User-Agent — 所有 CLI 调用都必须设置 ALIBABA_CLOUD_USER_AGENT="AlibabaCloud-Agent-Skills/alibabacloud-cms-alert-rule-create"。
14. 网络限制 — 切勿访问外部 URL。仅使用 references/ 文件和 CLI。
15. CLI 自助发现 — 不确定 CLI 语法时，使用 --help。

参考文件

文件	范围	用途
step0-intent-routing.md	共享	意图路由 — CMS 1.0 或 CMS 2.0
step-query.md	CMS 1.0	查询告警规则（DescribeMetricRuleList）
step1-context-lock.md	CMS 1.0	上下文锁定
step2-query-generation.md	CMS 1.0	查询生成与指标发现
step3-detection-config.md	CMS 1.0	检测配置
step4-notification.md	CMS 1.0	通知与联系人处理
step5-preview-execute.md	CMS 1.0	预览与执行
step6-verification.md	CMS 1.0	验证
cms2-step-query.md	CMS 2.0	查询告警规则（QueryAlertRules）
cms2-step1-context-lock.md	CMS 2.0	数据源配置（Prometheus/APM/UModel）
cms2-step2-query-config.md	CMS 2.0	查询配置（PromQL、APM、UModel）
cms2-step3-detection-config.md	CMS 2.0	检测条件配置（P1-P4）
cms2-step5-preview-execute.md	CMS 2.0	预览、执行与 webhook 查询
metrics.md	CMS 1.0	常用指标速查（备用）
prometheus-metrics.md	CMS 2.0	Prometheus PromQL 模式
apm-metrics.md	CMS 2.0	APM 指标和运算符
critical-rules.md	共享	扩展的关键规则详情、API 表格和示例
ram-policies.md	共享	所需的 RAM 权限
related_apis.yaml	共享	CLI 调用前的 API 查询

---

清理（执行后）

aliyun configure ai-mode disable