AWS Step Function State Machine

AWS Step Function State Machine のメトリクスデータを収集

設定¶

Func のインストール¶

推奨は Guance 連携 - 拡張 - マネージド版 Func の有効化です。前提条件はすべて自動でインストールされるため、そのままスクリプトのインストールへ進んでください。

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

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

ヒント：要件を満たす Amazon の AK を事前に用意してください。簡単のため、全体の読み取り専用権限 ReadOnlyAccess を直接付与しても構いません。

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

Guance コンソールにログインします
「連携」メニューをクリックし、「クラウドアカウント管理」を選択します
「クラウドアカウントを追加」をクリックし、「AWS」を選択して、画面に必要な情報を入力します。すでにクラウドアカウント情報を設定済みの場合は、この手順をスキップします
「テスト」をクリックし、成功したら「保存」をクリックします。テストに失敗した場合は、関連する設定が正しいか確認してから再度テストしてください
「クラウドアカウント管理」一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページに入ります
クラウドアカウント詳細ページの「連携」ボタンをクリックし、未インストール 一覧から AWS Step Function State Machine を見つけて、「インストール」ボタンをクリックし、表示されたインストール画面でインストールします。

手動有効化スクリプト¶

Func コンソールにログインし、「スクリプトマーケット」をクリックして Guance スクリプトマーケットに入り、integration_aws_sfn_state_machine を検索します
「インストール」をクリックしたら、対応するパラメータとして AWS AK ID、AK Secret、およびアカウント名を入力します。
「起動スクリプトをデプロイ」をクリックすると、システムが Startup スクリプトセットを自動作成し、対応する起動スクリプトを自動で設定します。
有効化後は、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。「実行」をクリックすると、定期実行を待たずにすぐ 1 回実行できます。少し待ってから、実行タスクの記録と対応するログを確認できます。

検証¶

「管理 / 自動トリガー設定」で、対象タスクに対応する自動トリガー設定が存在するかを確認し、あわせてタスクの記録とログを確認して異常がないかチェックします
Guance の「インフラストラクチャ - リソースディレクトリ」で資産情報が存在するか確認します
Guance の「メトリクス」で対応する監視データがあるか確認します

メトリクス¶

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

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

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

オブジェクト¶

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

{
  "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 内のフィールドは、今後の更新に伴って変更される場合があります