查看 Application Integration 支援的連接器。

查看執行記錄

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

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

查看整合執行記錄

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

注意：如果執行記錄大小超過 300 MB，應用程式整合會擲回 Response size too large 錯誤，且記錄不會載入「執行記錄」頁面。在這種情況下，請使用 projects.locations.integrations.executions.list 方法，詳情請參閱「API」分頁。

控制台

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

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

   前往「Application Integration」

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

   系統會顯示「執行記錄」頁面，列出預設區域中整合作業產生的執行記錄。系統會為每則執行記錄訊息顯示下列屬性：

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

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

   下圖顯示應用程式整合的「執行記錄」頁面範例。

   

API

如果執行記錄的大小超過 300 MB，Application Integration 會擲回 Response too large error 錯誤，且記錄不會載入「執行記錄」頁面。在這種情況下，您必須使用 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' \
       -d 'filter=executionId=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' \
    -d 'filter=workflowName!=INTEGRATION_NAME'

更改下列內容：

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

查看工作執行詳細資料

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

「執行記錄」頁面會顯示整合作業的執行記錄清單。每份執行記錄都會對應到一個整合執行作業。

• 如要查看特定工作的執行詳細資料，請按一下工作名稱。系統會顯示「工作執行詳細資料」窗格，其中包含工作執行詳細資料。
  重點提示：「工作執行詳細資料」窗格會顯示工作變數的完整值 (不會截斷)，方便您有效進行偵錯。
  
• 如要查看工作的要求和回應參數，請按一下「要求參數」或「回應參數」。

  

• 如要查看子整合的執行記錄，請展開工作名稱，然後按一下子整合名稱。這適用於「通話整合工作」、「For Each 並行工作」、「For Each 迴圈工作」和「While 迴圈工作」。

篩選記錄檔

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

Integration name:INTEGRATION_NAME:TEST_CASE_NAME。

更改下列內容：

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

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

使用記錄檔排解問題

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

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

排解整合失敗的問題

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

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

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

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

查看堆疊追蹤例外狀況

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

注意： 執行記錄訊息事件參數 (字串或 JSON) 會截斷，最多 2000 個字元。

追蹤連接器失敗情形

您可以根據執行記錄訊息，排解及追蹤連結器工作執行失敗的問題。失敗的連接器工作記錄資料會儲存在 Cloud Logging 中，並顯示在記錄檔探索工具中。

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

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

1. 前往所需整合的「Execution Logs」(執行記錄) 頁面。
2. 展開執行失敗的記錄訊息和堆疊追蹤，直到包含失敗的 Connectors 工作的列為止。
3. 在「狀態」欄中，按一下「失敗」。

   

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

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

查詢格式

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. 前往「執行記錄」頁面。
2. 在要下載記錄的整合執行作業所對應的列中，按一下 (「動作」選單)，然後選取「下載」。

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

限制

• 如果整合作業停用本機記錄，系統就不會為該整合作業產生執行記錄。

後續步驟

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