コンテンツにスキップ

AWS SSM(Systems Manager)Run Command

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

設定

Func のインストール

Guance のインテグレーション - 拡張機能 - ホステッド Func の有効化を推奨します。前提条件はすべて自動的にインストールされるため、そのままスクリプトのインストールに進んでください。

Func を自前でデプロイする場合はFunc の自前デプロイを参照してください

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

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

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

  1. Guance コンソールにログインします
  2. 【インテグレーション】メニューをクリックし、【クラウドアカウント管理】を選択します。
  3. [クラウドアカウントを追加] をクリックし、[AWS] を選択して画面に必要な情報を入力します。以前にクラウドアカウント情報を設定済みの場合は、この手順をスキップしてください
  4. [テスト] をクリックし、成功したら [保存] をクリックします。失敗した場合は、関連設定が正しいか確認して再度テストしてください
  5. 【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページに入ります
  6. クラウドアカウントの詳細ページで【インテグレーション】をクリックし、未インストール 一覧から AWS SSM(Systems Manager)Run Command を探して【インストール】をクリックします。

手動有効化スクリプト

  1. Func コンソールにログインし、【スクリプトマーケット】から Guance のスクリプトマーケットを開いて、integration_aws_ssm_run_command を検索します。

  2. [インストール] をクリックし、対応するパラメータとして AWS AK ID、AK Secret、アカウント名を入力します

  3. 【起動スクリプトをデプロイ】をクリックします。システムが Startup スクリプトセットを作成し、対応する起動スクリプトを自動設定します。

  4. 有効化後、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。[実行] をクリックすると、定期実行を待たずにすぐ 1 回実行できます。少し待ってから、実行タスクの記録と対応するログを確認してください

検証

  1. [管理 / 自動トリガー設定]で、対象タスクの自動トリガー設定が存在することを確認し、タスク履歴とログに異常がないか確認します。
  2. Guance の「インフラストラクチャ - リソースディレクトリ」で資産情報が存在するか確認します
  3. 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 のフィールドは今後の更新で変更される可能性があります

フィードバック

このページは役に立ちましたか?