alibabacloud-sls-alerting について
Aliyun CLI で Alibaba Cloud SLS のアラートルールや通知設定を管理し、アラートイベントを診断するエージェントスキルです。SLS 運用を担う担当者向けで、変更前の設定確認と変更後の読み戻し検証を重視します。
主な機能
- 01アラートルールの管理
- 02通知オブジェクトとポリシーの管理
- 03アラート履歴の検索
- 04アラート発生原因の診断
- 05変更後の読み戻し検証
活用シーン
- 01アラートルールの検索や調整
- 02ルールの有効化、無効化、一時ミュート
- 03アラートポリシーやコンテンツテンプレートの管理
- 04アラート頻度と継続時間の分析
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ aliyun/ alibabacloud-aiops-skills --skill alibabacloud-sls-alertingインストール後、Claude Code で/alibabacloud-sls-alertingを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/cli-installation-guide.mdmanifest.jsonreferences/diagnosis/cause.mddiagnose.mdreferences/diagnosis/history/center.mdexecution-fields.mdproject.mdreferences/examples/latency-alert.mdreferences/notifications/manage-notifications.mdreferences/notifications/action-policies/action-conditions.mdactions.mdchannels.mdcreate-update-action-policy.mdescalation.mdmanage-action-policies.mdreferences/notifications/alert-policies/create-update-alert-policy.mdmanage-alert-policies.mdnotification-grouping.mdreferences/notifications/api/resource-records.mdreferences/notifications/objects/manage-notification-objects.mdon-call.mduser-groups.mdusers.mdreferences/notifications/objects/webhooks/bots.mdcustom-http.mdmanage-webhook-integrations.mdreferences/notifications/templates/channel-content.mdcreate-update-content-template.mdmanage-content-templates.mdsyntax.md詳細
Alibaba Cloud SLS アラート
前提条件
コマンドを実行する前に、次の確認を完了してください。説明のみを求める場合は、CLI のセットアップは不要です。
Aliyun CLI のインストール
aliyun version を実行し、バージョンが 3.3.22 以上であることを確認します。インストールされていない場合や古い場合は、CLI のインストールガイドに従ってください。
プラグインの更新
aliyun sls version と、実行するコマンドのヘルプを確認します。更新が必要な場合は、SLS プラグインを更新します。
aliyun plugin update --name sls
プロファイルの選択
デフォルトでは CLI に設定されたプロファイルを使用します。ユーザーがプロファイルを指定した場合に限り、--profile を追加してください。
可観測性(すべての aliyun api コマンドで必ず実施)
最初のクラウド呼び出しの前に、このスキルのマニフェストを読み込み、トップレベルにある空でない文字列 version を {skill-version} として使用します。ファイルまたはバージョンが無効、あるいは見つからない場合は停止して、その旨を報告してください。推測してはいけません。
このスキル用に、新しいランダムな 32 文字の小文字の 16 進数 {session-id} を会話内で生成し、操作、ページネーション、再試行にわたって再利用してください。スキルを切り替える場合は、選択したスキルのマニフェストを読み込み、戻ってくる場合も含めて、そのスキル独自のセッション ID とバージョンを使用してください。
すべてのクラウド API コマンドと、リクエストのみのドライランには、必ずこのフラグを含めてください。ローカルの configure、plugin、version、ヘルプコマンドは対象外です。
--user-agent "AlibabaCloud-Agent-Skills/alibabacloud-sls-alerting/{session-id} skill-version/{skill-version}"
SLS_ALERT_USER_AGENT に解決済みの値を設定し、二重引用符で囲んで渡してください。プレースホルダー、認証情報、個人を特定できる情報をそのまま送信してはいけません。
操作の選択
ルールは、アラートを発報する条件を定義します。通知リソースは、アラートの処理方法と送信方法を決定します。イベント診断では、発生したアラートについて説明します。該当する管理または診断の項目を読み、要求された操作に必要な参照先だけを確認してください。
- アラートルールの管理:ルールの検索、確認、作成、更新、無効化、有効化、削除、一時的なミュート/ミュート解除を行います。
- アラート通知の管理:通知オブジェクト、アラートポリシー、アクションポリシー、コンテンツテンプレートを管理します。
- アラートイベントの診断:発報の原因、頻度、継続時間を説明するか、アラート履歴を照会します。
スキルの使用に関するトラブルシューティング
コマンドや同梱スクリプトの実行で問題が発生した場合は、スキルの使用に関するトラブルシューティングを参照してください。ルールの動作やアラートの結果については、上記の機能別の項目を参照してください。
共通の操作上の制約
- 置き換えを伴う更新の前に対象を読み込み、関係のないフィールドを保持してください。
- ユーザーの要求と既存の権限で認められた変更を実行してください。
- 書き込み後に値を読み戻し、意図したフィールドと比較してください。設定が成功しても、評価や配信の成功が証明されるわけではありません。
aliyun configure getは絶対に実行しないでください。- 設定ファイル、環境変数、コマンド出力から AccessKey ID、AccessKey シークレット、STS トークンを絶対に抽出または表示しないでください。ユーザーに認証情報を貼り付けるよう求めてはいけません。CLI に設定済みの認証情報を使用させてください。
参考ドキュメント
以下の参考資料はすべての操作で使用できます。必要に応じて参照してください。
- CLI のインストールガイド:インストール、認証方式、プロファイルについて説明します。
- リージョンとエンドポイントの設定:ルールと ResourceRecord の操作を適切なエンドポイントにルーティングします。
- 関連 API:API パラメーターとレスポンスについて説明します。
- RAM ポリシー:呼び出し元の権限とリソースの範囲について説明します。