備份和災難復原事件記錄

本頁面說明如何在 Cloud Logging 中查看備份/復原裝置上建立的事件記錄檔。事件記錄可提供備份/復原裝置的洞察資訊，例如系統事件或錯誤。

權限與角色

IAM 權限和角色會決定您是否可以存取備份和災難復原服務的事件記錄資料。

您必須具備 roles/logging.viewer 權限，才能查看事件記錄。記錄檢視器角色可讓您對指定專案中所有備份/復原裝置的事件記錄具備唯讀存取權。如要進一步瞭解適用於事件記錄資料的 IAM 權限和角色，請參閱「使用 IAM 控管存取權」。

查看事件記錄

您可以使用Google Cloud 控制台和 Google Cloud CLI，在 Cloud Logging 中查看備份和 DR 事件記錄。

控制台

在 Google Cloud 控制台中，您可以使用「Logs Explorer」擷取備份/復原裝置的備份和 DR 事件記錄項目：

  1. 前往 Google Cloud 控制台的「Logging」>「Logs Explorer」。
  2. 選取現有的雲端專案。

  3. 在「Query builder」(查詢建立工具) 窗格中，按照下列步驟操作：

    1. 在「Resource」下拉式選單中，選取「Backup Recovery Appliance」。
    2. 從「Select Log name」下拉式選單中選取「backup_recovery_appliance_events」backup_recovery_appliance_events，即可查看備份/復原裝置的事件記錄。
中查看 2023 年 3 月 6 日後產生的事件記錄。

gcloud

Google Cloud CLI 提供 Logging API 的指令列介面。並在每個記錄名稱中提供有效的資源 ID。如要讀取專案中備份/復原設備的事件記錄項目，請執行下列指令：

```gcloud
gcloud logging read "logName : projects/PROJECT_ID/logs/backup_recovery_appliance_events"\
 --project=PROJECT_ID
 ```

API

如要在專案中查看備份/復原裝置的稽核記錄項目，請執行下列操作：

  1. 前往 entries.list 方法說明文件中的「Try this API」(試用這個 API) 區段。

  2. 將下列內容放入「Try this API」表單的「Request body」部分。按一下這份已預先填入資料的表單就能自動填入要求主體，但您必須在每個記錄名稱欄位中提供有效的 PROJECT_ID。

    ```API
{
  "resourceNames": [
    "projects/PROJECT_ID"
  ],
  "pageSize": 5,
  "filter": "logName : projects/PROJECT_ID/logs/backupdr_audit_log"
}
```

  3. 按一下 [Execute] (執行)。

事件記錄格式

備份和 DR 事件記錄項目包含下列欄位：

  • appName：這個欄位會顯示與事件相關聯的應用程式名稱。
  • srcid：這個欄位會顯示備份/復原裝置中發生的事件的專屬 ID。
  • jobName：這個欄位會顯示與事件相關聯的工作名稱。
  • appType：這個欄位會顯示與事件相關聯的應用程式類型。
  • eventId：這個欄位會顯示與錯誤相關聯的專屬 ID。
  • component：這個欄位會顯示事件來源。
  • eventTime：這個欄位會顯示事件回報的時間。
  • errorMessage：這個欄位會說明與事件相關的詳細錯誤。

以下範例是備份/復原裝置 ba-1-52973 針對失敗的快照工作記錄的記錄項目範例。

    {
    "insertId": "aop2oko38hsami1c",
    "jsonPayload": {
    "appName": "instance-2",
    "srcid": "111428",
    "jobName": "Job_0110906c",
    "appType": "GCPInstance",
    "eventId": 43901,
    "component": "udp",
    "eventTime": "2023-02-06T20:24:52.450Z",
    "errorMessage": "Failed snapshot Job_0110906c for application instance-2 on host instance-2, Error: 1249: Failed to get VM details , sltname: pd snaps, slpname: ba-1-52973_Profile. "
    },
    "resource": {
    "type": "backupdr.googleapis.com/BackupRecoveryAppliance",
    "labels": {
    "backup_recovery_appliance_id": "test-backup-recovery-appliances",
    "resource_container": "projects/1234567",
    "management_server_id": "abcd-efgh-1234-5678-6789",
    "location": ""
    }
    },
    "timestamp": "2023-02-06T20:24:55.275029393Z",
    "severity": "ERROR",
    "logName": "projects/project1/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events",
    "receiveTimestamp": "2023-02-06T20:24:56.388937247Z"
    }
。

查詢範例

您可以在查詢部分編寫自訂事件查詢，查看所需的事件記錄。

使用下列查詢，查看特定 PROJECT_ID 的備份/復原裝置相關的所有事件記錄：

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"

如果您要查看特定備份/復原設備的事件記錄，請新增下列備份/復原設備名稱：

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    resource.labels.backup_recovery_appliance_id= "backup/recovery appliance name"

如果您要查看特定事件 ID 的事件記錄，請使用下列記錄查詢。請務必使用大寫的 AND。

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    AND jsonPayload.eventId = event ID

如果您要查看多個特定事件 ID 的事件記錄，請使用下列記錄查詢。請務必使用大寫的 AND 和 OR。

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    AND jsonPayload.eventId = (event ID 1 OR event ID 2 OR event ID 3)

如果您要查看事件記錄，並且想要排除特定事件 ID，請使用下列記錄查詢。請務必使用大寫的 AND NOT 和 OR。

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    AND NOT jsonPayload.eventId = (event ID 1 OR event ID 2 OR event ID 3)

如果您要查看特定應用程式的事件記錄，請使用下列記錄查詢。請務必使用大寫的 AND。

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND jsonPayload.app_name = appname

後續步驟