コンテンツにスキップ

AWS Step Functions(SFN)State Machine

AWS Step Functions (SFN) State Machine のメトリクスデータを収集

設定

Func のインストール

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

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

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

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

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

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

手動有効化スクリプト

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

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

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

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

検証

  1. [管理 / 自動トリガー設定]で、対象タスクの自動トリガー設定が存在することを確認し、タスク履歴とログに異常がないか確認します。
  2. Guance の「インフラストラクチャ - リソースディレクトリ」で資産情報が存在するか確認します
  3. Guance の「メトリクス」で対応する監視データがあるか確認します

メトリクス

Amazon CloudWatch を設定すると、設定に応じてさらに多くのメトリクスを収集できます。Amazon CloudWatch のメトリクス詳細

AWS Step Functions (SFN) State Machine のメトリクスは aws_states メトリクスセットにあり、説明列には各メトリクスの説明、単位、および統計データが含まれます。

メトリクス名 説明
ExecutionTime 実行開始時刻から終了時刻までの時間間隔(ミリ秒)
ExecutionThrottled 制限された StateEntered イベントと再試行の数
ExecutionsAborted 中止または終了した実行の数
ExecutionsFailed 失敗した実行の数
ExecutionsStarted 開始された実行の数
ExecutionsSucceeded 正常に完了した実行の数
ExecutionsTimedOut いずれかの理由でタイムアウトした実行の数

オブジェクト

収集された AWS Step Functions (SFN) State Machine のオブジェクトデータ構造は、「インフラストラクチャ - リソースディレクトリ」で確認できます

{
  "measurement": "aws_sfn_state_machine",
  "tags": {
    "state_machine_arn"                 : "arn:xxx:axxxxow:ap-southeast-1:xxxx7738534:environment/MyAirflowEnvironment",
    "sate_machine_name"                 : "HelloWorldStateMachine",
    "RegionId"                          : "ap-southeast-1"
  },
  "fields": {
    "type"                        : "STANDARD",
    "creationDate"                : "2025-08-15T10:35:10.879000+08:00"
  }
}

注意: tags、fields のフィールドは今後の更新で変更される可能性があります

フィードバック

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