查看執行步驟記錄

您可以擷取指定工作流程執行的記錄,做為步驟項目清單。每個步驟項目都會提供資訊,協助您分析、偵錯或最佳化工作流程。舉例來說,您可以確認實際執行的步驟,並判斷步驟的持續時間和成功與否。這在偵錯大型或複雜的非線性工作流程 (例如具有許多平行分支的工作流程) 時,特別有幫助。

步驟項目代表原始碼中的實際步驟 (例如 assigncall),或是指令區塊 (例如 for 迴圈或 try/retry/except 區塊)。如需步驟類型的完整清單,請參閱「StepType」。

執行記錄等級

建立執行工作流程時,您可以指定「基本」或「詳細」執行記錄。您可以在工作流程或執行層級套用這項設定。

根據預設,系統不會指定任何執行記錄層級,且會傳回「基本」步驟項目。

如要讓執行記錄包含任何適用範圍內的變數值,以及預期的疊代次數 (例如使用 for 迴圈,或平行分支或疊代時),您必須將執行記錄層級設為「詳細」

如果未指定執行作業的執行記錄層級,系統會根據套用至工作流程的層級判斷。如果層級不同,系統會套用執行層級的設定,覆寫該執行作業的工作流程層級設定。

如何擷取步數項目

您可以傳送要求至 Workflow Executions REST API,或透過 Google Cloud 控制台擷取步驟項目:

步驟進入資訊

步驟項目包含下列資訊:詳細的步數記錄也會包含基本步數記錄資訊。

詳情請參閱本文的「範例」一節。

基本步數記錄資訊

名稱 步驟項目的完整資源名稱,是具有下列格式的專屬 ID,其中 STEPENTRY_ID 是遞增計數器:
projects/PROJECT_NUMBER/locations/LOCATION/workflows/WORKFLOW_ID/executions/EXECUTION_ID/stepEntries/STEPENTRY_ID
例如:
projects/123456789012/locations/us-central1/workflows/myFirstWorkflow/executions/ae8a66a1-cefa-4d16-8a2f-d50c712d8ef1/stepEntries/2
建立及更新時間 步驟項目的建立時間和最近一次更新的時間戳記。如果步驟項目已完成,updateTime 會顯示完成時間。
日常安排和步驟名稱 步驟項目所屬的處理常式和步驟名稱。常式名稱是 YAML 或 JSON 原始碼中定義的子工作流程名稱。頂層常式名稱為 main
狀態和進度類型 步驟項目的狀態,例如項目是否成功或失敗,或是步驟項目是否正在進行中,以及進度類型。如需狀態和進度類型的完整清單,請參閱「State」和「ProgressType」。
導航資訊

步驟項目的位置,方便您瞭解工作流程的階層和流程,例如目前步驟項目之前或之後的步驟項目,或是步驟項目的父項或子項。

詳情請參閱「NavigationInfo」。
中繼資料

與疊代步驟項目相關的資料,可能包括:

  • 表示子執行緒的 ID,例如 STEP_PARALLEL_BRANCH 中的 STEP_PARALLEL_BRANCH_ENTRY
  • for 迴圈的疊代,例如 STEP_FOR_ITERATION 中的 STEP_FOR_ITERATION STEP_FOR
詳情請參閱 StepEntryMetadata
例外狀況 與任何例外狀況相關的酬載,並提供步驟項目失敗原因的說明。

詳細的步數記錄資訊

中繼資料

如果適用,步驟進度中預期的疊代次數,例如使用 for 迴圈、平行分支或疊代時。

請注意,如果迴圈界限包含納入下列任一項的運算式,計算出的計數將無法正常運作:

  • 巢狀運算式深度超過 10
  • len() 以外的內建函式
  • 評估內容涉及 .inf-.inf.NANInfinity-Infinity 等值
  • 錯誤
詳情請參閱 StepEntryMetadata
變數資料

與這個步驟相關的範圍內變數值資料,包括使用者定義的本機變數名稱和值,以及運算式評估結果。

請注意,範圍不包括與 Workflows 內建函式連結的內部變數。

詳情請參閱「VariableData」。

在控制台中查看步驟項目

您可以在Google Cloud 控制台中,查看特定工作流程執行的步驟項目。

  1. 前往 Google Cloud 控制台的「Workflows」頁面。

    前往「Workflows」頁面

  2. 按一下工作流程名稱,前往「Workflow details」(工作流程詳細資料) 頁面。

  3. 如要查看特定執行作業的詳細資料,請按一下執行作業 ID。

    「摘要」分頁會提供整體執行作業的相關資訊,包括導致執行作業失敗的任何例外狀況。詳情請參閱「執行錯誤對應」。

  4. 如要以步驟項目的清單形式查看工作流程執行記錄,請按一下「步驟」分頁標籤。

    系統會列出工作流程執行的所有步驟項目。

  5. 如要篩選步驟項目,請使用表格頂端的「Filter」(篩選條件) 欄位選取屬性和值,例如 State: Failed

  6. 如要顯示任何「上層」、「子項」、「下一步」和「上一步」步驟項目的連結,請點選特定步驟項目。

    點選連結後,其他連結會自動更新。舉例來說, 父項會連結至您點選的步驟項目的父項。

  7. 「可視化」面板會以圖形呈現工作流程中的步驟,協助您瞭解工作流程路徑。

    視覺化面板範例

    點選圖表即可放大: