备份和灾难恢复事件日志

本页介绍了如何在 Cloud Logging 中查看在备份/恢复设备上创建的事件日志。事件日志可让您深入了解备份/恢复设备，例如系统事件或错误。

权限和角色

IAM 权限和角色决定了您能否访问备份和灾难恢复服务的事件日志数据。

您需要拥有 roles/logging.viewer 权限才能查看事件日志。Logs Viewer 角色可为您提供对指定项目中所有备份/恢复设备事件日志的只读权限。如需详细了解适用于事件日志数据的 IAM 权限和角色，请参阅使用 IAM 进行访问权限控制。

查看事件日志

您可以使用Google Cloud 控制台和 Google Cloud CLI 在 Cloud Logging 中查看备份和灾难恢复事件日志。

控制台

在 Google Cloud 控制台中，您可以使用 Logs Explorer 检索备份/恢复设备的备份和灾难恢复事件日志条目：

  1. 在 Google Cloud 控制台中，依次选择 Logging > Logs Explorer。
  2. 选择现有的 Cloud 项目。

  3. 在查询构建器窗格中，请按以下步骤操作：

    1. 从资源下拉菜单中，选择备份恢复设备。
    2. 从选择日志名称下拉菜单中，选择 backup_recovery_appliance_events 以查看备份/恢复设备的日志。

gcloud

Google Cloud CLI 为 Logging API 提供了命令行界面。 在每个日志名称中提供有效的资源标识符。如需读取项目中备份/恢复设备的事件日志条目，请运行以下命令：

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

API

如需查看项目中备份/恢复设备的审核日志条目，请执行以下操作：

  1. 前往 entries.list 方法文档中的试用此 API 部分。

  2. 将以下内容添加到试用此 API 表单的请求正文部分。点击此预填充的表单后，系统会自动填充请求正文，但您需要在每个日志名称字段中提供一个有效的 PROJECT_ID。

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

  3. 点击执行。

事件日志格式

备份和灾难恢复事件日志条目包含以下字段：

  • 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

后续步骤