mcpField
A
alibabacloud-cms-alert-rule-create

alibabacloud-cms-alert-rule-create

github.com/aliyunクラウド・DevOps281286 回インストール1 日前に更新
リポジトリ

alibabacloud-cms-alert-rule-create について

Aliyun CLIでAlibaba Cloud CMSのアラートルールを作成・照会するスキルです。クラウドリソース指標はCMS 1.0、Prometheus・APM・UModelはCMS 2.0に振り分け、実行前に設定を確認します。

主な機能

  1. 01監視対象に応じたCMSバージョン選択
  2. 02アラートルールの作成と照会
  3. 03指標検出と条件設定
  4. 04連絡先またはWebhookの照会
  5. 05実行前のプレビューと確認

活用シーン

  1. 01クラウド製品指標のアラート作成
  2. 02Prometheus指標のアラート設定
  3. 03APMまたはUModelの既存アラート確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aliyun/alibabacloud-aiops-skills --skill alibabacloud-cms-alert-rule-create

インストール後、Claude Code で/alibabacloud-cms-alert-rule-createを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
apm-metrics.md
cms2-step-query.md
cms2-step1-context-lock.md
cms2-step2-query-config.md
cms2-step3-detection-config.md
cms2-step5-preview-execute.md
critical-rules.md
metrics.md
prometheus-metrics.md
ram-policies.md
step-query.md
step0-intent-routing.md
step1-context-lock.md
step2-query-generation.md
step3-detection-config.md
step4-notification.md
step5-preview-execute.md
step6-verification.md
scripts/
validate-params.sh

詳細

Alibaba Cloud アラートルール管理

このスキルでは、アラートルールを作成および照会します。インテントルーティングにより、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…）PutResourceMetricRuleDescribeMetricRuleList
CMS 2.0Prometheus（PROMETHEUS）ManageAlertRulesQueryAlertRules
CMS 2.0APM（APM）ManageAlertRulesQueryAlertRules
CMS 2.0UModel（UMODEL）ManageAlertRulesQueryAlertRules

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プレビューと実行 — 概要を表示 → 確認 → CLIstep5-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
4Webhook の照会 — list-alert-webhooks を呼び出し、ユーザーが選択します。その他のタイプはコンソールで操作しますcms2-step5-preview-execute.md
5プレビューと実行 — 概要を表示 → 確認 → manage-alert-rules CLIcms2-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 を使用して照会する必要があります。CMS 2.0 のアラートルールの作成や照会には、ほかの API（例：PutResourceMetricRule、DescribeMetricRuleList、ARMS CreateOrUpdateAlertRule、ARMS CreatePrometheusAlertRule）を使用できません。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 2.0 の代わりに CMS 1.0 の API を使用してはいけません。Webhook の照会を省略することは重大な失敗です。
  4. Resources パラメーター — （CMS 1.0）--resources を必ず明示的に指定してください。
  5. ワークスペースの必須確認 — （CMS 2.0）AskUser ツールを使用して、ユーザーにワークスペースの値を尋ねる必要があります。自動的に値を作成してはいけません（例：'default'、'default-cms-{accountId}'）。AskUser が失敗した場合は、選択肢を簡略化して一度だけ再試行してください。その後、エラーを報告して実行を停止し、推測した値で続行してはいけません。
  6. Prometheus の必須パラメーター — （CMS 2.0）cluster_id（instanceId）と workspace は、AskUser ツールを使用して必ずユーザーに確認してください。推測、省略、自動選択をしてはいけません。PromQL は、ユーザーが指定した cluster_id と監視対象に基づいて生成します。AskUser が失敗した場合は、実行を停止してください。
  7. APM の必須パラメーター — （CMS 2.0）service_id（datasourceConfig.instanceId と queryConfig.serviceIdList 用）および workspace は、AskUser ツールを使用して必ずユーザーに確認してください。値を捏造したり、プレースホルダーを使用したり、検出したアプリケーション（例：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. 確認の必須化 — 実行前に設定の概要を提示し、ユーザーの確認を得てください。自動化／シミュレーション環境でも、設定概要ブロックを出力し、続行前に「Waiting for user confirmation」と明示する必要があります。自動化を理由にこの手順を省略してはいけません。形式の例：
【配置摘要】
告警类型: APM/Prometheus
阈值: 5%
严重级别: P2
通知方式: webhook

请确认以上配置是否正确（回复确认或修改意见）：
  1. User-Agent — すべての CLI 呼び出しで ALIBABA_CLOUD_USER_AGENT="AlibabaCloud-Agent-Skills/alibabacloud-cms-alert-rule-create" を設定してください。
  2. ネットワーク制限 — 外部 URL にアクセスしてはいけません。references/ 内のファイルと CLI のみを使用してください。
  3. CLI の自己確認 — CLI の構文が不明な場合は、--help を使用してください。

参照ファイル

ファイル対象範囲目的
step0-intent-routing.md共通意図のルーティング — CMS 1.0 または CMS 2.0
step-query.mdCMS 1.0アラートルールのクエリ（DescribeMetricRuleList）
step1-context-lock.mdCMS 1.0コンテキストの固定
step2-query-generation.mdCMS 1.0クエリ生成とメトリクスの検出
step3-detection-config.mdCMS 1.0検知設定
step4-notification.mdCMS 1.0通知と連絡先の処理
step5-preview-execute.mdCMS 1.0プレビューと実行
step6-verification.mdCMS 1.0検証
cms2-step-query.mdCMS 2.0アラートルールのクエリ（QueryAlertRules）
cms2-step1-context-lock.mdCMS 2.0データソース設定（Prometheus/APM/UModel）
cms2-step2-query-config.mdCMS 2.0クエリ設定（PromQL、APM、UModel）
cms2-step3-detection-config.mdCMS 2.0検知条件の設定（P1-P4）
cms2-step5-preview-execute.mdCMS 2.0プレビュー、実行、Webhook クエリ
metrics.mdCMS 1.0共通メトリクスのクイックリファレンス（フォールバック）
prometheus-metrics.mdCMS 2.0Prometheus の PromQL パターン
apm-metrics.mdCMS 2.0APM メトリクスと演算子
critical-rules.md共通重要なルールの詳細、API テーブル、例
ram-policies.md共通必要な RAM 権限
related_apis.yaml共通CLI 呼び出し前の API 検索

クリーンアップ（実行後）

aliyun configure ai-mode disable

コメント

Markdown 対応