Step Functions コンソールでの実行の詳細の表示 - AWS Step Functions

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Step Functions コンソールでの実行の詳細の表示

Step Functions コンソールの [実行] セクションで、ワークフローの進行中および過去の実行を表示できます。

[実行] の詳細では、ステートマシンの定義、実行ステータス、ARN、状態遷移の数、ワークフロー内の個々の状態の入力および出力を表示できます。

実行のリストを示すスクリーンショットの例。

Standard ワークフロー実行の詳細は Step Functions に記録されますが、Express ワークフロー実行の履歴は記録されません。Express ワークフローの実行履歴を記録するには、Express ステートマシンを設定して、Amazon CloudWatch へのログを送信する必要があります。Step Functions のログ記録を設定するには、「 CloudWatch ログへのログイン」を参照してください。

両方のタイプのワークフロー実行を表示するコンソールエクスペリエンスは似ていますが、Express ワークフローにはいくつかの制限があります。「Standard コンソールと Express コンソールのエクスペリエンスの違い」を参照してください。

注記

Express ワークフローの実行データは CloudWatch Logs Insights を使用して表示されるため、ログをスキャンすると料金が発生します。デフォルトでは、ロググループには過去 3 時間に完了した実行のみが一覧表示されます。より多くの実行イベントを含むより広い時間範囲を指定すると、コストが増加します。詳細については、「CloudWatch Pricing」ページの [Logs] タブにある [Vended Logs] を参照してください。

実行の詳細の概要

[実行の詳細] リンクおよびページタイトルは、Step Functions によって生成された一意の実行 ID またはワークフローの開始時に指定したカスタム ID を使用します。[実行の詳細] ページには、ステートマシンを管理するためのメトリクスと以下のオプションが含まれています。

  • [実行を停止] - 進行中の実行を停止します。(完了した実行では利用できません)。

  • 新しい実行を開始 — ステートマシンの新しい実行を開始します。

  • Redrive – 過去 14 日間に正常に完了しなかった Standard ワークフローの Redrive 実行。失敗した、中止された、またはタイムアウトした実行が含まれます。詳細については、「Redriving ステートマシン」を参照してください。

  • エクスポート - 実行の詳細を JSON 形式でエクスポートして共有したり、オフライン分析を実行したりできます。

バージョンまたはエイリアスで開始された実行の表示

Step Functions コンソールでは、バージョンまたはエイリアスで開始された実行を確認することもできます。詳細については、「Listing executions for versions and aliases」を参照してください。

[実行の詳細] コンソールページには、次のセクションが含まれています。

実行の概要

[実行の概要] では、ワークフローの実行の詳細の概要が次のタブに表示されます。

詳細

実行のステータス、ARN、実行開始時刻と終了時刻のタイムスタンプなどの情報を表示します。ステートマシンの実行中に発生した [状態遷移] の合計数も表示できます。ステートマシンのトレースまたはログを有効にしている場合は、[X-Ray トレースマップ] と Amazon CloudWatch [実行ログ] のリンクも表示できます。

ステートマシンの実行が別のステートマシンによって開始された場合、このタブで親ステートマシンのリンクを表示できます。

ステートマシンの実行が redriven だった場合、このタブには Redrive カウントなどの redrive 関連情報が表示されます。

実行の入力と出力

ステートマシンの実行の入力と出力を並べて表示します。

定義

ステートマシンの Amazon States Language 定義を表示します。

エラーメッセージ

ステートマシンの実行に失敗すると、[実行の詳細] ページにエラーメッセージが表示されます。エラーメッセージの [原因] または [ステップの詳細を表示] を選択すると、実行が失敗した理由またはエラーの原因となったステップが表示されます。

[ステップの詳細を表示] を選択すると、Step Functions は [ステップの詳細][グラフビュー][テーブルビュー] の各タブでエラーの原因となったステップを強調表示します。ステップがリトライを定義したタスク、マップ、またはパラレルの状態である場合、[ステップの詳細] ペインにはそのステップの [再試行] タブが表示されます。さらに、実行をredrivenした場合、[ステップの詳細] ペインの [再試行とredrives] タブに再試行と実行のredriveの詳細が表示されます。

このエラーメッセージの [復元] ドロップダウンボタンから、失敗した実行をredriveまたは新しい実行を開始できます。詳細については、「Redriving ステートマシン」を参照してください。

ステートマシンの実行に失敗したことを示すエラーメッセージが [実行の詳細] ページに表示されます。エラーメッセージには、実行失敗の原因となったステップへのリンクも表示されます。

表示モード

[表示モード] セクションには、ステートマシンの 2 つの異なる可視化が含まれています。ワークフローのグラフィック表示、ワークフロー内の状態の概要を示す表、またはステートマシンの実行に関連するイベントのリストのいずれかを選択できます。

グラフビュー

[グラフビュー] モードでは、ワークフローを図で示したものが表示されます。下部には、ステートマシンの実行ステータスを示す凡例が表示されます。また、ワークフロー全体を拡大/縮小したり、中央そろえにしたり、ワークフローを全画面モードで表示したりできるボタンもあります。

このグラフでは、ワークフロー内の任意のステップを選択して、その実行に関する詳細を [ステップの詳細] コンポーネントに表示できます。[グラフビュー] でステップを選択すると、[テーブルビュー] にもそのステップが表示されます。これは逆の場合も同様です。[テーブルビュー] からステップを選択すると、[グラフビュー] にも同じステップが表示されます。

ステートマシンに Map 状態、Parallel 状態、あるいはその両方が含まれている場合は、ワークフロー内の [グラフビュー] でその名前を確認できます。さらに、Map 状態の場合、[グラフビュー] では [マップ] 状態実行データのさまざまな反復間を移動できます。例えば、[マップ] 状態に 5 回の反復があり、3 回目と 4 回目の反復の実行データを表示する場合、次の操作を行います。

  1. 反復データを表示する [マップ] 状態を選択します。

  2. [マップイテレーションビューア] で、3 回目の反復のドロップダウンリストから [#2] を選択します。これは、反復回数が 0 からカウントされるためです。同様に、[マップ] 状態の 4 回目の反復では、ドロップダウンリストから #3 を選択します。

    または、上矢印アイコンおよび下矢印アイコンコントロールを使用して、[Map] 状態の異なる反復間を移動することもできます。

    注記

    ステートマシンにネストされた Map 状態が含まれている場合、親と子の Map 状態の反復のドロップダウンリストに反復データが示されるように表示されます。

  3. (オプション) [マップ] 状態の反復処理が 1 つ以上実行に失敗した場合、または実行が中止された場合は、ドロップダウンリストの [失敗] または [中止] で反復番号を選択すると、そのデータを表示できます。

最後に、[エクスポート] ボタンと [レイアウト] ボタンを使用して、ワークフローグラフを SVG または PNG 画像としてエクスポートできます。ワークフローを水平表示と垂直表示間で切り替えることもできます。

テーブルビュー

[テーブルビュー] モードでは、ワークフロー内の状態が表形式で表示されます。この [表示モード] では、名前、使用したリソース (AWS Lambda 関数など) の名前、状態が正常に実行されたかどうかなど、ワークフローで実行された各状態の詳細を確認できます。

このビューでは、ワークフロー内の任意のステップを選択して、その実行に関する詳細を [ステップの詳細] コンポーネントに表示できます。[テーブルビュー] でステップを選択すると、[グラフビュー] にもそのステップが表示されます。これは逆の場合も同様です。[グラフビュー] からステップを選択すると、[テーブルビュー] にも同じステップが表示されます。

また、ビューにフィルターを適用して、[テーブルビュー] モードで表示されるデータ量を制限することもできます。[ステータス][Redrive の試行] など、特定のプロパティに対してフィルターを作成できます。詳細については、「実行内容を調べる」を参照してください。

デフォルトでは、このモードには、[名前][タイプ][ステータス][リソース][開始後] の各列が表示されます。表示する列は、[環境設定] ダイアログボックスを使用して設定できます。このダイアログボックスで行った選択は、再び変更されるまで今後ステートマシンを実行しても保持されます。

[タイムライン] 列を追加すると、実行全体における各状態の実行時間がランタイムを基準にして表示されます。これは色分けされた、線形のタイムラインとして表示されます。これにより、特定の状態の実行に関するパフォーマンス関連の問題を特定しやすくなります。タイムライン上の各状態の色分けされたセグメントは、進行中、失敗、中止などの状態の実行ステータスを識別するのに役立ちます。

例えば、ステートマシンの状態に対して実行リトライを定義した場合、そのリトライはタイムラインに表示されます。赤色のセグメントは失敗した Retry の試行を表し、薄い灰色のセグメントは各 Retry 試行の合間の BackoffRate を表します。

タイムラインに色分けされたセグメントを含むテーブルビューのスクリーンショット。

ステートマシンに Map 状態、Parallel 状態、あるいはその両方が含まれている場合は、ワークフロー内の [テーブルビュー] でその名前を確認できます。MapParallel 状態の場合、[テーブルビュー] モードでは反復と並列分岐の実行データがツリービュー内のノードとして表示されます。これらの状態の各ノードを選択すると、[ステップの詳細] セクションに個別の詳細を表示できます。例えば、状態が失敗する原因となった特定の [マップ] 状態反復のデータを確認できます。[マップ] 状態のノードを展開し、[ステータス] 列に各反復のステータスが表示されます。

ステップの詳細

[グラフビュー] または [テーブルビュー] で状態を選択すると、右側に [ステップの詳細] セクションが開きます。このセクションには以下のタブがあり、選択した状態に関する詳細な情報が表示されます。

Input (入力)

選択した状態の入力詳細が表示されます。入力にエラーがある場合は、タブヘッダーに [エラー] アイコンが表示されます。また、このタブではエラーの原因を確認できます。

また、[アドバンスドビュー] トグルボタンを選択して、データが選択した状態を通過したときの入力データ転送パスを確認することもできます。これにより、InputPathParametersResultSelectorOutputPathResultPath などの 1 つ以上のフィールドがデータに適用されたときに、入力がどのように処理されたかがわかります。

出力

選択した状態の出力を表示します。出力にエラーがある場合は、タブヘッダーに [エラー] アイコンが表示されます。また、このタブではエラーの原因を確認できます。

また、[アドバンスドビュー] トグルボタンを選択して、データが選択した状態を通過したときの出力データ転送パスを確認することもできます。これにより、InputPathParametersResultSelectorOutputPathResultPath などの 1 つ以上のフィールドがデータに適用されたときに、入力がどのように処理されたかがわかります。

詳細

状態タイプ、実行ステータス、実行時間などの情報を表示します。

リソースを使用する Task 状態 (AWS Lambda など) では、このタブにはリソース定義ページへのリンクと、リソース呼び出しの Amazon CloudWatch ログページへのリンクが表示されます。また、指定されている場合は、Task 状態の TimeoutSecondsHeartbeatSeconds フィールドの値も表示されます。

Map 状態の場合、このタブには Map 状態の反復回数の合計に関する情報が表示されます。反復は、[失敗][中止][成功]、または [InProgress] に分類されます。

定義

選択した状態に対応する Amazon States Language 定義を表示します。

再試行
注記

このタブは、ステートマシンの Task または Parallel 状態で Retry フィールドを定義した場合にのみ表示されます。

選択した状態での最初の実行試行回数とそれ以降の再試行回数が表示されます。初回およびそれ以降のすべての失敗について、[タイプ] の横にある矢印アイコンを選択すると、ドロップダウンボックスに表示される失敗の [理由] が表示されます。再試行が成功すると、ドロップダウンボックスに表示される [出力] が表示されます。

実行をredrivenした場合、このタブヘッダーには [再試行とredrives] という名前が表示され、それぞれのredriveの再試行の詳細が表示されます。

イベント

実行中の選択した状態に関連するイベントを、フィルター処理したリストで表示します。このタブに表示される情報は、[イベント] テーブルに表示される実行イベント履歴全体の一部にすぎません。

イベント

[イベント] テーブルには、選択した実行の全履歴が、複数のページにまたがるイベントのリストとして表示されます。各ページには最大 25 件のイベントが含まれます。このセクションにはイベントの合計数も表示されるので、イベント履歴の最大数である 25,000 イベントを超えているかどうかを判断するのに役立ちます。

ワークフロー実行の部分的なイベント履歴を示すスクリーンショットの例。

デフォルトでは、[イベント] テーブルの結果は、イベントの [タイムスタンプ] に基づいて昇順に表示されます。[タイムスタンプ] 列のヘッダーをクリックすると、実行イベント履歴のソートを降順に変更できます。

[イベント] テーブルでは、各イベントが実行ステータスを示すように色分けされています。例えば、失敗したイベントは赤で表示されます。イベントに関するその他の詳細情報を表示するには、イベント ID の横にある矢印アイコンを選択します。イベントを開くと、そのイベントの入力、出力、リソース呼び出しがイベント詳細に表示されます。

さらに、[イベント] テーブルでは、フィルターを適用して表示される実行イベント履歴の結果を制限できます。[ID][Redrive 再試行] などのプロパティを選択できます。詳細については、「実行内容を調べる」を参照してください。

Standard コンソールと Express コンソールのエクスペリエンスの違い

Standard ワークフロー

Standard ワークフローの実行履歴は、過去 90 日間に完了した実行の履歴をいつでも確認できます。

Express ワークフロー

Express ワークフローでは、実行履歴を表示するために、Step Functions コンソールが CloudWatch Logs ロググループを通じて収集されたログデータを取得します。過去 3 時間以内に完了した実行の履歴はデフォルトで表示されます。時間範囲をカスタマイズできます。より多くの実行イベントを含むより広い時間範囲を指定すると、ログをスキャンするコストが増加します。詳細については、「CloudWatch 料金表」と CloudWatch ログへのログイン[ログ] タブにある [公開ログ] を参照してください。

Express ワークフロー実行の表示に関する考慮事項と制限

Step Functions コンソールで Express ワークフローの実行を表示する場合、次の考慮事項と制限事項に留意してください。

Express ワークフロー実行の詳細の可用性は Amazon CloudWatch Logs によって決まります

Express ワークフローでは、実行履歴と詳細な実行情報が CloudWatch Logs Insights を通じて収集されます。この情報は、ステートマシンの作成時に指定された CloudWatch Logs ロググループに保持されます。ステートマシンの実行履歴は、Step Functions コンソールの [実行] タブに表示されます。

警告

Express ワークフローの CloudWatch Logs を削除すると、そのログは [実行] タブに表示されなくなります。

すべての実行イベントタイプをログに記録するには、デフォルトのログレベル [すべて] を使用することをお勧めします。ステートマシンを編集するときに、必要に応じて既存のステートマシンのログレベルを更新できます。詳細については、 CloudWatch ログを使用した Step Functions の実行履歴のログ記録およびイベントログレベルを参照してください。

Partial Express ワークフロー実行の詳細は、ログ記録レベルが ERROR または FATAL の場合に表示されます。

デフォルトでは、Express ワークフロー実行のログ記録レベルは [すべて] に設定されています。ログレベルを変更しても、完了した実行の実行履歴と実行の詳細には影響しません。ただし、新しい実行ではすべて、更新されたログレベルに基づいてログが出力されます。詳細については、 CloudWatch ログを使用した Step Functions の実行履歴のログ記録およびイベントログレベルを参照してください。

例えば、ログレベルを [すべて] から [ERROR] または [FATAL] に変更した場合、Step Functions コンソールの [実行] タブには、失敗した実行のみが表示されます。[イベントビュー] タブでは、コンソールには失敗したステートマシンステップのイベント詳細のみが表示されます。

すべての実行イベントタイプをログに記録するには、デフォルトのログレベル [すべて] を使用することをお勧めします。ステートマシンを編集するときに、必要に応じて既存のステートマシンのログレベルを更新できます。

ステートマシンが変更された後、以前の実行のステートマシン定義を表示できない

Express ワークフローでは、過去の実行のステートマシン定義は保存されません。ステートマシン定義を変更した場合、最新の定義を使用した実行のステートマシン定義のみを表示できます。

例えば、ステートマシン定義から 1 つ以上のステップを削除すると、Step Functions は定義と以前の実行イベントとの不一致を検出します。以前の定義は Express ワークフローには保存されないため、Step Functions は以前のバージョンのステートマシン定義で実行された実行のステートマシン定義を表示できません。そのため、以前のバージョンのステートマシン定義で実行された実行には、[定義][グラフビュー]、および [テーブルビュー] タブは使用できません。