Registros de eventos de copia de seguridad y recuperación tras fallos

En esta página se explica cómo ver los registros de eventos creados en el dispositivo de copia de seguridad o recuperación en Cloud Logging. Los registros de eventos proporcionan información valiosa sobre tu dispositivo de copia de seguridad o recuperación, como eventos del sistema o errores.

Permisos y roles

Los permisos y roles de IAM determinan si puedes acceder a los datos de los registros de eventos del servicio Backup and DR.

Necesitas el permiso roles/logging.viewer para ver los registros de eventos. El rol Visor de registros te da acceso de solo lectura para ver los registros de eventos de todos los dispositivos de copia de seguridad o recuperación del proyecto especificado. Para obtener más información sobre los permisos y roles de gestión de identidades y accesos que se aplican a los datos de los registros de eventos, consulta el artículo sobre el control de acceso con gestión de identidades y accesos.

Ver registros de eventos

Puedes ver los registros de eventos de Backup and DR en Cloud Logging mediante laGoogle Cloud consola Google Cloud y la CLI.

Consola

En la consola de Google Cloud , puede usar el Explorador de registros para obtener las entradas del registro de eventos de Backup and DR de sus dispositivos de copia de seguridad y recuperación:

  1. En la Google Cloud consola, ve a Logging > Explorador de registros.
  2. Selecciona un proyecto de Cloud.

  3. En el panel Generador de consultas, siga estos pasos:

    1. En el menú desplegable Recurso, selecciona Backup Recovery Appliance.
    2. En el menú desplegable Seleccionar nombre de registro, selecciona backup_recovery_appliance_events para ver los registros de eventos de los dispositivos de copia de seguridad y recuperación.
.

gcloud

La Google Cloud CLI proporciona una interfaz de línea de comandos a la API Logging. Proporciona un identificador de recurso válido en cada uno de los nombres de registro. Para leer las entradas del registro de eventos de los dispositivos de copia de seguridad o recuperación de un proyecto, ejecuta el siguiente comando:

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

API

Para ver las entradas del registro de auditoría de los dispositivos de copia de seguridad o recuperación de un proyecto, sigue estos pasos:

  1. Ve a la sección Probar esta API de la documentación del método entries.list.

  2. Introduce lo siguiente en la parte Cuerpo de la solicitud del formulario Probar esta API. Al hacer clic en este formulario rellenado automáticamente, se rellena el cuerpo de la solicitud, pero debes proporcionar un PROJECT_ID válido en cada campo de nombre de registro.

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

  3. Haz clic en la opción para ejecutar.

Formato del registro de eventos

Las entradas del registro de eventos de Backup and DR incluyen los siguientes campos:

  • appName este campo muestra el nombre de la aplicación asociada al evento.
  • srcid: este campo muestra un ID único del evento que se produce en el dispositivo de copia de seguridad o recuperación.
  • jobName este campo muestra el nombre del trabajo asociado al evento.
  • appType este campo muestra el tipo de aplicación asociado al evento.
  • eventId este campo muestra un ID único asociado al error.
  • component: este campo muestra la fuente del evento.
  • eventTime este campo muestra la hora en la que se ha registrado el evento.
  • errorMessage este campo describe el error detallado asociado al evento.

El siguiente ejemplo es una entrada de registro registrada en un dispositivo de copia de seguridad o recuperación ba-1-52973 de un trabajo de creación de instantáneas fallido.

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

Consultas de ejemplo

Puedes escribir consultas de eventos personalizadas en la sección de consultas para ver los registros de eventos que quieras.

Usa la siguiente consulta para ver todos los registros de eventos asociados a los dispositivos de copia de seguridad o recuperación de un PROJECT_ID determinado:

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

Si buscas registros de eventos de un dispositivo de copia de seguridad o recuperación específico, añade el nombre del dispositivo de copia de seguridad o recuperación:

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

Si buscas registros de eventos de un ID de evento específico, usa la siguiente consulta de registro. Asegúrate de usar AND en mayúsculas.

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

Si buscas registros de eventos de varios IDs de evento específicos, usa la siguiente consulta de registro. Asegúrate de usar AND y OR en mayúsculas.

    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)

Si buscas registros de eventos y quieres excluir IDs de eventos específicos, usa la siguiente consulta de registro. Asegúrate de usar AND NOT y OR en mayúsculas.

    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)

Si buscas registros de eventos de una aplicación concreta, utiliza la siguiente consulta de registro. Asegúrate de usar AND en mayúsculas.

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

Siguientes pasos