SuperAPI AI 工具集

alibabacloud-cms-alert-rule-create

部署与运维

查看项目

更新于 10-15 12:43

技能介绍

用途

本技能用于通过阿里云 CLI 创建和查询告警规则,覆盖两类监控体系:

  • CMS 1.0:云资源监控,适用于 ECS、RDS、SLB、OSS、Redis、MongoDB 等云产品的系统指标。
  • CMS 2.0:高级监控,适用于 Prometheus(PROMETHEUS)、APM(APM)、UModel(UMODEL)等场景。

意图路由会自动判断用户需求走 CMS 1.0 还是 CMS 2.0 工作流。

执行前准备

执行前必须完成 CLI 配置,包括启用 ai-mode、设置 User-Agent 为 AlibabaCloud-Agent-Skills/alibabacloud-cms-alert-rule-create,以及更新插件。

支持的告警类型与 API

  • CMS 1.0 云资源:创建 API 为 PutResourceMetricRule,查询 API 为 DescribeMetricRuleList。
  • CMS 2.0 Prometheus / APM / UModel:创建 API 为 ManageAlertRules,查询 API 为 QueryAlertRules。

工作流

CMS 1.0 创建流程:上下文锁定(namespace、region、实例)→ 查询生成(通过 API 发现指标并匹配意图)→ 检测配置(阈值、频率,默认 1 分钟)→ 通知(查询联系人并选择或创建)→ 预览与执行(展示摘要、确认后调用 CLI)→ 验证(检查状态)。

CMS 2.0 创建流程:上下文锁定(构建 datasourceConfig)→ 查询配置(构建 queryConfig,如 PromQL、APM 指标、UModel 实体)→ 检测配置(构建 conditionConfig,含 P1-P4、阈值、持续时间)→ Webhook 查询(调用 list-alert-webhooks 由用户选择,其他类型走控制台)→ 预览与执行(展示摘要、确认后调用 manage-alert-rules)。

查询请求各走对应的查询流程。

关键规则

  • 意图路由不可混用 API:云资源指标走 CMS 1.0,Prometheus/APM/UModel 走 CMS 2.0。
  • CMS 2.0 告警规则必须且只能通过 ManageAlertRules 创建、QueryAlertRules 查询,不得回退到其他 API;出错时应报告并停止。
  • 创建前必须查询联系人/Webhook;CMS 2.0 必须调用 ListAlertWebhooks,跳过属严重失败。
  • CMS 1.0 的 --resources 参数必须显式传入。
  • CMS 2.0 必须通过 AskUser 工具向用户询问 workspace,不得自动构造。
  • Prometheus 场景必须询问 cluster_id 与 workspace;APM 场景必须询问 service_id 与 workspace,不得猜测或占位。
  • 每次操作必须调用指定 API;CMS 1.0 必须调用 describe-metric-meta-list 动态发现指标。
  • CLI 超时:查询 --read-timeout 30,写入 --read-timeout 60。
  • 创建前需查询已有规则避免重复。
  • 执行前必须展示配置摘要并等待用户确认,即使在自动化环境中也不得跳过。
  • 所有 CLI 调用需设置 ALIBABA_CLOUD_USER_AGENT。
  • 禁止访问外部 URL,仅使用 references/ 文件与 CLI。
  • CLI 语法不确定时使用 --help 自发现。

适用场景与限制

适用于需要通过 CLI 批量或自动化管理阿里云告警规则的场景。限制包括:必须预先配置 CLI 与权限(见 ram-policies.md);CMS 2.0 的部分通知类型需前往控制台配置;执行结束后的清理需运行 aliyun configure ai-mode disable。具体的收费、价格等信息暂未提供。