Backup and DR event logs

This page explains how to view the event logs created on backup/recovery appliance in Cloud Logging. Event logs provide insight on your backup/recovery appliance, such as system events or errors.

Permissions and roles

IAM permissions and roles determine if you can access event logs data of Backup and DR Service.

You need the permission roles/logging.viewer to view the event logs. The Logs Viewer role gives you read-only access to view event logs of all backup/recovery appliances in the specified project. For more information about the IAM permissions and roles that apply to event logs data, see Access control with IAM.

View event logs

You can view Backup and DR event logs in Cloud Logging by using the Google Cloud console and the Google Cloud CLI.

Console

In the Google Cloud console, you can use the Logs Explorer to retrieve the Backup and DR event log entries for your backup/recovery appliances:

  1. In the Google Cloud console, go to the Logging > Logs Explorer.
  2. Select an existing Cloud project.
  3. In the Query builder pane, follow these steps:

    1. From the Resource drop-down, select the Backup Recovery Appliance.
    2. From the Select Log name drop-down, select the backup_recovery_appliance_events to view event logs of backup/recovery appliances.

gcloud

The Google Cloud CLI provides a command-line interface to the Logging API. Supply a valid resource identifier in each of the log names. To read your event log entries of backup/recovery appliances in a project, run the following command:

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

API

To view your audit log entries of backup/recovery appliances in a project, do the following:

  1. Go to the Try this API section in the documentation for the entries.list method.
  2. Put the following into the Request body part of the Try this API form. Clicking this prepopulated form automatically fills the request body, but you need to supply a valid PROJECT_ID in each of the log name field.

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

Event log format

Backup and DR event log entries include the following fields:

  • appName: This field displays the name of the application associated with the event.
  • srcid: This field displays a unique ID of the event occurring in the backup/recovery appliance.
  • jobName: This field displays the name of the job associated with the event.
  • appType: This field displays the type of the application associated with the event.
  • eventId: This field displays a unique ID associated with the error.
  • component: This field displays the source of the event.
  • eventTime: This field displays the time when the event was reported.
  • errorMessage: This field describes the detailed error associated with the event.

The following sample is an example log entry logged on a backup/recovery appliance ba-1-52973 for a failed snapshot job.

    {
    "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"
    }

Sample queries

You can write custom event queries in the query section to view the event logs that you want.

Use the following query to view all the event logs associated with backup/recovery appliances for a given PROJECT_ID:

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

If you are looking for event logs for a specific backup/recovery appliance, add the following backup/recovery appliance name:

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

If you are looking for event logs for a specific event ID, then use the following log query. Make sure you use an uppercase AND.

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

If you are looking for event logs for multiple specific event IDs, then use the following log query. Make sure you use an uppercase AND 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)

If you are looking for event logs and you want to exclude specific event IDs, then use the following log query. Make sure you use uppercase AND NOT and 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)

If you are looking for event logs for a specific application, then use the following log query. Make sure you use uppercase AND.

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

What's next