翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Step Functions コンソールでの実行の表示とデバッグ
Step Functions コンソールの [実行の詳細] ページには、Standard ワークフローと Express ワークフローの過去および進行中のステートマシン実行に関する情報が表示されます。この情報はダッシュボード形式で表示されます。例えば、ステートマシンの Amazon States Language 定義、その実行ステータス、ARN、および状態遷移の合計数を確認できます。ステートマシン内の個々のステートの実行の詳細も表示できます。
[実行の詳細] ページ - インターフェイスの概要
[実行の詳細] ページでは、Standard ワークフローと Express ワークフローの両方で進行中および過去のステートマシン実行の詳細を確認できます。実行の開始時に実行 ID を指定した場合、このページにはその実行 ID が付けられます。それ以外の場合は、Step Functions が自動的に生成する固有の実行 ID でタイトルが付けられます。
実行メトリクスの他に、[実行の詳細] ページにはステートマシンとその実行を管理するための以下のオプションがあります。
| Button | 次の操作をするには、このボタンを選択します。 |
|---|---|
| ステートマシンの編集 | ステートマシンの Amazon States Language 定義を編集します。 |
| 新しい実行 | ステートマシンの新しい実行を開始します。 |
| アクション | 次のオプションから選択してください。
|
バージョンまたはエイリアスで開始された実行の表示
Step Functions コンソールでは、バージョンまたはエイリアスで開始された実行を確認することもできます。詳細については、「Listing executions for versions and aliases」を参照してください。
[実行の詳細] コンソールページには、次のセクションが含まれています。
実行の概要
[実行概要] セクションは [実行の詳細] ページの上部に表示されます。このセクションでは、ワークフローの実行の詳細の概要を説明します。この情報は次の 3 つのタブに分かれています。
- 詳細
-
実行のステータス、、実行開始時刻ARNと終了時刻のタイムスタンプなどの情報を表示します。ステートマシンの実行中に発生した [状態遷移] の合計数も表示できます。ステートマシンのトレースまたはログを有効にしている場合は、X-Ray トレースマップ CloudWatch と Amazon 実行ログのリンクを表示することもできます。
ステートマシンの実行が別のステートマシンによって開始された場合、このタブで親ステートマシンのリンクを表示できます。
ステートマシンの実行が redriven だった場合、このタブには Redrive カウントなどの redrive 関連情報が表示されます。
- 実行の入力と出力
-
ステートマシンの実行入出力 を表示します side-by-side。
- 定義
-
ステートマシンの Amazon States Language 定義を表示します。
エラーメッセージ
ステートマシンの実行に失敗すると、[実行の詳細] ページにエラーメッセージが表示されます。エラーメッセージの [原因] または [ステップの詳細を表示] を選択すると、実行が失敗した理由またはエラーの原因となったステップが表示されます。
[ステップの詳細を表示] を選択すると、Step Functions は [ステップの詳細]、[グラフビュー]、[テーブルビュー] の各タブでエラーの原因となったステップを強調表示します。ステップがリトライを定義したタスク、マップ、またはパラレルの状態である場合、[ステップの詳細] ペインにはそのステップの [再試行] タブが表示されます。さらに、実行をredrivenした場合、[ステップの詳細] ペインの [再試行とredrives] タブに再試行と実行のredriveの詳細が表示されます。
このエラーメッセージの [復元] ドロップダウンボタンから、失敗した実行をredriveまたは新しい実行を開始できます。詳細については、「Redriving Step Functions での ステートマシンの実行」を参照してください。
失敗したステートマシンの実行に関するエラーメッセージは、実行の詳細ページに表示されます。エラーメッセージには、実行失敗の原因となったステップへのリンクも表示されます。
表示モード
[表示モード] セクションには、ステートマシンの 2 つの異なる可視化が含まれています。ワークフローのグラフィック表示、ワークフロー内の状態の概要を示す表、またはステートマシンの実行に関連するイベントのリストのいずれかを選択できます。
グラフビュー
[グラフビュー] モードでは、ワークフローを図で示したものが表示されます。下部には、ステートマシンの実行ステータスを示す凡例が表示されます。また、ワークフロー全体を拡大/縮小したり、中央そろえにしたり、ワークフローを全画面モードで表示したりできるボタンもあります。
グラフビューからワークフロー内の任意のステップを選択して、その実行に関する詳細をステップ詳細コンポーネントで表示できます。[グラフビュー] でステップを選択すると、[テーブルビュー] にもそのステップが表示されます。これは逆の場合も同様です。[テーブルビュー] からステップを選択すると、[グラフビュー] にも同じステップが表示されます。
ステートマシンに Map 状態、Parallel 状態、あるいはその両方が含まれている場合は、ワークフロー内の [グラフビュー] でその名前を確認できます。さらに、Map 状態の場合、[グラフビュー] では [マップ] 状態実行データのさまざまな反復間を移動できます。例えば、[マップ] 状態に 5 回の反復があり、3 回目と 4 回目の反復の実行データを表示する場合、次の操作を行います。
-
反復データを表示する [マップ] 状態を選択します。
-
[マップイテレーションビューア] で、3 回目の反復のドロップダウンリストから [#2] を選択します。これは、反復回数が 0 からカウントされるためです。同様に、[マップ] 状態の 4 回目の反復では、ドロップダウンリストから #3 を選択します。
または、上矢印アイコンと下矢印アイコンのコントロールを使用して、マップ状態の異なる反復間を移動します。
注記
ステートマシンにネストされた
Map状態が含まれている場合、親状態と子Map状態の反復のドロップダウンリストが表示され、反復データを表します。 -
(オプション) [マップ] 状態の反復処理が 1 つ以上実行に失敗した場合、または実行が中止された場合は、ドロップダウンリストの [失敗] または [中止] で反復番号を選択すると、そのデータを表示できます。
最後に、エクスポートボタンとレイアウトボタンを使用して、ワークフローグラフを SVGまたは PNGイメージとしてエクスポートできます。ワークフローを水平表示と垂直表示間で切り替えることもできます。
テーブルビュー
[テーブルビュー] モードでは、ワークフロー内の状態が表形式で表示されます。この表示モードでは、ワークフローで実行された各状態の詳細、名前、使用したリソースの名前 ( AWS Lambda 関数など）、状態が正常に実行されたかどうかなどを確認できます。
このビューでは、ワークフロー内の任意のステップを選択して、その実行に関する詳細を [ステップの詳細] コンポーネントに表示できます。[テーブルビュー] でステップを選択すると、[グラフビュー] にもそのステップが表示されます。これは逆の場合も同様です。[グラフビュー] からステップを選択すると、[テーブルビュー] にも同じステップが表示されます。
また、ビューにフィルターを適用して、[テーブルビュー] モードで表示されるデータ量を制限することもできます。[ステータス] や [Redrive の試行] など、特定のプロパティに対してフィルターを作成できます。詳細については、「チュートリアル: Step Functions でステートマシンの実行を確認する」を参照してください。
デフォルトでは、このモードには、[名前]、[タイプ]、[ステータス]、[リソース]、[開始後] の各列が表示されます。表示する列は、[環境設定] ダイアログボックスを使用して設定できます。このダイアログボックスで行った選択は、再び変更されるまで今後ステートマシンを実行しても保持されます。
[タイムライン] 列を追加すると、実行全体における各状態の実行時間がランタイムを基準にして表示されます。これは色分けされた、線形のタイムラインとして表示されます。これにより、特定の状態の実行に関するパフォーマンス関連の問題を特定しやすくなります。タイムライン上の各状態の色分けされたセグメントは、進行中、失敗、中止などの状態の実行ステータスを識別するのに役立ちます。
例えば、ステートマシンの状態に対して実行リトライを定義した場合、そのリトライはタイムラインに表示されます。赤色のセグメントは失敗した Retry の試行を表し、薄い灰色のセグメントは各 Retry 試行の合間の BackoffRate を表します。
ステートマシンに Map 状態、Parallel 状態、あるいはその両方が含まれている場合は、ワークフロー内の [テーブルビュー] でその名前を確認できます。Map と Parallel 状態の場合、[テーブルビュー] モードでは反復と並列分岐の実行データがツリービュー内のノードとして表示されます。これらの状態の各ノードを選択すると、[ステップの詳細] セクションに個別の詳細を表示できます。例えば、状態が失敗する原因となった特定の [マップ] 状態反復のデータを確認できます。[マップ] 状態のノードを展開し、[ステータス] 列に各反復のステータスが表示されます。
ステップの詳細
[グラフビュー] または [テーブルビュー] で状態を選択すると、右側に [ステップの詳細] セクションが開きます。このセクションには以下のタブがあり、選択した状態に関する詳細な情報が表示されます。
- Input (入力)
-
選択した状態の入力詳細が表示されます。入力にエラーがある場合、タブヘッダーにエラーアイコンが表示されます。また、このタブではエラーの原因を確認できます。
また、[アドバンスドビュー] トグルボタンを選択して、データが選択した状態を通過したときの入力データ転送パスを確認することもできます。これにより、
InputPath、Parameters、ResultSelector、OutputPath、ResultPathなどの 1 つ以上のフィールドがデータに適用されたときに、入力がどのように処理されたかがわかります。 - 出力
-
選択した状態の出力を表示します。出力にエラーがある場合、タブヘッダーにエラーアイコンが表示されます。また、このタブではエラーの原因を確認できます。
また、[アドバンスドビュー] トグルボタンを選択して、データが選択した状態を通過したときの出力データ転送パスを確認することもできます。これにより、
InputPath、Parameters、ResultSelector、OutputPath、ResultPathなどの 1 つ以上のフィールドがデータに適用されたときに、入力がどのように処理されたかがわかります。 - 詳細
-
状態タイプ、実行ステータス、実行時間などの情報を表示します。
などのリソースを使用する
Task州の場合 AWS Lambda、このタブにはリソース呼び出しのリソース定義ページと Amazon CloudWatch ログページへのリンクが表示されます。また、指定されている場合は、Task状態のTimeoutSecondsとHeartbeatSecondsフィールドの値も表示されます。Map状態の場合、このタブにはMap状態の反復回数の合計に関する情報が表示されます。反復は、失敗、中止、成功、または に分類されますInProgress。 - 定義
-
選択した状態に対応する Amazon States Language 定義を表示します。
- 再試行
-
注記
このタブは、ステートマシンの
TaskまたはParallel状態でRetryフィールドを定義した場合にのみ表示されます。選択した状態での最初の実行試行回数とそれ以降の再試行回数が表示されます。最初の試行とその後のすべての失敗については、タイプ の横にある矢印アイコンを選択して、ドロップダウンボックスに表示される失敗の理由を表示します。再試行が成功すると、ドロップダウンボックスに表示される [出力] が表示されます。
実行をredrivenした場合、このタブヘッダーには [再試行とredrives] という名前が表示され、それぞれのredriveの再試行の詳細が表示されます。
- イベント
-
実行中の選択した状態に関連するイベントを、フィルター処理したリストで表示します。このタブに表示される情報は、[イベント] テーブルに表示される実行イベント履歴全体の一部にすぎません。
イベント
[イベント] テーブルには、選択した実行の全履歴が、複数のページにまたがるイベントのリストとして表示されます。各ページには最大 25 件のイベントが含まれます。このセクションにはイベントの合計数も表示されるので、イベント履歴の最大数である 25,000 イベントを超えているかどうかを判断するのに役立ちます。
デフォルトでは、[イベント] テーブルの結果は、イベントの [タイムスタンプ] に基づいて昇順に表示されます。[タイムスタンプ] 列のヘッダーをクリックすると、実行イベント履歴のソートを降順に変更できます。
[イベント] テーブルでは、各イベントが実行ステータスを示すように色分けされています。例えば、失敗したイベントは赤で表示されます。イベントに関する詳細を表示するには、イベント ID の横にある矢印アイコンを選択します。イベントを開くと、そのイベントの入力、出力、リソース呼び出しがイベント詳細に表示されます。
さらに、[イベント] テーブルでは、フィルターを適用して表示される実行イベント履歴の結果を制限できます。[ID] や [Redrive 再試行] などのプロパティを選択できます。詳細については、「チュートリアル: Step Functions でステートマシンの実行を確認する」を参照してください。
