查看執行記錄

Application Integration 會在每次執行整合功能時，產生詳細的執行記錄。您可以透過執行記錄，排解整合作業執行失敗的問題、找出整合作業中每個步驟的執行狀態，以及監控主要和子整合作業的執行狀態。如要進一步瞭解 Application Integration 的記錄功能，請參閱「記錄簡介」。

注意：Application Integration 最多會保留整合作業的執行記錄 32 天。

查看整合執行記錄

您可以在 Google Cloud 控制台或使用 API 查看執行記錄。

注意：如果執行記錄大小超過 300 MB，Application Integration 會擲回 Response size too large 錯誤，且「Execution Logs」(執行記錄) 頁面不會載入記錄。在這種情況下，請按照「API」分頁中的說明，使用 projects.locations.integrations.executions.list 方法。

控制台

如要在 Google Cloud 控制台查看執行記錄，請按照下列步驟操作：

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

   前往 Application Integration

2. 在導覽選單中，按一下「Logs」(記錄)。

   「Execution Logs」(執行記錄) 頁面會隨即顯示，列出預設區域中整合作業產生的執行記錄。每則執行記錄訊息都會顯示下列屬性：

   • 整合項目名稱：整合項目的名稱。
   • 執行 ID：每次執行整合時產生的專屬 ID。
   • 狀態：整合執行作業的狀態。
     • 處理中：表示目前正在執行整合。
     • 成功：表示整合作業已成功執行。
     • 失敗：表示整合作業執行失敗。
     • 已取消：表示使用者已取消整合執行作業。
     • 暫停：表示整合作業執行作業暫時暫停，正在等待事件或動作完成。
     • Retry on hold：表示整合執行失敗，正在等待重試。
     • 已暫停：表示整合執行作業暫時停止，需要手動介入才能繼續。
   • 開始時間：整合作業開始執行的時間戳記。
   • 時間長度：執行整合作業所需的時間。
     注意： 請勿使用「Duration」(時間長度) 值計算整合的端對端執行延遲時間。 「Duration」(時間長度) 欄中顯示的時間不代表整合作業的總執行時間，因為這項指標並未計入整合作業在執行前後所花費的任何額外時間。舉例來說，配額強制執行或驗證所需的時間不會反映在「Duration」(時間長度) 值中。
   • 整合版本：執行的整合版本。
   • Trigger ID：觸發條件的 ID 值。
   • Cloud Logging：指出是否已設定整合功能，將記錄傳送至 Cloud Logging。如果已啟用 Cloud Logging，這個欄位會提供連結，方便您在 Cloud Logging 查看記錄。如果未啟用 Cloud Logging，這個欄位會設為「Disabled」(已停用)。
   • 重播來源：如果重播整合執行作業，這個欄位會提供重播執行作業的執行 ID。如要使用與先前執行作業相同的參數重新執行整合，可以重播已發布的整合執行作業。舉例來說，如果整合作業因逾時錯誤而失敗，或整合作業的輸出內容不符合預期，您可以重播執行作業。如要瞭解如何重播執行作業，請參閱「重播執行作業」。

3. 如要查看特定區域的執行記錄，請從「Region」(區域) 清單變更區域。
4. 您也可以點選「refresh 重新整理記錄」，重新載入目前的記錄清單。

   下圖顯示 Application Integration「Execution Logs」(執行記錄) 頁面範例。

   

API

如果執行記錄的大小超過 300 MB，Application Integration 會擲回 Response too large error 錯誤，且「Execution Logs」(執行記錄) 頁面不會載入記錄。在這種情況下，您必須使用 projects.locations.integrations.executions.list 方法取得記錄。如要使用 API 方法查看記錄，請按照下列步驟操作：

1. 如要取得要查看執行記錄的執行 ID，請使用 projects.locations.integrations.executions.list 方法建構 GET 要求，並將 snapshotMetadataWithoutParams 參數設為 TRUE：

   curl -v -X GET \
       -G \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions' \
       -d "snapshotMetadataWithoutParams=true"
   

   更改下列內容：

   • PROJECT_ID：Google Cloud 雲端專案 ID。
   • LOCATION：整合項目的區域。
   • INTEGRATION_NAME：整合項目的名稱。

   執行作業 ID 會在回應中傳回。複製要查看記錄的執行 ID。

2. 如要取得執行 ID 的執行記錄，請使用 projects.locations.integrations.executions.list 方法建構 GET 要求，並篩選您在上一個步驟中複製的執行 ID：

   curl -X GET \
       -G \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
       --data-urlencode 'filter=execution_id="EXECUTION_ID"'
   

   更改下列內容：

   • PROJECT_ID：Google Cloud 雲端專案 ID。
   • LOCATION：整合項目的區域。
   • EXECUTION_ID：從上一個步驟複製的執行 ID。

   在回應中，查看 ExecutionDetails 欄位即可查看記錄詳細資料。

   或者，您也可以在 Google Cloud 控制台中，依執行 ID 篩選執行記錄。

範例：篩選記錄

如要篩選回應，列出除了某項整合以外的所有整合記錄，請使用下列格式：

curl -X GET \
    -G \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
    --data-urlencode 'filter=workflow_name!="INTEGRATION_NAME"'

更改下列內容：

• PROJECT_ID：Google Cloud 雲端專案 ID。
• LOCATION：整合項目的區域。
• INTEGRATION_NAME：整合項目的名稱。

您可以篩選下列欄位：

• execution_id、workflow_name 和 trigger_id：請用雙引號括住這些字串值。
• state：接受 ExecutionDetails 狀態值，例如 FAILED 或 SUCCEEDED。請勿使用引號 (例如 state=FAILED)。
• create_timestamp 和 update_time：必須提供世界標準時間的 RFC 3339 時間戳記，並以 Z 結尾。請勿使用引號 (例如 create_timestamp>=2026-10-01T00:00:00Z)。

查看工作執行詳細資料

您可以查看整合或子整合中每項工作的執行詳細記錄。如要查看工作執行詳細資料，請前往「Execution Logs」(執行記錄) 頁面，然後展開要查看工作執行詳細資料的整合項目名稱。

「Execution Logs」(執行記錄) 頁面會顯示整合作業的執行記錄清單。每份執行記錄都對應到特定的整合執行作業。

• 如要查看特定工作的執行詳細資料，請按一下工作名稱。「Task Execution Details」(工作執行詳細資料) 窗格隨即顯示，當中會列出工作的執行詳細資料。
  重點提示：「Task Execution Details」(工作執行詳細資料) 窗格會顯示工作變數的完整值，不會截斷，方便您有效偵錯。
  
• 如要查看任務的要求和回應參數，請按一下「Request Parameters」(要求參數) 或「Response Parameters」(回應參數)。

  

• 如要查看子整合的執行記錄，請展開工作名稱，然後按一下子整合名稱。這適用於呼叫整合工作、For Each Parallel 工作、For Each Loop 工作和 While Loop 工作。

篩選記錄檔

您可以根據整合作業名稱、執行 ID、日期或時間範圍、執行狀態、變數類型，以及變數名稱或值等條件篩選記錄。如要為測試案例執行作業新增篩選器，請使用下列格式：

Integration name:INTEGRATION_NAME:TEST_CASE_NAME。

更改下列內容：

• INTEGRATION_NAME：：包含功能測試的整合名稱。
• TEST_CASE_NAME：要列出測試執行的測試案例名稱。

範例：Integration name:example-integration-name:example-test-case

使用記錄檔排解問題

以下章節說明如何排解下列用途的失敗問題：

• 排解整合失敗問題
• 查看堆疊追蹤例外狀況
• 追蹤連接器故障

排解整合失敗的問題

解決整合作業執行失敗的問題時，執行記錄訊息是相當實用的資源。

舉例來說，如果整合在特定時間範圍內無法執行，請按照下列步驟存取及篩選記錄，排解失敗問題：

1. 在「Integrations」(整合) 清單中，搜尋或選取要排解問題的整合項目，然後按一下以開啟整合編輯器。
2. 在整合服務編輯器的工具列中，按一下「Logs」(記錄)，即可查看記錄訊息。
3. 在「Execution log filter」(執行記錄篩選器) 欄位中，選取「Integration name」(整合名稱)，然後輸入要查看記錄的整合名稱。
4. 按下 Enter 鍵。
5. 如要顯示失敗的整合，請在「Execution log filter」(執行記錄篩選器) 欄位中選取「Execution status」(執行狀態)，顯示狀態清單，然後選取「Failed」(失敗)。
6. 如要顯示特定日期範圍內失敗的整合，請在「Execution log filter」(執行記錄篩選器) 欄位中選取「Start date after」(開始日期晚於)，然後以有效格式輸入所需時間。然後選取「結束日期早於」，並輸入所需時間。根據預設，系統會使用 AND 條件合併多個篩選器。

如果整合作業在篩選的時間範圍內失敗，「Execution Logs」(執行記錄) 頁面會顯示記錄訊息清單。每則記錄訊息都對應到特定失敗的整合執行作業。

如要瞭解如何使用 AI 排解執行失敗記錄的問題，請參閱「使用 AI 排解執行失敗記錄的問題」。

查看堆疊追蹤例外狀況

如要查看例外狀況清單，請按一下任何記錄訊息。按一下各例外狀況訊息中的連結，即可查看該例外狀況的完整堆疊追蹤。

注意： 執行記錄訊息事件參數 (字串或 JSON) 會遭到截斷，上限為 2000 個字元。

追蹤連接器故障

您可以根據執行記錄訊息，排解及追蹤失敗的連接器工作執行作業。失敗連接器工作的記錄資料會儲存在 Cloud Logging，並可在 Logs Explorer 中查看。

注意：只有在 Integration Connectors 中為相應連線啟用 Cloud Logging 時，Logs Explorer 才會提供失敗連接器工作的記錄資料。詳情請參閱「查看連接器記錄」。

如要從 Application Integration 存取失敗連接器工作的記錄資料，請按照下列步驟操作：

1. 前往所需整合項目的「Execution Logs」(執行記錄) 頁面。
2. 展開失敗執行的記錄訊息，並堆疊追蹤至包含失敗連接器工作的資料列。
3. 在「狀態」欄中，按一下「失敗」。

   

Application Integration 會自動為失敗的連接器工作執行必要查詢，並開啟「Logs Explorer」頁面，顯示詳細的執行記錄資料。

如要手動擷取失敗連接器工作的記錄資料，請在 Logs Explorer 的「查詢」頁面執行下列查詢。如要進一步瞭解如何使用記錄檔探索工具，請參閱「記錄檔探索工具介面」。

查詢格式

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="EXECUTION_ID_EXECUTION_TASK_ID_EXECUTION_ATTEMPT_NUMBER"

範例

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="9db51e4b-7d57-473d-931f-cc27b282dfad_1_2"

下載記錄檔

您可以下載特定整合執行作業的記錄，協助偵錯及分析。記錄檔包含執行程序的詳細資訊，包括時間戳記、事件和遇到的任何錯誤。

如要下載整合的執行記錄，請按照下列步驟操作：

1. 前往「Execution Logs」(執行記錄) 頁面。
2. 找出要下載記錄的整合執行作業，在對應的資料列中按一下 (「Actions」(動作) 選單)，然後選取「Download」(下載)。

執行記錄會以 JSON 檔案的形式，下載到瀏覽器的預設下載資料夾。

限制

• 如果停用整合項目的本機記錄功能，系統就不會為該整合項目產生執行記錄。

後續步驟

• 如要瞭解 Application Integration 中的記錄，請參閱「記錄簡介」。
• 瞭解測試案例。