阿里云skills阿里云告警规则管理
本 Skill 创建和查询告警规则。意图路由自动选择 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 | 上下文锁定——namespace、地域、实例 | step1-context-lock.md |
| 2 | 查询生成——通过 API 发现指标，匹配用户意图 | step2-query-generation.md |
| 3 | 检测配置——阈值、频率（默认 1 分钟） | 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（type、instanceId、region） | cms2-step1-context-lock.md |
| 2 | 查询配置——构建 queryConfig（PromQL / APM measures / UModel entity） | 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
- 意图路由 —— 云资源指标路由到 CMS 1.0，Prometheus/APM/UModel 路由到 CMS 2.0。绝不混用 API。
- CMS 2.0 API 强制 —— CMS 2.0 告警规则必须仅通过
ManageAlertRules创建、通过QueryAlertRules查询。CMS 2.0 告警规则创建或查询不允许使用任何其他 API（例如PutResourceMetricRule、DescribeMetricRuleList、ARMSCreateOrUpdateAlertRule、ARMSCreatePrometheusAlertRule）。如果ManageAlertRules返回错误，不要回退到其他 API——向用户报告错误并停止执行。CLI 格式：aliyun cms manage-alert-rules --body '{"action":"CREATE",...}' - 先查询联系人/Webhook —— CMS 1.0：
DescribeContactGroupList；CMS 2.0：ListAlertWebhooks在告警创建前强制执行。（CMS 2.0 其他通知 → 控制台）。不要用 CMS 1.0 API 替代 CMS 2.0。跳过 webhook 查询是关键失败。 - Resources 参数 —— （CMS 1.0）
--resources必须始终显式传递。 - Workspace 必填 —— （CMS 2.0）必须使用 AskUser 工具询问用户 workspace 值。绝不自动构造（例如 'default'、'default-cms-{accountId}'）。如果 AskUser 失败，用简化选项重试一次，然后报告错误并停止——不要用捏造的值继续。
- Prometheus 必填参数 —— （CMS 2.0）
cluster_id（instanceId）+workspace必须使用 AskUser 工具询问用户。绝不猜测、省略或自动选择。PromQL 基于用户提供的 cluster_id + 监控目标生成。如果 AskUser 失败，停止执行。 - APM 必填参数 —— （CMS 2.0）
service_id（用于datasourceConfig.instanceId和queryConfig.serviceIdList）+workspace必须使用 AskUser 工具询问用户。绝不捏造、使用占位符或从发现的应用自动选择（例如通过 ListTraceApps）。发现 API 仅供参考——最终选择必须来自用户输入。如果 AskUser 失败，停止执行。 - 必需 API 调用 —— 每个操作都必须调用指定 API，即使值看起来已知。
- 动态指标发现 —— （CMS 1.0）必须调用
describe-metric-meta-list。仅在回退时使用metrics.md。 - CLI 超时 —— 查询用
--read-timeout 30，写操作用--read-timeout 60。 - 重复预检查 —— 创建前查询现有规则以避免重复。
- 强制确认 —— 执行前展示配置摘要并获得用户确认。即使在自动化/模拟环境中，你也必须输出配置摘要块并明确说明“等待用户确认”后再继续。 不要以自动化为借口跳过此步骤。示例格式：
【配置摘要】
告警类型: APM/Prometheus
阈值: 5%
严重级别: P2
通知方式: webhook
请确认以上配置是否正确（回复确认或修改意见）：- User-Agent —— 为所有 CLI 调用设置
ALIBABA_CLOUD_USER_AGENT="AlibabaCloud-Agent-Skills/alibabacloud-cms-alert-rule-create"。 - 网络限制 —— 绝不访问外部 URL。仅使用
references/文件和 CLI。 - CLI 自发现 —— 不确定时使用
--help查询 CLI 语法。
参考文件
| 文件 | 范围 | 用途 |
|---|---|---|
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
◯ 评论 0