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

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

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

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

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

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

実行の詳細の概要

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

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

実行の概要

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

エラーメッセージ

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

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

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

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

表示モード

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

グラフビュー

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

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

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

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

テーブルビュー

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

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

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

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

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

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

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

ステップの詳細

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

イベント

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

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

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

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

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

Standard ワークフロー

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

Express ワークフロー

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

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

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

Express ワークフロー実行の詳細の可用性は Amazon CloudWatch Logs に依存します

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

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

ログ記録レベルが ERRORまたは の場合、Partial Express ワークフロー実行の詳細を使用できます。 FATAL

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

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

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

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

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

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