SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsalibabacloud-cms-alert-rule-create

alibabacloud-cms-alert-rule-create

Deployment & operations

View repository

Updated 10-15 12:43

About this skill

Alibaba Cloud Alert Rule Management

This skill creates and queries alert rules. Intent routing selects CMS 1.0 or CMS 2.0 workflow automatically.

CLI Setup (Required Before Execution)

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

Step 0: Intent Routing

Identify user's monitoring target → route to the correct workflow. See step0-intent-routing.md.

User Scenario Route To
Cloud product system metrics (ECS, RDS, SLB, OSS, Redis, MongoDB…) CMS 1.0 Workflow
Prometheus / APM / UModel / custom metrics CMS 2.0 Workflow

Supported Alert Types

Version Type Create API Query API
CMS 1.0 Cloud Resource (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 Workflow

For query requests → step-query.md

For create requests:

Step Description Reference
1 Context Lock — namespace, region, instances step1-context-lock.md
2 Query Generation — discover metrics via API, match to user intent step2-query-generation.md
3 Detection Config — threshold, frequency (default 1min) step3-detection-config.md
4 Notification — query contacts → select or create step4-notification.md
5 Preview & Execute — show summary → confirm → CLI step5-preview-execute.md
6 Verification — check status step6-verification.md

CMS 2.0 Workflow

For query requests → cms2-step-query.md

For create requests:

Step Description Reference
1 Context Lock — build datasourceConfig (type, instanceId, region) cms2-step1-context-lock.md
2 Query Config — build queryConfig (PromQL / APM measures / UModel entity) cms2-step2-query-config.md
3 Detection Config — build conditionConfig (P1-P4, threshold, duration) cms2-step3-detection-config.md
4 Webhook Query — call list-alert-webhooks, user selects; other types → console cms2-step5-preview-execute.md
5 Preview & Execute — show summary → confirm → manage-alert-rules CLI cms2-step5-preview-execute.md

Critical Rules

Full details → references/critical-rules.md

  1. Intent Routing — Route cloud resource metrics to CMS 1.0, Prometheus/APM/UModel to CMS 2.0. Never mix APIs.
  2. CMS 2.0 API Enforcement — CMS 2.0 alert rules MUST ONLY be created via ManageAlertRules and queried via QueryAlertRules. No other API (e.g. PutResourceMetricRule, DescribeMetricRuleList, ARMS CreateOrUpdateAlertRule, ARMS CreatePrometheusAlertRule) is permitted for CMS 2.0 alert rule creation or query. If ManageAlertRules returns error, DO NOT fallback to other APIs — report the error to user and STOP execution. CLI format: aliyun cms manage-alert-rules --body '{"action":"CREATE",...}'
  3. Contact/Webhook Query First — CMS 1.0: DescribeContactGroupList; CMS 2.0: ListAlertWebhooks is MANDATORY before alert creation. (CMS 2.0 other notification → console). DO NOT use CMS 1.0 APIs as substitute for CMS 2.0. Skipping webhook query is a critical failure.
  4. Resources Parameter — (CMS 1.0) --resources must always be explicitly passed.
  5. Workspace Required — (CMS 2.0) Must ask user for workspace value using AskUser tool. Never auto-construct (e.g. 'default', 'default-cms-{accountId}'). If AskUser fails, retry once with simplified options, then report error and STOP — do NOT proceed with fabricated values.
  6. Prometheus Required Params — (CMS 2.0) cluster_id (instanceId) + workspace MUST ASK USER using AskUser tool. Never guess, omit, or auto-select. PromQL is generated based on user-provided cluster_id + monitoring target. If AskUser fails, STOP execution.
  7. APM Required Params — (CMS 2.0) service_id (for datasourceConfig.instanceId AND queryConfig.serviceIdList) + workspace MUST ASK USER using AskUser tool. Never fabricate, use placeholders, or auto-select from discovered applications (e.g. via ListTraceApps). Discovery APIs are for reference only — final selection MUST come from user input. If AskUser fails, STOP execution.
  8. Required API Calls — Every operation must call designated APIs even if values seem known.
  9. Dynamic Metric Discovery — (CMS 1.0) MUST call describe-metric-meta-list. Use metrics.md only as fallback.
  10. CLI Timeout — --read-timeout 30 for queries, --read-timeout 60 for writes.
  11. Duplicate Pre-check — Query existing rules before creation to avoid duplicates.
  12. Mandatory Confirmation — Show config summary and get user confirmation before execution. EVEN in automated/simulated environments, you MUST output a configuration summary block and explicitly state 'Waiting for user confirmation' before proceeding. Do NOT skip this step with excuses about automation. Example format:
【配置摘要】
告警类型: APM/Prometheus
阈值: 5%
严重级别: P2
通知方式: webhook

请确认以上配置是否正确（回复确认或修改意见）：
  1. User-Agent — Set ALIBABA_CLOUD_USER_AGENT="AlibabaCloud-Agent-Skills/alibabacloud-cms-alert-rule-create" for all CLI calls.
  2. Network Restriction — Never access external URLs. Use only references/ files and CLI.
  3. CLI Self-Discovery — Use --help for CLI syntax when uncertain.

Reference Files

File Scope Purpose
step0-intent-routing.md Shared Intent routing — CMS 1.0 or CMS 2.0
step-query.md CMS 1.0 Query alert rules (DescribeMetricRuleList)
step1-context-lock.md CMS 1.0 Context lock
step2-query-generation.md CMS 1.0 Query generation & metric discovery
step3-detection-config.md CMS 1.0 Detection config
step4-notification.md CMS 1.0 Notification & contact handling
step5-preview-execute.md CMS 1.0 Preview & execute
step6-verification.md CMS 1.0 Verification
cms2-step-query.md CMS 2.0 Query alert rules (QueryAlertRules)
cms2-step1-context-lock.md CMS 2.0 Datasource config (Prometheus/APM/UModel)
cms2-step2-query-config.md CMS 2.0 Query config (PromQL, APM, UModel)
cms2-step3-detection-config.md CMS 2.0 Detection condition config (P1-P4)
cms2-step5-preview-execute.md CMS 2.0 Preview, execute & webhook query
metrics.md CMS 1.0 Common metrics quick reference (fallback)
prometheus-metrics.md CMS 2.0 Prometheus PromQL patterns
apm-metrics.md CMS 2.0 APM metrics and operators
critical-rules.md Shared Expanded critical rule details, API tables, examples
ram-policies.md Shared Required RAM permissions
related_apis.yaml Shared API lookup before CLI calls

Cleanup (After Execution)

aliyun configure ai-mode disable