AWS Systems Manager Run Command

AWS Systems Manager Run Command のメトリクスデータを収集

設定¶

Func のインストール¶

Guance の統合 - 拡張 - マネージド版 Func を有効化することを推奨します。前提条件はすべて自動でインストールされるため、スクリプトのインストールを続けてください。

Func を自己導入する場合は Func の自己導入を参照してください

インストールスクリプト¶

ヒント: 要件を満たす AWS AK を事前に用意してください。簡単のため、グローバル読み取り専用権限 ReadOnlyAccess を直接付与してもかまいません

マネージド版有効化スクリプト¶

Guance コンソールにログインします
【統合】メニューをクリックし、【クラウドアカウント管理】を選択します
【クラウドアカウントを追加】をクリックし、【AWS】を選択して画面に必要な情報を入力します。すでにクラウドアカウント情報を設定済みであれば、この手順は省略できます
【テスト】をクリックし、テスト成功後に【保存】をクリックします。テストに失敗した場合は関連設定が正しいか確認し、再度テストしてください
【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当のクラウドアカウントをクリックして詳細ページに入ります
クラウドアカウント詳細ページの【統合】ボタンをクリックし、未インストール 一覧から AWS 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 Systems Manager Run Command のメトリクスは aws_ssm_run_command メトリクスセットにあり、説明欄には各メトリクスの説明と単位および統計情報が含まれます。

メトリクス	説明	単位
`CommandsDeliveryTimedOut`	終了状態が Delivery Timed Out のコマンド数	count
`CommandsFailed`	終了状態が Failed のコマンド数	count
`CommandsSucceeded`	終了状態が Success のコマンド数	count

オブジェクト¶

収集された AWS 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 のフィールドは、今後の更新により変更される可能性があります