本頁說明如何透過 Google Cloud 控制台的「記錄檔總管」頁面,為封存資源設定記錄檔通知。
「Logs Explorer」頁面會引導您完成下列步驟,建立及編輯記錄式快訊:
- 提供警告的名稱和說明。
- 選擇要接收通知的記錄檔。
- 設定通知間隔時間。
- 設定事件自動關閉的時間。
- 指定通知對象。
您可以為備份和還原作業類別設定快訊:SCHEDULED_BACKUP、ON_DEMAND_BACKUP 和 RESTORE。
您也可以為備份方案和備份方案關聯作業類別設定快訊:UPDATE。
可用的工作狀態包括:SUCCESSFUL、FAILED、SKIPPED 和 RUNNING。
您可以設定一或多個通知管道,例如 Google Chat、電子郵件、簡訊或即時通訊程式管道,以便在發生快訊時收到通知。如需操作說明,請參閱「建立及管理通知管道」。
事前準備
建立記錄式警告
如要通知警示,您必須有通知管道。 您可以在建立快訊前或建立快訊時建立通知管道。
請按照下列操作說明建立記錄式快訊。
前往 Google Cloud 控制台的「Logs Explorer」頁面。
在「查詢」窗格中,定義要接收通知的快訊。
以下查詢範例說明如何使用備份和災難復原服務,在排程備份工作失敗時收到通知:
logName="projects/PROJECT_ID/logs/backupdr.googleapis.com/LOG_NAME" jsonPayload.jobCategory="SCHEDULED_BACKUP" jsonPayload.jobStatus="FAILED"更改下列內容:
PROJECT_ID:專案名稱。LOG_NAME:記錄名稱,可以是下列任一項:bdr_backup_plan_jobs:與備份計畫相關的工作bdr_backup_plan_association_jobs:管理員專案中與備份計畫關聯相關的工作 (適用於跨專案保護)。bdr_backup_plan_association_source_jobs:與工作負載專案中備份計畫關聯相關的工作。
以下查詢範例說明如何使用 GKE 備份功能,在排定的備份工作失敗時收到通知:
logName="projects/PROJECT_ID/logs/gkebackup.googleapis.com/bfg_backup_restore_jobs" jsonPayload.jobCategory="SCHEDULED_BACKUP" jsonPayload.jobStatus="FAILED"
更改下列內容:
PROJECT_ID:專案名稱。
在「Query results」(查詢結果) 窗格的標頭中,按一下「Create alert」(建立快訊)。
在「警報詳細資料」部分,執行下列操作:
- 在「Alert Policy Name」(快訊政策名稱) 欄位中,輸入快訊的名稱。這個名稱會顯示在通知標題中。
- 在「Documentation」(說明文件) 欄位中,輸入快訊的說明。如要瞭解如何設定這個欄位的內容格式及調整內容,請參閱「在文件範本中使用 Markdown 和變數」。
點選「下一步」。
在「Choose logs to include in the alert」(選擇要加入快訊的記錄檔) 區段中,執行下列操作:
- 按一下「預覽記錄」即可查看查詢和結果。如有需要,您也可以在這個窗格中編輯查詢。
按一下「新增標籤」,然後執行下列操作。標籤可讓你自訂通知,並提供更多資訊。
- 在「顯示名稱」欄位中,輸入標籤名稱。
- 從「記錄檔欄位名稱」清單中選取記錄檔欄位名稱。這些欄位會根據所選查詢結果顯示。
- 在「規則運算式」欄位中,輸入要從欄位擷取值的運算式,該欄位只能包含一個規則運算式群組。
點選「下一步」。
在「Set notification frequency and autoclose duration」(設定通知頻率和自動關閉期限) 區段中,執行下列操作:
- 從「通知傳送間隔時間」清單中,選取通知時間間隔下限。這個值可讓您控制如果觸發多次,會收到這項快訊的通知幾次。
- 從「事件自動關閉期限」清單中,選取期限,缺少相符記錄項目時,事件經過這段時間後便會自動關閉。
點選「下一步」。
從「Notification channels」(通知管道) 清單中,為快訊選取一或多個通知管道。如果沒有設定通知管道,請按一下「管理通知管道」建立通知管道。如需操作說明,請參閱「建立及管理通知管道」。
按一下 [儲存]。
測試以記錄為基礎的警告
如要測試您建立的記錄檔快訊,可以手動撰寫符合查詢條件的記錄項目。
請按照下列操作說明撰寫記錄項目。
前往
logEntries.write參考頁面。將
PROJECT_ID變數改為您的專案 ID,設定下列記錄項目。如為 Backup and DR Service,請執行下列指令:
{ "entries": [ { "jsonPayload": { "jobCategory": "SCHEDULED_BACKUP", "jobStatus": "FAILED" } } ], "resource": { "type": "backupdr.googleapis.com/BackupDRProject" }, "logName": "projects/PROJECT_ID/logs/backupdr.googleapis.com/bdr_backup_restore_jobs" }將 PROJECT_ID 替換為專案名稱。
如果是 GKE 備份,請執行下列指令:
{ "entries": [ { "jsonPayload": { "jobCategory": "SCHEDULED_BACKUP", "jobStatus": "FAILED" } } ], "resource": { "type": "gkebackup.googleapis.com/Project" }, "logName": "projects/PROJECT_ID/logs/gkebackup.googleapis.com/bfg_backup_restore_jobs" }將 PROJECT_ID 替換為專案名稱。
複製先前設定的記錄項目。
在「Try this API」窗格中,按照下列步驟操作:
- 在「Request body」欄位中,將內容替換為您在上一個步驟複製的記錄項目。
- 按一下 [Execute] (執行)。如果系統出現提示,請按照驗證流程操作。
如果
logEntries.write呼叫成功,您會收到 HTTP200回應代碼和空白的回應主體{}。如要進一步瞭解 APIs Explorer,請參閱「使用 APIs Explorer」。記錄項目會透過下列方式,與快訊指定的篩選器相符:
logName值會指定雲端專案中的備份或還原工作記錄。jsonPayload包含失敗的工作類別SCHEDULED_BACKUP,表示記錄與備份方案排定的備份相關。jsonPayload包含欄位工作狀態 (FAILED),表示工作失敗。
寫入記錄項目後,系統會依序執行下列操作:
- Logs Explorer 中會顯示新的記錄項目,並觸發快訊。
- 系統會在「Cloud Monitoring」頁面中開啟事件。
系統會發送事件通知給您。如果您已設定電子郵件通知管道,系統就會顯示通知。
您可以點選電子郵件中的「查看事件」,在 Cloud Monitoring 頁面中查看事件。如要進一步瞭解事件,包括如何確認及關閉事件,請參閱「管理記錄檔型快訊的事件」。