查看 Application Integration 支援的連接器

查看執行記錄

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

查看整合作業執行記錄

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

控制台

如要在 Google Cloud 主控台中查看執行記錄,請執行下列步驟:

  1. 前往 Google Cloud 控制台的「Application Integration」(應用程式整合) 頁面。

    前往「應用程式整合」

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

    系統會顯示「執行記錄」頁面,列出系統在預設區域中為整合作業產生的執行記錄。系統會針對每個執行記錄訊息顯示下列屬性:

    • 整合名稱:整合名稱。
    • 執行 ID:每次執行整合功能時產生的專屬 ID。
    • 狀態:整合執行作業的狀態。
      • 進行中:表示目前正在執行整合作業。
      • Succeeded (成功):表示整合已成功執行。
      • Failed:表示整合項目無法執行。
      • 已取消:表示使用者已取消整合執行作業。
      • 暫緩:表示整合作業暫時處於暫停狀態,正在等待事件或動作完成。
      • Retry on hold:表示整合執行作業失敗,正在等待重試。
      • 已暫停:表示整合執行作業已暫停,需要手動介入才能恢復整合。
    • 開始時間:整合作業開始執行的時間戳記。
    • Duration:執行整合作業所需的時間。
    • 整合版本:執行的整合版本。
    • 觸發條件 ID:觸發條件的 ID 值。
    • Cloud Logging:指出是否已將整合設定設為記錄至 Cloud Logging。如果啟用 Cloud Logging,這個欄位會提供連結,讓您在 Cloud Logging 中查看記錄。如果未啟用 Cloud Logging,這個欄位會設為「停用」
    • Replayed from:如果重播整合執行作業,這個欄位會提供重播執行作業的執行 ID。如要使用與先前執行作業相同的參數重新執行整合,您可以重播已發布的整合執行作業。舉例來說,如果整合作業因逾時錯誤而失敗,或是整合作業的輸出結果不如預期,您可以重播執行作業。如要瞭解如何重播執行作業,請參閱「重播執行作業」。

  3. 如要查看特定地區的執行記錄,請在「Region」清單中變更地區。
  4. 您也可以選擇按一下「重新整理記錄」 ,重新載入目前的記錄清單。

    下圖顯示「Application Integration」Execution Logs 頁面的範例。

    圖片:顯示「Application Integration Execution Logs」(Application Integration 執行記錄檔) 頁面 圖片:顯示「Application Integration Execution Logs」(Application Integration 執行記錄檔) 頁面

API

如果執行記錄的大小超過 300 MB,應用程式整合會擲回 Response too large error 錯誤,且記錄不會載入至「執行記錄」頁面。在這種情況下,您必須使用 projects.locations.integrations.executions.list 方法才能取得記錄。如要使用 API 方法查看記錄,請按照下列步驟操作:

  1. 如要取得要查看執行記錄的執行 ID,請使用 projects.locations.integrations.executions.list 方法建構 GET 要求,並將 snapshotMetadataWithoutParams 參數設為 TRUE
    curl -v -X -G GET
        -H "Content-Type: application/json"
        -H "Authorization: Bearer $(gcloud auth print-access-token)"
        -d 'snapshotMetadataWithoutParams=true'
        'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
    

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

  2. 如要取得執行 ID 的執行記錄,請使用 projects.locations.integrations.executions.list 方法建構 POST 要求,並在執行 ID 上套用上一個步驟中複製的篩選器:
    curl -v -X -G GET 
        -H "Content-Type: application/json"
        -H "Authorization: Bearer $(gcloud auth print-access-token)"
        -d 'filter=execution_id="EXECUTION_ID"'
        'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
    

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

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

  3. 範例:篩選記錄

    如果您想篩選回應,只列出某項整合項目以外的所有整合項目記錄,請使用下列格式:

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

查看工作執行詳細資料

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

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

  • 如要查看特定工作執行的詳細資料,請按一下工作名稱。「Task Execution Details」窗格隨即會顯示工作執行詳細資料。 工作執行詳細資料 工作執行詳細資料
  • 如要查看工作的要求和回應參數,請按一下「要求參數」或「回應參數」

    執行記錄要求參數 執行記錄要求參數

  • 如要查看子整合作業的執行記錄,請展開工作名稱,然後按一下子整合作業名稱。這項規定適用於通話整合工作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. 搜尋或選取要疑難排解的整合項目,然後點選該項目,開啟整合服務編輯器。
  2. 在整合服務編輯器的工具列中,按一下「Logs」,即可查看記錄訊息。
  3. 在「執行記錄篩選器」欄位中,選取「整合名稱」,然後輸入要查看記錄的整合項目名稱。
  4. 按一下 Enter 鍵。
  5. 如要顯示失敗的整合,請在「執行記錄篩選器」欄位中選取「執行狀態」,以便顯示狀態清單,然後選取「失敗」
  6. 如要顯示特定時間範圍內的失敗整合,請在「執行記錄篩選條件」欄位中選取「開始日期後」,然後以有效格式輸入所需時間。接著選取「結束日期前」,然後輸入所需時間。根據預設,系統會使用 AND 條件合併多個篩選器。

如果在篩選的時間範圍內整合失敗,執行記錄頁面會顯示記錄訊息清單。每則記錄訊息都對應到特定的整合執行失敗。

查看堆疊追蹤例外狀況

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

圖片:顯示展開的記錄例外狀況錯誤 圖片:顯示展開的記錄例外狀況錯誤

追蹤連接器失敗

您可以使用執行記錄訊息排解問題,並追蹤失敗的連接器任務執行作業。失敗的連接器工作記錄資料會使用 Cloud Logging 儲存,您可以在記錄檔探索工具中查看。

如要透過應用程式整合功能存取連接器工作失敗的記錄資料,請執行下列步驟:

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

    顯示連接器工作失敗記錄的圖片 顯示連接器工作失敗記錄的圖片

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

如要手動擷取失敗的連接器工作記錄資料,您可以在記錄檔探索工具的「查詢」頁面中執行下列查詢。如要進一步瞭解如何使用 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. 前往「執行記錄」頁面。
  2. 在要下載記錄的整合作業執行作業對應的資料列中,按一下 (「動作」選單),然後選取「下載」
  3. 執行記錄會以 JSON 檔案格式下載至瀏覽器的預設下載資料夾。

限制

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

後續步驟