AWS SSM(Systems Manager)Run Command
AWS SSM (Systems Manager) Run Command のメトリクスデータを収集
設定¶
Func のインストール¶
Guance のインテグレーション - 拡張機能 - ホステッド Func の有効化を推奨します。前提条件はすべて自動的にインストールされるため、そのままスクリプトのインストールに進んでください。
Func を自前でデプロイする場合はFunc の自前デプロイを参照してください
スクリプトのインストール¶
ヒント: 要件を満たす Amazon AK を事前に用意してください(簡単にするため、グローバルの読み取り専用権限
ReadOnlyAccessを直接付与しても構いません)
マネージド版の有効化スクリプト¶
- Guance コンソールにログインします
- 【インテグレーション】メニューをクリックし、【クラウドアカウント管理】を選択します。
- [クラウドアカウントを追加] をクリックし、[AWS] を選択して画面に必要な情報を入力します。以前にクラウドアカウント情報を設定済みの場合は、この手順をスキップしてください
- [テスト] をクリックし、成功したら [保存] をクリックします。失敗した場合は、関連設定が正しいか確認して再度テストしてください
- 【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページに入ります
- クラウドアカウントの詳細ページで【インテグレーション】をクリックし、
未インストール一覧からAWS SSM(Systems Manager)Run Commandを探して【インストール】をクリックします。
手動有効化スクリプト¶
-
Func コンソールにログインし、【スクリプトマーケット】から Guance のスクリプトマーケットを開いて、
integration_aws_ssm_run_commandを検索します。 -
[インストール] をクリックし、対応するパラメータとして AWS AK ID、AK Secret、アカウント名を入力します
-
【起動スクリプトをデプロイ】をクリックします。システムが
Startupスクリプトセットを作成し、対応する起動スクリプトを自動設定します。 -
有効化後、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。[実行] をクリックすると、定期実行を待たずにすぐ 1 回実行できます。少し待ってから、実行タスクの記録と対応するログを確認してください
検証¶
- [管理 / 自動トリガー設定]で、対象タスクの自動トリガー設定が存在することを確認し、タスク履歴とログに異常がないか確認します。
- Guance の「インフラストラクチャ - リソースディレクトリ」で資産情報が存在するか確認します
- Guance の「メトリクス」で対応する監視データがあるか確認します
メトリクス¶
Amazon CloudWatch を設定すると、設定によりさらに多くのメトリクスを収集できます Amazon CloudWatch メトリクスの詳細
AWS SSM (Systems Manager) Run Command のメトリクスは aws_ssm_run_command メトリクスセットにあり、説明欄には各メトリクスの説明と単位および統計情報が含まれます。
| メトリクス | 説明 | 単位 |
|---|---|---|
CommandsDeliveryTimedOut |
終了状態が Delivery Timed Out のコマンド数 | count |
CommandsFailed |
終了状態が Failed のコマンド数 | count |
CommandsSucceeded |
終了状態が Success のコマンド数 | count |
オブジェクト¶
収集された AWS SSM (Systems Manager) Run Command のオブジェクトデータ構造です。オブジェクトデータは「インフラストラクチャ - リソースディレクトリ」で確認できます
{
"measurement": "aws_ssm_run_command",
"tags": {
"command_id" : "91d10100-89c4-4077-a2ce-89fb90d1f566",
"document_name" : "AWS-RunShellScript",
"RegionId" : "ap-southeast-1"
},
"fields": {
"document_version" : "1",
"expires_after" : "2025-08-05T14:14:19.774000+08:00",
"parameters" : "{[コマンド文書]}",
"instance_ids" : "xxxx-0b8b6fee9ef5426d7",
"targets" : "{[Json データ]}",
"requested_date_time" : "2025-08-05T13:04:19.774000+08:00",
"status" : "Success",
"status_details" : "Success",
"cloud_watch_output_config" : "{}",
"alarm_configuration" : "{}",
"triggered_alarms" : "[]",
"timeout_seconds" : "600",
"output_s_3_region" : "ap-southeast-1"
}
}
注意:
tags、fieldsのフィールドは今後の更新で変更される可能性があります