Amazon CloudWatch を使用した Run Command メトリクスのモニタリング

メトリクスは Amazon CloudWatch での基本的な概念です。メトリクスは、&CW; に発行された時系列のデータポイントのセットを表します。メトリクスはモニターリング対象の変数と考え、データポイントは時間の経過と共に変数の値を表します。

AWS Systems Manager は、Run Command コマンドのステータスに関するメトリクスを CloudWatch に公開します。これにより、このようなメトリクスに基づいてアラームを設定できます。Run Command は AWS Systems Manager の一機能です。これらの統計は長期間記録されるため、履歴情報にアクセスして、AWS アカウント で実行されるコマンドの成功率をより確実に把握できます。

コマンドの端末ステータス値で、メトリクスを追跡できるものには Success、Failed、および Delivery Timed Out があります。たとえば、SSM コマンドドキュメントが 1 時間ごとに実行されるように設定されている場合、これらの時間に Success のステータスがレポートされない場合、それを通知するようアラームを設定できます。コマンドステータス値の詳細については、「コマンドのステータスについて」を参照してください。

CloudWatch コンソールでメトリクスを表示する

1. CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。

2. ナビゲーションペインで [Metrics] (メトリクス) を選択します。

3. [AWS のサービスによるアラーム] エリアの [サービス] で、[SSM-Run Command] を選択します。

AWS CLI を使ってメトリクスを表示するには

コマンドプロンプトを開き、次のコマンドを使用します。

aws cloudwatch list-metrics --namespace "AWS/SSM-RunCommand"

すべての使用可能なメトリクスのリストを表示するには、次のコマンドを使用します。

aws cloudwatch list-metrics

Systems Manager Run Command のメトリクスとディメンション

Systems Manager は、Run Command コマンドメトリクスを CloudWatch に毎分 1 回送信します。

Systems Manager は次のコマンドメトリクスを CloudWatch に送信します。

注記

これらのメトリクスは単位として Count を使用するため、Sum と SampleCount は最も有用な統計情報です。

メトリクス	説明
CommandsDeliveryTimedOut	端末ステータスが Delivery Timed Out のコマンドの数。
CommandsFailed	端末ステータスが Failed のコマンドの数。
CommandsSucceeded	端末ステータスが Success のコマンドの数。

CloudWatch メトリクスの使用の詳細については、Amazon CloudWatch ユーザーガイドの以下のトピックを参照してください。

• メトリクス

• Amazon CloudWatch メトリクスを使用する

• Amazon CloudWatch でのアラームの使用