查看 Application Integration 支援的連接器。
查看執行記錄
Application Integration 會在每次執行整合功能時產生詳細的執行記錄。您可以使用執行記錄檔來排解整合作業執行失敗的問題、找出整合作業中各個步驟的執行狀態,以及監控主要和子整合作業的執行狀態。如要進一步瞭解應用程式整合中的記錄功能,請參閱「記錄簡介」。
查看整合作業執行記錄
您可以在 Google Cloud 控制台或使用 API 中查看執行記錄。
控制台
如要在 Google Cloud 主控台中查看執行記錄,請執行下列步驟:
- 前往 Google Cloud 控制台的「Application Integration」(應用程式整合) 頁面。
- 在導覽選單中,按一下「記錄」。
系統會顯示「執行記錄」頁面,列出系統在預設區域中為整合作業產生的執行記錄。系統會針對每個執行記錄訊息顯示下列屬性:
- 整合名稱:整合名稱。
- 執行 ID:每次執行整合功能時產生的專屬 ID。
- 狀態:整合執行作業的狀態。
- 進行中:表示目前正在執行整合作業。
- Succeeded (成功):表示整合已成功執行。
- Failed:表示整合項目無法執行。
- 已取消:表示使用者已取消整合執行作業。
- 暫緩:表示整合作業暫時處於暫停狀態,正在等待事件或動作完成。
- Retry on hold:表示整合執行作業失敗,正在等待重試。
- 已暫停:表示整合執行作業已暫停,需要手動介入才能恢復整合。
- 開始時間:整合作業開始執行的時間戳記。
- Duration:執行整合作業所需的時間。
- 整合版本:執行的整合版本。
- 觸發條件 ID:觸發條件的 ID 值。
- Cloud Logging:指出是否已將整合設定設為記錄至 Cloud Logging。如果啟用 Cloud Logging,這個欄位會提供連結,讓您在 Cloud Logging 中查看記錄。如果未啟用 Cloud Logging,這個欄位會設為「停用」。
- Replayed from:如果重播整合執行作業,這個欄位會提供重播執行作業的執行 ID。如要使用與先前執行作業相同的參數重新執行整合,您可以重播已發布的整合執行作業。舉例來說,如果整合作業因逾時錯誤而失敗,或是整合作業的輸出結果不如預期,您可以重播執行作業。如要瞭解如何重播執行作業,請參閱「重播執行作業」。
- 如要查看特定地區的執行記錄,請在「Region」清單中變更地區。
- 您也可以選擇按一下「重新整理記錄」
,重新載入目前的記錄清單。
下圖顯示「Application Integration」Execution Logs 頁面的範例。
API
如果執行記錄的大小超過 300 MB,應用程式整合會擲回 Response too large error
錯誤,且記錄不會載入至「執行記錄」頁面。在這種情況下,您必須使用 projects.locations.integrations.executions.list
方法才能取得記錄。如要使用 API 方法查看記錄,請按照下列步驟操作:
- 如要取得要查看執行記錄的執行 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。
- 如要取得執行 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 篩選執行記錄。
範例:篩選記錄
如果您想篩選回應,只列出某項整合項目以外的所有整合項目記錄,請使用下列格式:
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
。
使用記錄檔排解問題
以下說明如何針對下列用途排除失敗問題:
排解整合失敗的問題
解決整合作業執行失敗的問題時,執行記錄訊息是相當實用的資源。
舉例來說,如果整合作業無法在特定時間範圍內執行,請按照下列步驟存取及篩選記錄檔,以便排除失敗問題:
- 搜尋或選取要疑難排解的整合項目,然後點選該項目,開啟整合服務編輯器。
- 在整合服務編輯器的工具列中,按一下「Logs」,即可查看記錄訊息。
- 在「執行記錄篩選器」欄位中,選取「整合名稱」,然後輸入要查看記錄的整合項目名稱。
- 按一下 Enter 鍵。
- 如要顯示失敗的整合,請在「執行記錄篩選器」欄位中選取「執行狀態」,以便顯示狀態清單,然後選取「失敗」。
- 如要顯示特定時間範圍內的失敗整合,請在「執行記錄篩選條件」欄位中選取「開始日期後」,然後以有效格式輸入所需時間。接著選取「結束日期前」,然後輸入所需時間。根據預設,系統會使用 AND 條件合併多個篩選器。
如果在篩選的時間範圍內整合失敗,執行記錄頁面會顯示記錄訊息清單。每則記錄訊息都對應到特定的整合執行失敗。
查看堆疊追蹤例外狀況
如要查看例外狀況清單,請按一下任一記錄訊息。按一下每則例外狀況訊息中的連結,即可查看該例外狀況的完整堆疊追蹤內容。
追蹤連接器失敗
您可以使用執行記錄訊息排解問題,並追蹤失敗的連接器任務執行作業。失敗的連接器工作記錄資料會使用 Cloud Logging 儲存,您可以在記錄檔探索工具中查看。
如要透過應用程式整合功能存取連接器工作失敗的記錄資料,請執行下列步驟:
- 前往所需整合項目的「執行記錄」頁面。
- 展開執行失敗的記錄訊息,並堆疊追蹤至包含失敗 Connectors 工作的資料列。
- 在「狀態」欄中,按一下「失敗」。
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"
下載記錄檔
您可以下載特定整合執行作業的記錄,以利偵錯和分析。記錄中包含執行程序的詳細資訊,包括時間戳記、事件和遇到的任何錯誤。
如要下載整合作業的執行記錄,請執行下列步驟:
- 前往「執行記錄」頁面。
- 在要下載記錄的整合作業執行作業對應的資料列中,按一下 (「動作」選單),然後選取「下載」。
執行記錄會以 JSON 檔案格式下載至瀏覽器的預設下載資料夾。
限制
- 如果為整合功能停用本機記錄,系統就不會為該整合作業產生執行記錄。