本页面介绍了如何在 Cloud Logging 中查看保险库备份的备份和恢复作业日志。这些备份适用于使用备份方案保护的资源。如果您想在管理控制台中查看使用备份模板保护的备份和恢复作业日志，请参阅备份和恢复作业日志。
权限和角色
您需要拥有 IAM 权限 roles/logging.viewer 才能查看备份和恢复作业日志。借助 Logs Viewer 角色，您可以获得只读权限，查看指定项目中受备份方案保护的所有资源的备份和恢复作业日志。如果备份和恢复操作是在其他项目中执行的，请让管理员在您要查看日志的项目中分配 roles/logging.viewer 权限。如需详细了解用于控制对日志数据访问权限的 IAM 权限和角色，请参阅使用 IAM 进行访问权限控制。
查看备份和恢复作业日志
您可以使用 Google Cloud 控制台和 Google Cloud CLI 查看 Cloud Logging 中已归档备份的备份和恢复作业日志。如需查看备份作业，请选择备份保险柜项目或执行备份的资源项目。如需查看恢复作业，请选择备份保险柜项目或资源恢复到的项目。
控制台
在 Google Cloud 控制台中，您可以使用日志浏览器来检索保险库备份的备份和恢复日志条目：
- 在 Google Cloud 控制台中，依次前往 Logging > 日志浏览器。
- 选择现有的 Cloud 项目。
- 在查询构建器窗格中，从选择日志名称下拉菜单中选择 bdr_backup_restore_jobs。
gcloud
Google Cloud CLI 为 Logging API 提供了命令行界面。如需读取项目的备份和恢复日志条目，请运行以下命令：
```none
gcloud logging read "logName:bdr_backup_restore_jobs" --project=PROJECT_ID
```
替换以下内容：
PROJECT_ID：项目的名称。如需查看备份作业，您可以输入备份保险柜项目或执行备份的资源项目。如需查看恢复作业，您可以输入备份保险柜项目或资源恢复到的项目。
备份和恢复作业日志格式
备份和恢复日志条目包含以下字段：
| 字段 | 说明 |
|---|---|
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 UTC 格式。 |
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"
使用以下查询可查看存储在备份保险柜中的作业。
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 > 日志浏览器。
- 选择现有的 Cloud 项目。
- 在查询构建器窗格中，从选择日志名称下拉菜单中选择 bdr_backup_plan_details。
gcloud
Google Cloud CLI 为 Logging 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 > 日志浏览器。
- 选择现有的 Cloud 项目。
- 在查询构建器窗格中，从选择日志名称下拉菜单中选择 bdr_backup_plan_details。
gcloud
Google Cloud CLI 为 Logging API 提供了命令行界面。如需读取项目的备份和恢复日志条目，请运行以下命令：
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
替换以下内容：
PROJECT_ID：创建备份方案的项目名称。
备份方案报告格式
此报告可全面深入地了解已配置的备份方案，详细说明其规则、关联的备份保管库以及其保护的资源的相关统计信息。
该报告包含以下字段：
- date：备份方案信息最近一次更新的日期。
- 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