在 Step Functions 主控台中檢視執行詳細資訊 - AWS Step Functions

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

在 Step Functions 主控台中檢視執行詳細資訊

您可以在 Step Functions 主控台的 [執行] 區段中檢視工作流程進行中和過去的工作流程執行

Executions 詳細資料中,您可以檢視狀態機器的定義、執行狀態ARN、狀態轉換數目,以及工作流程中個別狀態的輸入和輸出。

顯示執行列表的說明性屏幕截圖。

標準工作流程執行詳細資訊會記錄在「Step Functions」中,但 Express 工作流程執行的歷史記錄則不會記錄。若要記錄 Express 工作流程執行,您必須將快速狀態機器設定為將日誌傳送到 Amazon CloudWatch。請參登入 CloudWatch 記錄閱設定 Step Functions 的記錄。

檢視這兩種工作流程執行類型的主控台體驗類似,但是 Express 工作流程有一些限制。請參閱 標準和快速主控台體驗差異

注意

由於 Express 工作流程的執行資料是使用 CloudWatch 記錄深入分析來顯示,因此掃描記錄會產生費用。根據預設,您的記錄群組只會列出過去三小時內完成的執行項目。如果您指定包含更多執行事件的較大時間範圍,您的成本就會增加。如需詳細資訊,請參閱「定價」面上「記」索引標籤下的「CloudWatch 付費記錄」。

執行細節概述

執行詳細資料連結和頁面標題使用 Step Functions 產生的唯一執行 ID,或您在啟動工作流程時提供的自訂 ID。「執行詳細資訊」頁面包含測量結果以及管理狀態機器的下列選項:

  • 停止執行 — 停止進行中的執行。(不適用於已完成的執行項目。)

  • 開始新的執行 — 啟動狀態機器的新執行

  • Redrive – Redrive 在過去 14 天內未成功完成的標準工作流程執行,包括失敗、中止或逾時的執行。如需詳細資訊,請參閱Redriving 狀態機器

  • 匯出 — 以JSON格式匯出執行詳細資訊,以共用或執行離線分析。

檢視以版本或別名開始的執行

您也可以在 Step Functions 主控台中檢視以版本或別名開始的執行。如需詳細資訊,請參閱列出版本和別名的執行項目

執行詳細資訊:主控台」頁面包含下列段落:

執行摘要

執行」摘要在下列標籤中提供工作流程執行詳細資訊的概觀:

詳細資訊

顯示執行開始和結束時間等資訊ARN,以及執行開始和結束時間的時間戳記。您也可以檢視執行狀態機器執行時所發生的「狀態」轉換總數。如果您已為狀態機器啟用追蹤或記錄,也可以檢視 X-Ray 追蹤對應和 Amazon CloudWatch 執行日誌的連結。

如果您的狀態機執行是由另一個狀態機器啟動的,您可以在此索引標籤上檢視父狀態機器的連結。

如果你的狀態機執行是 redriven,此標籤會顯示 redrive 相關資訊,例如 Redrive 計數

執行輸入和輸出

顯示狀態機執行輸入和輸出 side-by-side。

定義

顯示狀態機器的 Amazon 州語言定義。

錯誤訊息

如果狀態機器執行失敗,[執行詳細資訊] 頁面會顯示錯誤訊息。在錯誤訊息中選擇「原因」或「檢視步驟詳細資訊」,以檢視執行失敗的原因或造成錯誤的步驟。

如果您選擇檢視步驟詳細資訊,「Step Functions」會在「步驟詳細資訊」、「圖形檢視」及「表格檢視」標籤中反白顯示造成錯誤的步驟。如果步驟是您已為其定義試的 [工作]、[對映] 或 [平行] 狀態,[步驟] 詳細資料窗格會顯示該步驟的 [重試] 索引標籤。此外,如果你有 redriven 執行,你可以看到重試和 redrive 重試和中的執行詳細信息 redrives步驟詳細資料窗格的標籤。

從此錯誤消息上的「恢復」下拉按鈕中,您可以 redrive 您不成功的執行或開始新的執行。如需詳細資訊,請參閱Redriving 狀態機器

狀態機器執行失敗的錯誤訊息會顯示在 [執行詳細資訊] 頁面上。錯誤訊息也會有導致執行失敗之步驟的連結。

檢視模式

[檢視模式] 區段包含狀態機器的兩種不同視覺效果。您可以選擇檢視工作流程的圖形表示、概述工作流程中狀態的表格,或是與狀態機器執行相關聯的事件清單:

圖表檢視

圖形」檢視模式會顯示工作流程的圖形表示。底部包含一個圖例,指示狀態機的執行狀態。它也包含可讓您放大、縮小、置中對齊完整工作流程或以全螢幕模式檢視工作流程的按鈕。

從圖形檢視中,您可以選擇工作流程中的任何步驟,在「步驟詳細資料」元件中檢視其執行詳細資訊。當您在「圖形」檢視中選擇步驟時,「表格」檢視也會顯示該步驟。這也是相反的。如果您從「表格」檢視中選擇步驟,「圖表」檢視會顯示相同的步驟。

如果您的狀態機包含Map狀態、Parallel狀態或兩者,您可以在「圖形」檢視的工作流程中檢視它們的名稱。此外,對於Map狀態,「圖形」檢視可讓您在 Map 狀態執行資料的不同版序之間移動。例如,如果您的 Map 狀態有五個反覆項目,而您想要檢視第三次和第四個反覆項目的執行資料,請執行下列動作:

  1. 選擇您要檢視其版序資料的「對」狀態。

  2. 從「地圖版序檢視器」中,從下拉式清單中選擇 #2 以進行第三個版序。這是因為迭代從零開始計數。同樣地,從下拉式清單中選擇 #3 做為 Map 狀態的第四次迭代。

    或者,使用向上箭頭圖示和向下箭頭圖示控制項,在「對」狀態的不同版序之間移動。

    注意

    如果您的狀態機器包含嵌套Map狀態,則將顯示父和子Map狀態迭代的下拉列表以表示迭代數據。

  3. (可選)如果一個或多個 Map 狀態迭代無法執行,或者執行已停止,則可以通過在下拉列表中的「失敗」或「中」下選擇迭代號來查看其數據。

最後,您可以使用 [出] 和 [版面配置] 按鈕將工作流程圖形匯出為SVG或PNG影像。您也可以在工作流程的水平和垂直檢視之間切換。

表格檢視

表格」檢視模式會顯示工作流程中狀態的表格式表示。在此「檢視」模式下,您可以查看在工作流程中執行的每個狀態的詳細資訊,包括其名稱、所使用之任何資源的名稱 (例如 AWS Lambda 函數),如果狀態執行成功。

從此檢視中,您可以選擇工作流程中的任何狀態,以在「步驟詳細資料」元件中檢視其執行的詳細資訊。當您在「表格」檢視中選擇步驟時,「圖表」檢視也會顯示該步驟。這也是相反的。如果您從「圖形」檢視中選擇步驟,「表格」檢視會顯示相同的步驟。

您也可以透過對檢視套用篩選條件來限制在「表格」檢視模式中顯示的資料量。您可以為特定性質 (例如 「狀態」 或) 建立篩選 Redrive 嘗試。如需詳細資訊,請參閱檢查執行

依預設,此模式會顯示 [名稱]、[類型]、[狀態]、[資源] 和 [在下列時間後開始] 欄 您可以使用「好設定」對話方塊來設定要檢視的欄。您在此對話方塊上所做的選擇會保留以 future 的狀態機器執行,直到它們再次變更為止。

如果您新增「時間軸」欄,每個狀態的執行持續時間會顯示與整個執行階段相關的執行持續時間。這會顯示為顏色編碼的線性時間線。這可以幫助您識別與特定狀態執行的任何效能相關問題。時間表上每個狀態的顏色區段可協助您識別狀態的執行狀態,例如進行中、失敗或中止。

例如,如果您已定義狀態機器中某個狀態的執行重試,則這些重試會顯示在時間軸中。紅色區段代表失敗的Retry嘗試次數,而淺灰色區段代表每次Retry嘗試BackoffRate之間的次數。

時間軸上含有顏色區段的表格檢視螢幕擷取畫面。

如果您的狀態機包含Map狀態、狀Parallel態或兩者,您可以在 [表格] 檢視的工作流程中檢視它們的名稱。針對MapParallel狀態,「表格」檢視模式會將其迭代和 parallel 分支的執行資料顯示為樹狀檢視內的節點。您可以選擇處於這些狀態的每個節點,在「步驟詳細資訊」區段中檢視其個別詳細資訊。例如,您可以檢閱導致狀態失敗的特定 Map 狀態版序的資料。展開「對」狀態的節點,然後在「狀況」欄中檢視每個版序的狀況

步驟詳情

當您在「圖形」檢視或「格」檢視中選擇狀態時,「步驟詳細資訊」區段會在右側開啟。此段落包含下列索引標籤,提供有關所選狀態的深入資訊:

輸入

顯示所選狀態的輸入詳細資訊。如果輸入中有錯誤,則標籤標題上會以錯誤圖示表示。此外,您可以在此選項卡中查看錯誤的原因。

您也可以選擇 [進階檢視] 切換按鈕,以在資料通過所選狀態時查看輸入資料傳輸路徑。這可讓您識別如何將輸入作為一個或多個欄位 (例如InputPathParametersResultSelectorOutputPathResultPath、和) 套用至資料。

輸出

顯示所選狀態的輸出。如果輸出中有錯誤,則標籤標題上會以錯誤圖示表示。此外,您可以在此選項卡中查看錯誤的原因。

您也可以選擇 [進階檢視] 切換按鈕,以在資料通過所選狀態時查看輸出資料傳輸路徑。這可讓您識別如何將輸入作為一個或多個欄位 (例如InputPathParametersResultSelectorOutputPathResultPath、和) 套用至資料。

詳細資訊

顯示資訊,例如狀態類型、其執行狀態和執行持續時間。

對於使用資源的Task狀態,例如 AWS Lambda,此索引標籤提供資源呼叫的資源定義頁面和 Amazon CloudWatch 日誌頁面的連結。它也會顯示Task州/省TimeoutSecondsHeartbeatSeconds欄位的值 (如果指定)。

對於Map狀態,此標籤會顯示Map狀態迭代總計數的相關資訊。版序會分類為「失敗」、「已中止」、「成功」或InProgress

定義

顯示與所選狀態對應的 Amazon 州/省語言定義。

重試
注意

只有當您在狀態機器TaskParallel狀態中定義了Retry欄位時,才會顯示此索引標籤。

顯示所選狀態在其原始執行嘗試中的初始和後續重試嘗試。對於初始嘗試和所有後續的失敗嘗試,請選擇「類型」旁邊的箭頭圖示,以檢視出現在下拉式方塊中的失敗原因。如果重試嘗試成功,您可以檢視現在下拉式方塊中的輸出。

如果你有 redriven 您的執行,此選項卡標題顯示名稱重試 & redrives並顯示每個項目的重試嘗試詳細資料 redrive.

事件

顯示與執行中所選狀態相關聯之事件的篩選清單。您在此標籤上看到的資訊是您在「事件」(E ven ts) 表格中看到的完整執行事件歷程記錄的子集。

事件

事件」表格會將所選執行項目的完整歷史記錄顯示為橫跨多個頁面的事件清單。每個頁面最多包含 25 個事件。此區段也會顯示事件總計數,以協助您判斷是否超過 25,000 個事件的最大事件歷程記錄計數。

顯示工作流程執行部分事件歷程記錄的螢幕擷取畫面範例

依預設,「事件」(E vents) 表格中的結果會根據事件的時間戳記,以遞增順序顯示。您可以按一下「時間戳記」欄標題,將執行事件歷史記錄的排序變更為遞減順序。

在「件」(Events) 表格中,每個事件都有顏色編碼,以指出其執行狀態 例如,失敗的事件會以紅色顯示。若要檢視有關事件的其他詳細資訊,請選擇事件 ID 旁邊的箭頭圖示。一旦開啟,事件詳細資訊就會顯示事件的輸入、輸出和資源叫用。

此外,在「事件」(E vents) 表格中,您可以套用篩選器來限制顯示的執行事件歷程記錄結果。您可以選擇屬性,例如 ID,或 Redrive 嘗試。如需詳細資訊,請參閱檢查執行

標準和快速主控台體驗差異

標準工作流

標準工作流程的執行歷史記錄始終可用於過去 90 天內完成的執行。

快速工作流

對於 Express 工作流程,Step Functions 主控台會擷取透過記錄檔記錄群組收集的 CloudWatch 記錄資料,以顯示執行歷程記錄。依預設,可使用過去三小時內完成之執行項目的歷史記錄。您可以自定義時間範圍。如果您指定的時間範圍較大,其中包含更多執行事件,則掃描記錄檔的成本將會增加。如需詳細資訊,請參閱「定價」頁面上「記」索引標籤下的「CloudWatch 付費記錄」登入 CloudWatch 記錄

檢視 Express 工作流程執行的考量與限制

在「Step Functions」主控台上檢視 Express 工作流程執行時,請記住下列考量和限制:

快速工作流程執行細節的可用性取決於 Amazon CloudWatch 日誌

對於 Express 工作流程,其執行歷史記錄和詳細的執行資訊是透過 CloudWatch 日誌深入解析收集。此資訊會保留在您建立狀態機器時指定的 CloudWatch 記錄檔記錄群組中。狀態機器的執行歷程記錄會顯示在 Step Functions 主控台的 [行] 索引標籤下。

警告

如果您刪除 Express 工作流程的 CloudWatch 記錄檔,它不會列在 [執行] 索引標籤下。

建議您使用的ALL預設記錄層級來記錄所有執行事件類型。您可以在編輯現有狀態機器時,視需要更新記錄層級。如需詳細資訊,請參閱 使用 CloudWatch 日誌記錄 Step Functions 中的執行歷史記錄事件記錄層級

若記錄層級為ERROR或,則可使用部分 Express 工作流程執行詳細資訊 FATAL

依預設,Express 工作流程執行的記錄層級設定為ALL。如果您變更記錄層級,已完成執行的執行歷程記錄和執行詳細資料將不會受到影響。不過,所有新的執行都會根據更新的記錄層級發出記錄檔。如需詳細資訊,請參閱 使用 CloudWatch 日誌記錄 Step Functions 中的執行歷史記錄事件記錄層級

例如,如果您ALL將記錄層級從變更為ERRORFATAL,則 Step Functions 主控台上的 [執行] 索引標籤只會列出失敗的執行項目。在 [事件檢視] 索引標籤中,主控台只會顯示失敗的狀態機器步驟的事件詳細資料。

建議您使用的ALL預設記錄層級來記錄所有執行事件類型。編輯狀態機時,您可以視需要更新現有狀態機器的記錄層級。

狀態機修改後,無法查看先前執行的狀態機定義

Express 工作流程不會儲存過去執行的狀態機器定義。如果您變更狀態機定義,則只能使用最新的定義檢視執行的狀態機器定義。

例如,如果您從狀態機器定義中移除一或多個步驟,Step Functions 會偵測定義與先前執行事件之間的不相符項目。由於先前的定義不會儲存 Express 工作流程,因此 Step Functions 無法顯示在舊版狀態機器定義上執行的狀態機器定義。因此,在舊版狀態機器定義上執行的執行無法使用 [定義]、[圖形] 檢視和 [資料表檢視] 索引標籤。