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

# 在 Step Functions 中檢視分散式映射執行
<a name="concepts-examine-map-run"></a>

Step Functions 主控台提供*映射執行詳細資訊*頁面，顯示*與分散式映射狀態*執行相關的所有資訊。例如，您可以檢視*分散式地圖狀態*執行的狀態、地圖執行的 ARN，以及在*分散式地圖狀態*啟動的子工作流程執行中處理的項目狀態。您也可以檢視所有子工作流程執行的清單，並存取其詳細資訊。如果您的 Map Run 是 [redriven](redrive-map-run.md)，您也會在 Map Run 執行摘要中看到redrive詳細資訊。

當您在分散式模式下執行 `Map` 狀態時，Step Functions 會建立 Map Run 資源。Map Run 是指*分散式映射狀態*啟動的一組子工作流程執行，以及控制這些執行的執行時間設定。Step Functions 會將 Amazon Resource Name (ARN) 指派給您的 Map Run。您可以在 Step Functions 主控台中檢查 Map Run。您也可以叫用 `[DescribeMapRun](https://docs.aws.amazon.com/step-functions/latest/apireference/API_DescribeMapRun.html)` API 動作。

Map Run 的子工作流程執行會向 發出指標 CloudWatch；。這些指標會有標記的狀態機器 ARN，格式如下：

 `arn:partition:states:region:account:stateMachine:stateMachineName/MapRunLabel or UUID` 

*Map Run 詳細資訊*有三個部分：*Map Run 執行摘要*、*項目處理狀態*和*列出執行*。

## Map Run 執行摘要
<a name="map-run-exec-summary"></a>

*Map Run Execution 摘要*提供*分散式映射狀態*的執行詳細資訊概觀。

**詳細資訊**  
顯示*分散式映射狀態*的執行狀態、映射執行 ARN，以及*分散式映射狀態*啟動的子工作流程執行類型。您可以檢視其他組態，例如 Map Run 的容錯閾值，以及為子工作流程執行指定的並行上限。

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

## 錯誤訊息
<a name="map-run-error-banner"></a>

如果您的映射執行失敗，*映射執行詳細資訊*頁面會顯示錯誤訊息，其中包含失敗原因。

從此錯誤訊息的**復原**下拉式按鈕中，您可以啟動此映射執行redrive失敗的子工作流程執行，或啟動父工作流程的新執行。

請參閱 以[Redriving 映射執行](redrive-map-run.md)了解如何重新啟動您的工作流程。

## 項目處理狀態
<a name="map-run-item-process-status"></a>

**項目處理狀態**區段會顯示 Map Run 中所處理項目的狀態。例如，**待定**表示子工作流程執行尚未開始處理項目。

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

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

下表說明所有項目可用的處理狀態類型：


| 狀態 | Description | 
| --- | --- | 
|  **待定**  |  指出子工作流程執行尚未開始處理的項目。如果 Map Run 在項目處理開始之前停止、失敗或使用者取消執行，則該項目會保持**待定**狀態。 例如，如果 Map Run 失敗，其中包含 10 個未處理的項目，這 10 個項目會保持**待定**狀態。  | 
|  **執行中**  |  指出子工作流程執行目前正在處理的項目。  | 
|  **成功**  |  指出子工作流程執行已成功處理項目。 成功的子工作流程執行不能有任何失敗的項目。如果資料集中的一個項目在執行期間失敗，則整個子工作流程執行會失敗。  | 
|  **失敗**  |  表示子工作流程執行無法處理項目，或執行逾時。如果子工作流程執行處理的任何一個項目失敗，則整個子工作流程執行會失敗。 例如，請考慮處理 1000 個項目的子工作流程執行。如果該資料集中的任何一個項目在執行期間失敗，則 Step Functions 會將整個子工作流程執行視為失敗。 當您[redrive](redrive-map-run.md)映射執行時，具有此狀態的項目計數會重設為 0。  | 
|  **已中止**  |  指出子工作流程執行已開始處理項目，但使用者已取消執行，或 Step Functions 因 Map Run 失敗而停止執行。 例如，請考慮正在處理 50 個項目的**執行**中子工作流程執行。如果 Map Run 因為失敗或使用者取消執行而停止，則子工作流程執行和所有 50 個項目的狀態都會變更為**已中止**。 如果您使用 **Express** 類型的子工作流程執行，則無法停止執行。 當您啟動 Express 類型的子工作流程執行的 [redrive](redrive-map-run.md) Map Run 時，具有此狀態的項目計數會重設為 0。這是因為 Express 子工作流程會使用 [StartExecution](https://docs.aws.amazon.com/step-functions/latest/apireference/API_StartExecution.html) API 動作重新啟動，而不是 redriven。  | 

## 列出執行
<a name="map-run-exec-table"></a>

**執行**區段列出特定 Map Run 的所有子工作流程執行。使用**依確切執行名稱搜尋**欄位來搜尋特定的子工作流程執行。若要查看特定執行的詳細資訊，請從清單中選擇子工作流程執行，然後選擇**檢視詳細資訊**按鈕以開啟其[*執行詳細資訊*](concepts-view-execution-details.md)頁面。

您也可以使用 API 或 AWS CLI 列出 Map Run 啟動的子工作流程執行：
+ 使用 API，呼叫 [ListExecutions](https://docs.aws.amazon.com/step-functions/latest/apireference/API_ListExecutions.html)，並將 `mapRunArn` 參數設定為父工作流程的 ARN。
+ 使用 AWS CLI，呼叫 [list-executions](https://docs.aws.amazon.com/cli/latest/reference/stepfunctions/list-executions.html) 並將 `map-run-arn` 參數設定為父工作流程的 ARN。

**重要**  
子工作流程執行的保留政策為 90 天。  
 較舊的已完成子工作流程執行不會顯示在**執行**資料表中，即使*分散式映射狀態*或父工作流程繼續執行的時間超過保留期間。如果您使用 將*分散式映射狀態*輸出匯出至 Amazon S3 儲存貯體，您可以檢視這些子工作流程執行的執行詳細資訊，包括結果`ResultWriter （地圖）`。

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