Registros de eventos de Backup and DR

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 sobre tu dispositivo de copia de seguridad o recuperación, como eventos o errores del sistema.

Permisos y funciones

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

Necesitas el permiso roles/logging.viewer para ver los registros de eventos. El rol de Visor de registros te otorga acceso de solo lectura para ver los registros de eventos de todos los dispositivos de copia de seguridad o recuperación en el proyecto especificado. Para obtener más información sobre los permisos y las funciones de IAM que se aplican a los datos de registros de eventos, consulta Control de acceso con IAM.

Cómo ver registros de eventos

Puedes ver los registros de eventos de copia de seguridad y DR en Cloud Logging con la consola deGoogle Cloud y la CLI de Google Cloud .

Console

En la consola de Google Cloud , puedes usar el Explorador de registros para recuperar las entradas de registro de eventos de copia de seguridad y DR de tus dispositivos de copia de seguridad o recuperación:

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

  3. En el panel Compilador de consultas, sigue estos pasos:

    1. En el menú desplegable Recurso, selecciona el Dispositivo de recuperación de copias de seguridad.
    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 o recuperación.

gcloud

La CLI de Google Cloud proporciona una interfaz de línea de comandos para la API de 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 en 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 en un proyecto, haz lo siguiente:

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

  2. Ingresa lo siguiente en el cuerpo de la solicitud del formulario Prueba esta API. Si haces clic en este formulario prepropagado, se completará el cuerpo de la solicitud de manera automática, pero deberás proporcionar un PROJECT_ID válido para 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 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 con el 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 de la tarea asociada con el evento.
  • appType: Este campo muestra el tipo de aplicación asociada con el evento.
  • eventId: Este campo muestra un ID único asociado con el error.
  • component: En este campo, se muestra la fuente del evento.
  • eventTime: Este campo muestra la hora en que se informó el evento.
  • errorMessage: Este campo describe el error detallado asociado con el evento.

El siguiente ejemplo es una entrada de registro de ejemplo registrada en un dispositivo de copia de seguridad o recuperación ba-1-52973 para un trabajo de instantánea que falló.

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

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

Usa la siguiente consulta para ver todos los registros de eventos asociados con 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, agrega el siguiente nombre de dispositivo:

    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 Y 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 eventos específicos, usa la siguiente consulta de registro. Asegúrate de usar Y y O 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 deseas excluir IDs de eventos específicos, usa la siguiente consulta de registro. Asegúrate de usar Y NO y O 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 específica, usa la siguiente consulta de registro. Asegúrate de usar mayúsculas en AND.

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

¿Qué sigue?