本頁說明如何透過 Cloud Logging 查看已封存備份資料的備份和還原作業記錄。這些備份適用於使用備份方案保護的資源。如要查看使用管理控制台備份範本保護的備份和還原工作記錄，請參閱「備份和復原工作記錄」。
權限與角色
您必須具備 roles/logging.viewer IAM 權限，才能查看備份和還原作業記錄。Logs Viewer 角色可授予唯讀存取權，讓您查看指定專案中所有受備份方案保護的資源備份和還原工作記錄。如果備份和還原作業是在其他專案中執行，請管理員在您要查看記錄的專案中指派 roles/logging.viewer 權限。如要進一步瞭解如何透過 IAM 權限和角色控管記錄資料的存取權，請參閱「使用 IAM 控管存取權」一文。
查看備份和還原工作記錄
您可以使用 Google Cloud 控制台和 Google Cloud CLI，在 Cloud Logging 中查看已封存備份資料的備份和還原工作記錄。如要查看備份工作，請選取備份 vault 專案或執行備份的資源專案。如要查看還原工作，請選取備份儲存空間專案，或資源還原所在的專案。
控制台
在 Google Cloud 控制台中，您可以使用「記錄檔探索工具」擷取已封存備份的備份和還原記錄項目：
- 前往 Google Cloud 控制台的「Logging」 >「Logs Explorer」。
- 選取現有的 Cloud 專案。
- 在「查詢產生器」窗格中，從「選取記錄檔名稱」下拉式選單中選取「bdr_backup_restore_jobs」。
gcloud
Google Cloud CLI 提供記錄 API 的指令列介面。如要讀取專案的備份和還原記錄項目，請執行下列指令：
```none
gcloud logging read "logName:bdr_backup_restore_jobs" --project=PROJECT_ID
```
更改下列內容：
PROJECT_ID：專案名稱。如要查看備份工作，您可以輸入備份 vault 專案或執行備份的資源專案。如要查看還原工作，可以輸入備份儲存庫專案，或資源還原所在的專案。
備份與還原工作記錄格式
備份和還原記錄項目包含下列欄位：
| 欄位 | 說明 |
|---|---|
jobId |
與工作相關聯的 ID。 |
sourceResourceName |
受保護資源的相對名稱。 |
jobCategory |
工作類別，可以是 SCHEDULED_BACKUP、ON_DEMAND_BACKUP 或 RESTORE。 |
sourceResourceId |
受保護資源的 ID。 |
resourceType |
資源的類型。例如 Compute Engine 執行個體。 |
jobStatus |
工作狀態，可以是 SUCCESSFUL、FAILED、RUNNING、SKIPPED。 |
backupRule |
觸發備份工作的備份規則名稱。 |
backupVaultName |
備份儲存位置的備份儲存庫相對名稱。 |
startTime |
這項工作的開始時間，格式為 YYYY-MM-DD HH:MM:SS.SSS 世界標準時間。 |
backupPlanName |
與資源相關聯的備份方案相對名稱。如果是還原作業，備份方案名稱欄位會維持 Null。 |
errorCode |
失敗工作相關的錯誤代碼。如果作業未發生錯誤，錯誤代碼會顯示為 Null。 |
errorType |
錯誤類型名稱。例如，PERMISSION_DENIED。如果工作未發生錯誤，錯誤類型會顯示為 Null。 |
errorMessage |
失敗工作的錯誤訊息。如果工作未發生錯誤，錯誤訊息會顯示為 Null。 |
restoreResourceName |
成功還原後建立的資源相對名稱。 |
backupName |
如果是備份作業，備份名稱是系統為備份作業產生的名稱，格式為 UUID。如果是還原作業，備份名稱是指用於執行還原作業的備份名稱。 |
以下範例是 Compute Engine 執行個體排定備份作業的記錄項目。
{
"insertId": "696883be-582d-4af4-b2b8-a4c497e49489",
"jsonPayload": {
"jobId": "696883be-582d-4af4-b2b8-a4c497e49489",
"@type": "type.googleapis.com/google.cloud.backupdr.logging.v1.BDRBackupRestoreJobLog",
"sourceResourceName": "projects/Source_project_ID/zones/asia-east1-c/instances/Instance_name",
"jobCategory": "SCHEDULED_BACKUP",
"sourceResourceId": "6114243930178522357",
"resourceType": "Compute Engine",
"jobStatus": "RUNNING",
"backupRule": "backup-rule-1",
"backupVaultName": "projects/Backupvault_project_ID/locations/asia-east1/backupVaults/Backupvault_name",
"startTime": "2024-09-10T06:37:00.303416182Z",
"backupPlanName": "projects/Backupplan_project_ID/locations/asia-east1/backupPlans/Backupplan_Name"
},
"resource": {
"type": "backupdr.googleapis.com/BackupDRProject",
"labels": {
"resource_container": "projects/223618678509",
"location": "asia-east1"
}
},
"timestamp": "2024-09-10T06:37:00.303416182Z",
"logName": "projects/Backupvault_Name/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs",
"receiveTimestamp": "2024-09-10T06:37:01.818767274Z"
}
查詢範例
如要查看所選記錄，可以在查詢專區中編寫自訂查詢。
使用下列查詢查看失敗的工作。
logName:"bdr_backup_restore_jobs" jsonPayload.jobStatus="FAILED"
使用下列查詢，查看儲存在 backup vault 的工作。
logName:"bdr_backup_restore_jobs" jsonPayload.backupVaultName:"backupVaults/BACKUPVAULT_NAME"
使用下列查詢，查看透過備份計畫建立的工作。
logName:"bdr_backup_restore_jobs" jsonPayload.backupPlanName:"backupPlans/BACKUPPLAN_NAME"
查看備份方案詳細資料記錄
您可以使用Google Cloud 控制台和 Google Cloud CLI，在 Cloud Logging 中查看備份計畫詳細資料記錄。如要查看備份作業，請選取建立備份方案的專案。
控制台
在 Google Cloud 控制台中，您可以使用「記錄檔探索工具」擷取備份計畫詳細資料記錄項目：
- 前往 Google Cloud 控制台的「Logging」 >「Logs Explorer」。
- 選取現有的 Cloud 專案。
- 在「查詢產生器」窗格中，從「選取記錄檔名稱」下拉式選單中選取「bdr_backup_plan_details」。
gcloud
Google Cloud CLI 提供記錄 API 的指令列介面。如要讀取專案的備份和還原記錄項目，請執行下列指令：
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
更改下列內容：
PROJECT_ID：建立備份計畫的專案名稱。
備份方案詳細資料記錄格式
備份和還原記錄項目包含下列欄位：
| 欄位 | 說明 |
|---|---|
backupPlanName |
備份方案的相對名稱。 |
ruleName |
用於備份工作的備份規則名稱。 |
recurrence |
備份重複類型，可以是每小時、每天、每週、每月或每年。 |
recurrenceSchedule |
根據備份規則設定的備份週期排程。 |
backupWindow |
備份工作可開始的時間範圍。 |
retentionDays |
備份資料的保留天數。 |
backupWindowTimezone |
適用於備份時間範圍的時區。 |
backupVaultName |
與備份方案相關聯的備份保存庫相對名稱。 |
resourcesProtectedCount |
備份方案保護的資源數量。 |
protectedDataVolumeGib |
備份方案保護的來源資料總大小 (以 GiB 為單位)。 |
以下是 bdr_backup_plan_details 記錄項目的範例。
{
"insertId": "15792541403682418506",
"jsonPayload": {
"resourcesProtectedCount": 3,
"protectedDataVolumeGib": 30,
"@type": "type.googleapis.com/google.cloud.backupdr.logging.v1.BDRBackupPlanDetailsLog",
"backupVaultName": "projects/hk-staging-saas-report-1/locations/us-central1/backupVaults/hk-bv-1",
"backupPlanName": "projects/hk-staging-saas-report-1/locations/us-central1/backupPlans/hk-bp-2",
"backupRuleDetails": [
{
"retentionDays": 10,
"recurrence": "Daily",
"recurrenceSchedule": "Every day",
"backupWindow": "00:00 to 24:00",
"ruleName": "hk-br-2",
"backupWindowTimezone": "Asia/Calcutta"
}
]
},
"resource": {
"type": "staging-backupdr.sandbox.googleapis.com/BackupPlan",
"labels": {
"location": "us-central1",
"resource_container": "838468076466",
"backup_plan_id": "hk-bp-2"
}
},
"timestamp": "2025-06-09T08:04:10Z",
"severity": "INFO",
"logName": "projects/hk-staging-saas-report-1/logs/staging-backupdr.sandbox.googleapis.com%2Fbdr_backup_plan_details",
"receiveTimestamp": "2025-06-09T09:40:14.711832094Z"
}
查詢範例
如要查看所選記錄，可以在查詢專區中編寫自訂查詢。
使用下列查詢，查看與特定備份方案相關聯的備份方案：
logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"
使用下列查詢，查看與特定備份儲存空間相關聯的備份方案：
logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"
使用下列查詢，查看包含特定規則名稱的備份計畫：
logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME
查看受保管備份的備份方案報表
您可以使用Google Cloud 控制台和 Google Cloud CLI，在 Cloud Logging 中查看備份計畫詳細資料記錄。如要查看備份作業，請選取建立備份方案的專案。
控制台
在 Google Cloud 控制台中，您可以使用「記錄檔探索工具」擷取備份計畫詳細資料記錄項目：
- 前往 Google Cloud 控制台的「Logging」 >「Logs Explorer」。
- 選取現有的 Cloud 專案。
- 在「查詢產生器」窗格中，從「選取記錄檔名稱」下拉式選單中選取「bdr_backup_plan_details」。
gcloud
Google Cloud CLI 提供記錄 API 的指令列介面。如要讀取專案的備份和還原記錄項目，請執行下列指令：
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
更改下列內容：
PROJECT_ID：建立備份計畫的專案名稱。
備份方案報表格式
這份報表提供已設定備份方案的完整深入分析，詳細列出方案的規則、相關聯的備份 vault，以及方案保護的資源統計資料。
報表包含下列欄位：
- 日期：備份方案資訊最近一次更新的日期。
- backup_plan_name：備份方案的指定名稱。
- backup_plan_location：備份方案的地理位置。
- backup_rules：重複記錄 (陣列)，內含方案中每項備份規則的詳細資料。每筆規則記錄都包含：
- backup_rules.rule_name：備份規則的指定名稱。
- backup_rules.recurrence：備份的指定重複類型 (例如 「每小時」、「每天」、「每週」、「每月」、「每年」)。
- backup_rules.recurrence_schedule：備份規則的已定義重複排程 (例如 「每天上午 10:00」、「每週一」)。
- backup_rules.backup_window：定義的時間範圍 (以 24 小時制表示)，允許開始備份工作 (例如 "02:00-08:00").
- backup_rules.backup_window_time_zone：排定備份作業時所用的時區 (例如 「UTC」、「America/Los_Angeles」)。
- backup_rules.retention_days：根據這項規則保留備份的指定時間長度 (以天為單位)。
- backup_vault_name：與備份方案有內在連結的備份保存庫名稱。
- backup_vault_location：與備份方案相關聯的備份儲存空間地理位置。
- resources_protected_count：受這個特定備份方案保護的資源數量 (可量化)。
- protected_data_volume_gib：這個備份方案保護的資源資料量總和 (以 GiB 為單位)。
- minimum_enforced_retention_days：適用於與此備份方案相關聯備份的最短強制保留期限 (以天為單位)。
- effective_date_for_enforced_retention_lock：強制保留期限鎖定的確切生效日期。
lock_on_enforced_retention：指出保留期限是否處於鎖定狀態。這個欄位是根據下列邏輯動態產生：
- 如果
effective_date_for_enforced_retention_lock時間戳記存在，且對應目前時間或過去時間，則該值會指定為「已鎖定」。 - 如未符合這項條件，值會指定為「已解鎖」。
- 如果
查詢範例
如要查看所選記錄，可以在查詢專區中編寫自訂查詢。
使用下列查詢，查看與特定備份方案相關聯的備份方案：
logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"
使用下列查詢，查看與特定備份儲存空間相關聯的備份方案：
logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"
使用下列查詢，查看包含特定規則名稱的備份計畫：
logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME