檢查分散式地圖狀態執行的對應執行 - AWS Step Functions

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

檢查分散式地圖狀態執行的對應執行

當您在分散式模式下執行Map狀態時,「Step Functions」會建立「對應執行」資源。Map Run 是指分散式地圖狀態啟動的一組子工作流程執行,以及控制這些執行的執行階段設定。Step Functions 將 Amazon 資源名稱(ARN)分配給您的地圖運行。您可以在 Step Functions 控制台中檢查地圖運行。您也可以叫用 DescribeMapRun API 動作。「地圖執行」也會向其發出 CloudWatch度量。

「Step Functions」主控台會提供「對應執行詳細資訊」頁面,此頁面會顯示與「分散式對應」狀態執行相關的所 例如,您可以檢視「分散式對應」狀態的執行狀態、Map Run 的 ARN,以及由「分散式對映」狀態開始的子工作流程執行中所處理的項目狀態。您也可以檢視所有子工作流程執行的清單,並存取其詳細資訊。此外,如果您的地圖運行是 redriven,則可以在部分中查看地圖運行的redrive映射運行執行摘要詳細信息。例如,最後一redrive次。控制台會以儀表板格式顯示此資訊。

「對應執行詳細資訊」頁面包含下列段落:

「對應執行詳細資訊」頁面會顯示三個段落:「對應執行」執行摘要、項目處理狀態以及執行清單。

映射運行執行摘要

對應執行執行項目摘要」段落會顯示在「對應執行詳細資訊」頁面頂端。本節提供「分散式對應」狀態之執行詳細資訊的概觀。此資訊會在下列標籤之間劃分:

詳細資訊

顯示資訊,例如「分散式對應」狀態的執行狀態、Map 執行 ARN,以及由「分散對應」狀態開始的子工作流程執行類型。您可以檢視其他組態,例如「對映執行」的容許失敗臨界值,以及為子工作流程執行指定的最大並行處理。您也可以編輯這些模型組態。

輸入和輸出

顯示分散式地圖狀態接收的輸入及其產生的對應輸出。例如,您可以檢視輸入資料集及其位置,以及套用至該資料集中個別資料項目的輸入篩選器。如果您匯出分散式地圖狀態執行的輸出,此索引標籤會顯示包含執行結果的 Amazon S3 儲存貯體的路徑。否則,它會將您指向父工作流程的「執行詳細資訊」頁面,以檢視執行輸出。

錯誤訊息

如果您的 Map 執行失敗,[對應執行詳細資訊] 頁面會顯示錯誤訊息,說明失敗的原因。

從此錯誤訊息上的 [復原] 下拉式按鈕中,您可以redrive使用此 Map Run 啟動的失敗子工作流程執行,也可以啟動父工作流程的新執行。如需詳細資訊,請參閱 Redriving地圖運行

[對映執行詳細資訊] 頁面上的 [對映執行失敗] 的錯誤訊息。錯誤訊息也會顯示從失敗中復原的選項。

料號處理狀態

料號處理狀態」區段會顯示「對映執行」中處理之料號的狀態。例如,「待處理」 表示子工作流程執行尚未開始處理項目。

項目狀態取決於處理項目的子工作流程執行的狀態。如果子工作流程執行失敗、逾時或使用者取消執行,Step Functions 就不會收到有關該子工作流程執行內之項目處理結果的任何資訊。該執行處理的所有項目都會共用子工作流程執行的狀態。

例如,假設您要在兩個子工作流程執行中處理 100 個項目,其中每個執行都會處理 50 個項目的批次。如果其中一個執行失敗而另一個執行成功,則您將擁有 50 個成功和 50 個失敗的項目。

下表說明所有料號可用的處理狀態型態:

狀態 描述

待定

指出子工作流程執行尚未開始處理的項目。如果 Map Run 停止、失敗或使用者在處理項目開始之前取消執行,則該項目將保持在「處理」狀態。

例如,如果 Map Run 失敗且有 10 個待處理的項目,則這 10 個項目仍處於「擱置中」狀態。

執行中

指出子工作流程執行目前正在處理的項目。

成功

指出子工作流程執行已成功處理項目。

成功的子工作流程執行不能有任何失敗的項目。如果資料集中的某個項目在執行期間失敗,則整個子工作流程執行都會失敗。

失敗

指出子工作流程執行無法處理項目,或執行逾時。如果子工作流程執行處理的任何一個項目失敗,則整個子工作流程執行都會失敗。

例如,考慮一個處理 1000 個項目的子工作流程執行。如果該資料集中的任何一個項目在執行期間失敗,則 Step Functions 會將整個子工作流程執行視為失敗。

當您執redrive行 Map Run 時,具有此狀態的項目計數會重設為 0。

已中止

指出子項工作流程執行已開始處理項目,但使用者已取消執行,或是「Step Functions」因為「對應執行」失敗而停止執行。

例如,請考慮在處理 50 個項目的執行子工作流程執行。如果 Map Run 因為失敗或使用者取消了執行而停止,則子工作流程執行和所有 50 個項目的狀態都會變更為「已中止」。

如果您使用 Express 類型的子工作流程執行,則無法停止執行。

當您redrive啟動 Express 類型的子工作流程執行的 Map Run 時,具有此狀態的項目計數將重設為 0。這是因為 Express 子工作流程會使用 StartExecutionAPI 動作而不是重新啟動redriven。

執行清單

執行項目」段落會列出特定 Map Run 的所有子工作流程執行項目。使用 [按確切執行名稱搜尋] 欄位來搜尋特定的子工作流程執行項目。您也可以使用「任何狀態」 下拉式清單,依狀態篩選子工作流程執行歷史記錄。若要查看有關特定執行項目的詳細資訊,請從清單中選取子項工作流程執行,然後選擇檢視詳細資訊按鈕以開啟其執行詳細資訊頁面。

重要

子工作流程執行的保留原則為 90 天。超過此保留期間的已完成子工作流程執行不會顯示在「執行項目」表格中。即使「分散式對應」狀態或父工作流程的執行時間長於保留期間,也是如此。如果您使ResultWriter用將分散式地圖狀態輸出匯出到 Amazon S3 儲存貯體,則可以檢視這些子工作流程執行的執行詳細資料 (包括結果)。

提示

選擇重新整理按鈕 bell 以檢視所有子工作流程執行的最新清單。