您可以擷取指定工作流程執行的記錄,做為步驟項目清單。每個步驟項目都會提供資訊,協助您分析、偵錯或最佳化工作流程。舉例來說,您可以確認實際執行的步驟,並判斷步驟的持續時間和成功與否。這在偵錯大型或複雜的非線性工作流程 (例如具有許多平行分支的工作流程) 時,特別有幫助。
步驟項目代表原始碼中的實際步驟 (例如 assign 或 call),或是指令區塊 (例如 for 迴圈或 try/retry/except 區塊)。如需步驟類型的完整清單,請參閱「StepType」。
執行記錄等級
建立或執行工作流程時,您可以指定「基本」或「詳細」執行記錄。您可以在工作流程或執行層級套用這項設定。
根據預設,系統不會指定任何執行記錄層級,且會傳回「基本」步驟項目。
如要讓執行記錄包含任何適用範圍內的變數值,以及預期的疊代次數 (例如使用 for 迴圈,或平行分支或疊代時),您必須將執行記錄層級設為「詳細」。
如果未指定執行作業的執行記錄層級,系統會根據套用至工作流程的層級判斷。如果層級不同,系統會套用執行層級的設定,覆寫該執行作業的工作流程層級設定。
如何擷取步數項目
您可以傳送要求至 Workflow Executions REST API,或透過 Google Cloud 控制台擷取步驟項目:
Google Cloud 控制台:請參閱本文的「在控制台中查看步驟項目」一節。
除了列出步驟項目及其詳細資料,控制台還會以圖形呈現執行步驟,方便您查看及分析工作流程執行路徑。
步驟進入資訊
步驟項目包含下列資訊:詳細的步數記錄也會包含基本步數記錄資訊。
詳情請參閱本文的「範例」一節。
基本步數記錄資訊
| 名稱 | 步驟項目的完整資源名稱,是具有下列格式的專屬 ID,其中 STEPENTRY_ID 是遞增計數器: |
| 建立及更新時間 | 步驟項目的建立時間和最近一次更新的時間戳記。如果步驟項目已完成,updateTime 會顯示完成時間。 |
| 日常安排和步驟名稱 | 步驟項目所屬的處理常式和步驟名稱。常式名稱是 YAML 或 JSON 原始碼中定義的子工作流程名稱。頂層常式名稱為 main。
|
| 狀態和進度類型 | 步驟項目的狀態,例如項目是否成功或失敗,或是步驟項目是否正在進行中,以及進度類型。如需狀態和進度類型的完整清單,請參閱「State」和「ProgressType」。 |
| 導航資訊 | 步驟項目的位置,方便您瞭解工作流程的階層和流程,例如目前步驟項目之前或之後的步驟項目,或是步驟項目的父項或子項。 詳情請參閱「NavigationInfo」。 |
| 中繼資料 | 與疊代步驟項目相關的資料,可能包括:
|
| 例外狀況 | 與任何例外狀況相關的酬載,並提供步驟項目失敗原因的說明。 |
詳細的步數記錄資訊
| 中繼資料 | 如果適用,步驟進度中預期的疊代次數,例如使用 請注意,如果迴圈界限包含納入下列任一項的運算式,計算出的計數將無法正常運作:
|
| 變數資料 | 與這個步驟相關的範圍內變數值資料,包括使用者定義的本機變數名稱和值,以及運算式評估結果。 請注意,範圍不包括與 Workflows 內建函式連結的內部變數。 詳情請參閱「VariableData」。 |
在控制台中查看步驟項目
您可以在Google Cloud 控制台中,查看特定工作流程執行的步驟項目。
前往 Google Cloud 控制台的「Workflows」頁面。
按一下工作流程名稱,前往「Workflow details」(工作流程詳細資料) 頁面。
如要查看特定執行作業的詳細資料,請按一下執行作業 ID。
「摘要」分頁會提供整體執行作業的相關資訊,包括導致執行作業失敗的任何例外狀況。詳情請參閱「執行錯誤對應」。
如要以步驟項目的清單形式查看工作流程執行記錄,請按一下「步驟」分頁標籤。
系統會列出工作流程執行的所有步驟項目。
如要篩選步驟項目,請使用表格頂端的「Filter」(篩選條件) 欄位選取屬性和值,例如
State: Failed。如要顯示任何「上層」、「子項」、「下一步」和「上一步」步驟項目的連結,請點選特定步驟項目。
點選連結後,其他連結會自動更新。舉例來說, 父項會連結至您點選的步驟項目的父項。
「可視化」面板會以圖形呈現工作流程中的步驟,協助您瞭解工作流程路徑。
視覺化面板範例
點選圖表即可放大: