在 Cloud Logging 查看記錄

在 Cloud Logging 中，您可以查看整合作業執行記錄，其中包含整合作業詳細資料，例如狀態、效能、整合作業版本、要求和回應參數，以及觸發條件和工作設定。如要進一步瞭解 Cloud Logging 中的執行記錄，請參閱「Cloud Logging 中的整合執行記錄」。如要瞭解限制和價格，請參閱「限制」和「價格」一節。

根據預設，系統會停用整合的 Cloud Logging。如要啟用整合作業的記錄功能，請編輯整合作業的未發布版本。

事前準備

如要將整合執行記錄儲存在 Cloud Logging 中，請先為整合啟用 Cloud Logging。請按照以下步驟操作：

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

    前往 Application Integration

  2. 在導覽選單中，按一下「整合」。

    系統隨即會顯示「整合」頁面，列出 Google Cloud 專案中所有可用的整合功能。

  3. 選取要啟用 Cloud Logging 的現有整合服務，或建立新的整合服務。

    系統會在整合編輯器中開啟整合服務。

  4. 選取整合的 DRAFT 版本。如果已發布或未發布的版本不是處於草稿模式，就無法修改設定。如需整合版本清單，請參閱「版本」一文。
  5. 按一下設計工具工具列中的 (整合摘要)。系統隨即會顯示整合摘要頁面。
    1. 在「記錄設定」中，按一下「啟用 Cloud Logging」切換鈕，然後從「嚴重性」清單中，選取要儲存在 Cloud Logging 中的記錄嚴重性類型：
      • 資訊：選取這個選項可擷取所有執行狀態：SUCCEEDED、FAILED、PROCESSING、PENDING、SUSPENDED、RETRY_ON_HOLD 和 CANCELLED。
      • 錯誤：選取這個選項可擷取下列執行狀態：FAILED 和 CANCELLED。
      • 警告：選取這個選項可擷取下列執行狀態：FAILED 和 CANCELLED。

        • 如需整合執行狀態清單，請參閱「執行狀態」。

    2. 按一下 [儲存]。

查看記錄

如要在 Cloud Logging 中查看記錄，請先啟用 Cloud Logging，然後按照下列步驟操作：

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

    前往 Application Integration

  2. 如要在 Cloud Logging 中查看整合執行記錄，請使用下列任一方法：
    • 在導覽選單中，依序點選「記錄」和「查看 Cloud 記錄」。
    • 在導覽選單中，按一下「記錄」，然後在「Cloud Logging」欄位中，按一下「查看」。如果啟用 Cloud Logging，這個欄位會提供連結，方便您在 Cloud Logging 中查看記錄。如果未啟用 Cloud Logging，這個欄位會設為「已停用」。
    • 在整合服務編輯器中測試整合服務後，請在「測試整合服務」窗格中，按一下「查看 Cloud Logs」。

    「Logs Explorer」頁面隨即顯示。系統會顯示下列預設查詢的記錄，時間範圍為過去三小時： 

    resource.type=integrations.googleapis.com/IntegrationVersion

    3. 如要瞭解應用程式整合記錄的記錄格式，請參閱 log_entries 酬載。

查詢範例

您可以使用下列查詢，在 Cloud Logging 中查看記錄：

  • 如要查看所有整合作業執行記錄，請按照下列步驟操作：

        resource.type="integrations.googleapis.com/IntegrationVersion"

  • 您可以查看特定執行作業 ID 的整合執行記錄：

    • 只搜尋具有指定執行 ID 的父項執行作業： 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • 搜尋從指定執行 ID 啟動的父項和子項執行作業： 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    "EXECUTION_ID"

  • 如要查看特定整合項目的執行記錄，請按照下列步驟操作：

        resource.type="integrations.googleapis.com/IntegrationVersion" 
    "INTEGRATION_NAME"
     或 
        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integration="INTEGRATION_NAME"

  • 如要查看特定整合項目的整合執行失敗記錄，請按照下列步驟操作：

        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integrationExecutionDetails.integrationExecutionState="FAILED"
    jsonPayload.integration="INTEGRATION_NAME"

  • 如要查看含有特定要求參數名稱的記錄，舉例來說，下列查詢會要求 requestUrl 參數的記錄：

        resource.type="integrations.googleapis.com/IntegrationVersion"
    "requestUrl"

    • 如需更多查詢範例，請參閱 Cloud Logging 查詢範例。

限制

Cloud Logging 中的整合記錄有下列限制：

  • Cloud Logging 僅支援大小最多 256 KiB 的記錄項目。如果記錄超出這個上限，記錄詳細資料就不會顯示要求和回應參數。如要瞭解 Cloud Logging 的配額和限制，請參閱「配額與限制」。如要解決這個錯誤，請更新整合變數，確保值不超過上限。或者，您也可以在 Application Integration 中查看這些記錄。
  • 如果停用本機記錄，即使啟用 Cloud Logging，執行記錄也不會傳送至 Cloud Logging。

定價

如要瞭解 Cloud Logging 的定價，請參閱 Cloud Logging 定價。

後續步驟