本頁面由 Cloud Translation API 翻譯而成。

為儲存庫資源設定記錄式警告

本頁說明如何透過 Google Cloud 控制台的「記錄檔總管」頁面，為封存資源設定記錄檔通知。

「記錄檔探索工具」頁面會引導您完成下列步驟，建立及編輯記錄式快訊：

提供警告的名稱和說明。
選擇要接收通知的記錄檔。
設定通知間隔時間。
設定事件自動關閉的時間。
指定通知對象。

您可以為備份和還原工作類別設定快訊：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：與工作負載專案中的備份計畫關聯相關的工作。
在「Query results」(查詢結果) 窗格的標頭中，按一下「Create alert」(建立快訊)。
在「快訊詳細資料」部分，執行下列操作：
1. 在「快訊政策名稱」欄位中，輸入快訊的名稱。這個名稱會顯示在通知標題中。
2. 在「Documentation」(說明文件) 欄位中，輸入快訊的說明。如要瞭解如何設定這個欄位的內容格式及調整內容，請參閱「在文件範本中使用 Markdown 和變數」。
點選「下一步」。
在「Choose logs to include in the alert」(選擇要加入快訊的記錄檔) 區段中，執行下列操作：
1. 按一下「預覽記錄」即可查看查詢和結果。如有需要，您也可以在這個窗格中編輯查詢。
2. 按一下「新增標籤」，然後執行下列操作。標籤可讓你自訂通知，讓通知內容更豐富。
  1. 在「顯示名稱」欄位中，輸入標籤名稱。
  2. 從「記錄檔欄位名稱」清單中選取記錄檔欄位名稱。這些欄位會根據所選查詢結果顯示。
  3. 在「規則運算式」欄位中，輸入運算式以從欄位中擷取值，該欄位只能包含一個規則運算式群組。
點選「下一步」。
在「設定通知頻率和自動關閉時間長度」部分，執行下列操作：
1. 從「通知傳送間隔時間」清單中，選取通知傳送間隔時間下限。這個值可讓您控制如果觸發多次，會收到這項快訊的通知幾次。
2. 從「事件自動關閉期限」清單中選取期限，缺少相符記錄項目時，事件經過這段時間後便會自動關閉。
點選「下一步」。
從「Notification channels」(通知管道) 清單中，為快訊選取一或多個通知管道。如果沒有設定通知管道，請按一下「管理通知管道」建立通知管道。如需操作說明，請參閱「建立及管理通知管道」。
按一下「儲存」。

測試以記錄為基礎的警告

如要測試您建立的記錄檔快訊，可以手動撰寫符合查詢條件的記錄項目。

請按照下列操作說明撰寫記錄檔項目。

前往 logEntries.write 參考頁面。

前往 logEntries.write

將 PROJECT_ID 變數改為專案 ID，設定下列記錄項目。

      {
        "entries": [
          {
            "jsonPayload": {
              "jobCategory": "SCHEDULED_BACKUP",
              "jobStatus": "FAILED"
            }
          }
        ],
        "resource": {
          "type": "backupdr.googleapis.com/BackupDRProject"
        },
        "logName": "projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs"
      }

更改下列內容：

PROJECT_ID：專案名稱。

複製先前設定的記錄項目。
在「Try this API」窗格中，按照下列步驟操作：
1. 在「Request body」欄位中，將內容替換為您在上一步驟中複製的記錄項目。
2. 按一下 [Execute] (執行)。如果系統出現提示，請按照驗證流程操作。
如果 logEntries.write 呼叫成功，您會收到 HTTP 200 回應代碼和空白的回應主體 {}。如要進一步瞭解 APIs Explorer，請參閱「使用 APIs Explorer」。

記錄項目符合快訊指定的篩選條件，方式如下：
- logName 值會指定雲端專案中的備份或還原工作記錄。
- jsonPayload 包含失敗的工作類別 SCHEDULED_BACKUP，表示記錄與備份方案排定的備份相關。
- jsonPayload 包含欄位工作狀態，如 FAILED 所示，表示工作失敗。
寫入記錄項目後，會發生下列情況：
1. Logs Explorer 中會顯示一個新的記錄項目，並觸發快訊。
2. 系統會在「Cloud Monitoring」頁面中開啟事件。
3. 系統會發送事件通知給您。如果您已設定電子郵件通知管道，系統就會顯示通知。
  
  您可以點選電子郵件中的「查看事件」，在 Cloud Monitoring 頁面中查看事件。如要進一步瞭解事件，包括如何確認及關閉事件，請參閱「管理記錄檔型快訊的事件」。

為儲存庫資源設定記錄式警告 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

建立記錄式警告

測試以記錄為基礎的警告

為儲存庫資源設定記錄式警告