使用平台記錄檔

Cloud Logging 中的 App Lifecycle Manager 平台記錄可讓您監控作業事件、對單元佈建失敗進行偵錯,以及排解推出問題。您可以在 Logs Explorer 中查詢這些記錄,並為 Google Cloud 專案中的 SaaS 作業和推出作業建立記錄式警告。

如要進一步瞭解支援的 App Lifecycle Manager 平台記錄,請參閱「Google Cloud 平台記錄」。如要進一步瞭解如何解讀平台記錄資料表中的資料,請參閱「記錄項目結構」。

事前準備

  1. 在 Google Cloud 控制台的專案選取器頁面,選取或建立 Google Cloud 專案。
  2. 確認 Google Cloud 專案已啟用計費功能。
  3. 啟用 App Lifecycle Manager API。
  4. 如要取得查看記錄和建立警告所需的權限,請要求管理員在專案中授予您下列 Identity and Access Management (IAM) 角色:
    • 記錄檢視器 (roles/logging.viewer)
    • Monitoring 編輯者 (roles/monitoring.editor)

建立記錄式警告

如要建立記錄型警告,請在 Logs Explorer 中建構查詢,傳回要接收警告的記錄項目,然後設定警告政策。

  1. 前往 Google Cloud 控制台的「Logs Explorer」頁面。

    前往 Logs Explorer

  2. 在查詢編輯器中輸入查詢,篩選所選記錄項目。如需查詢範例,請參閱下列各節。

  3. 按一下「建立快訊」。

  4. 輸入警告政策的名稱和說明。

  5. 設定警告詳細資料,包括通知管道。

  6. 按一下「儲存快訊」。

如需詳細操作說明,請參閱「建立記錄指標警告」。

平台記錄查詢範例

本節提供常見警告情境的查詢範例,這些範例是以 App Lifecycle Manager 平台記錄為基礎。

SaaS 作業警示

如要在單位佈建作業失敗時建立警告,請使用下列查詢:

log_id("saasservicemgmt.googleapis.com/deployment_events") AND
resource.type="saasservicemgmt.googleapis.com/Unit" AND
jsonPayload.unitOperationState="UNIT_OPERATION_STATE_FAILED" AND
jsonPayload.unitOperationType="provision"

如要在裝置佈建作業達到終端狀態 (成功、失敗或取消) 時建立快訊,請使用下列查詢:

log_id("saasservicemgmt.googleapis.com/deployment_events") AND
resource.type="saasservicemgmt.googleapis.com/Unit" AND
(jsonPayload.unitOperationState="UNIT_OPERATION_STATE_SUCCEEDED"
  OR jsonPayload.unitOperationState="UNIT_OPERATION_STATE_FAILED"
  OR jsonPayload.unitOperationState="UNIT_OPERATION_STATE_CANCELLED") AND
jsonPayload.unitOperationType="provision"

推出快訊

如要在推出作業進入 PAUSED 狀態 (因為 App Lifecycle Manager 判定推出作業不健康) 或 FAILED 狀態時建立記錄檔警告,請使用下列查詢:

resource.type = "saasservicemgmt.googleapis.com/Rollout"
(jsonPayload.currentState = "PAUSED" AND jsonPayload.reason = "SYSTEM_PAUSE")
  OR
jsonPayload.currentState = "FAILED"

如要在推出作業進入 PAUSED 狀態 (因為 App Lifecycle Manager 判定推出作業不健康) 或 FAILED 狀態時,為推出狀態指標建立指標警告,請使用下列查詢:

saasservicemgmt_googleapis_com:rollout_state
{state_name="PAUSED", reason="SYSTEM_PAUSE"}
OR
saasservicemgmt_googleapis_com:rollout_state{state_name="FAILED"}

後續步驟