Cloud Logging 中的 App Lifecycle Manager 平台記錄可讓您監控作業事件、對單元佈建失敗進行偵錯,以及排解推出問題。您可以在 Logs Explorer 中查詢這些記錄,並為 Google Cloud 專案中的 SaaS 作業和推出作業建立記錄式警告。
如要進一步瞭解支援的 App Lifecycle Manager 平台記錄,請參閱「Google Cloud 平台記錄」。如要進一步瞭解如何解讀平台記錄資料表中的資料,請參閱「記錄項目結構」。
事前準備
- 在 Google Cloud 控制台的專案選取器頁面,選取或建立 Google Cloud 專案。
- 確認 Google Cloud 專案已啟用計費功能。
- 啟用 App Lifecycle Manager API。
- 如要取得查看記錄和建立警告所需的權限,請要求管理員在專案中授予您下列 Identity and Access Management (IAM) 角色:
- 記錄檢視器 (
roles/logging.viewer) - Monitoring 編輯者 (
roles/monitoring.editor)
- 記錄檢視器 (
建立記錄式警告
如要建立記錄型警告,請在 Logs Explorer 中建構查詢,傳回要接收警告的記錄項目,然後設定警告政策。
前往 Google Cloud 控制台的「Logs Explorer」頁面。
在查詢編輯器中輸入查詢,篩選所選記錄項目。如需查詢範例,請參閱下列各節。
按一下「建立快訊」。
輸入警告政策的名稱和說明。
設定警告詳細資料,包括通知管道。
按一下「儲存快訊」。
如需詳細操作說明,請參閱「建立記錄指標警告」。
平台記錄查詢範例
本節提供常見警告情境的查詢範例,這些範例是以 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"}
後續步驟
- 如要進一步瞭解支援的 App Lifecycle Manager 平台記錄,請參閱「Google Cloud 平台記錄」。
- 如要瞭解平台記錄資料表中的資料,請參閱「記錄項目結構」。
- 進一步瞭解 App Lifecycle Manager 稽核記錄。