Registros de trabajos de copia de seguridad y restauración de copias de seguridad protegidas

En esta página se explica cómo ver los registros de los trabajos de copia de seguridad y restauración de copias de seguridad protegidas en Cloud Logging. Estas copias de seguridad son de los recursos protegidos mediante planes de copias de seguridad. Si quieres ver los registros de las tareas de copia de seguridad y restauración protegidas mediante la plantilla de copia de seguridad en la consola de gestión, consulta Registros de tareas de copia de seguridad y recuperación.

Permisos y roles

Necesitas el permiso de gestión de identidades y accesos roles/logging.viewer para ver los registros de las tareas de copia de seguridad y restauración. El rol Logs Viewer te da acceso de solo lectura para ver los registros de trabajos de copia de seguridad y restauración de todos los recursos protegidos por el plan de copias de seguridad del proyecto especificado. Si las operaciones de copia de seguridad y restauración se realizan en otro proyecto, pide a tu administrador que asigne el permiso roles/logging.viewer en el proyecto en el que quieras ver los registros. Para obtener más información sobre los permisos y roles de gestión de identidades y accesos para controlar el acceso a los datos de registro, consulta el artículo sobre el control de acceso con gestión de identidades y accesos.

Ver los registros de tareas de copia de seguridad y restauración

Puedes ver los registros de las tareas de copia de seguridad y restauración de las copias de seguridad archivadas en Cloud Logging mediante la Google Cloud consola y la CLI de Google Cloud. Para ver los trabajos de copia de seguridad, selecciona el proyecto del almacén de copias de seguridad o el proyecto del recurso en el que se realiza la copia de seguridad. Para ver las tareas de restauración, selecciona el proyecto del almacén de copias de seguridad o el proyecto en el que se restaura el recurso.

Consola

En la consola, puedes usar el Explorador de registros para obtener las entradas de registro de copia de seguridad y restauración de tus copias de seguridad protegidas: Google Cloud

  1. En la Google Cloud consola, ve a Registro > Explorador de registros.
  2. Selecciona un proyecto de Cloud.
  3. En el panel Generador de consultas, seleccione bdr_backup_restore_jobs en el menú desplegable Seleccionar nombre de registro.

gcloud

Google Cloud CLI proporciona una interfaz de línea de comandos a la API Logging. Para leer las entradas de registro de copia de seguridad y restauración de un proyecto, ejecuta el siguiente comando:

```none
 gcloud logging read "logName:bdr_backup_restore_jobs" --project=PROJECT_ID
```

Haz los cambios siguientes:

  • PROJECT_ID: el nombre del proyecto. Para ver los trabajos de copia de seguridad, puedes introducir el proyecto del almacén de copias de seguridad o el proyecto del recurso en el que se realiza la copia de seguridad. Para ver los trabajos de restauración, puedes introducir el proyecto del almacén de copias de seguridad o el proyecto en el que se restaura el recurso.

Formato de registro de trabajos de copia de seguridad y restauración

Las entradas de registro de copias de seguridad y restauración incluyen los siguientes campos:

Campo Descripción
jobId ID asociado al trabajo.
sourceResourceName El nombre relativo del recurso protegido.
jobCategory La categoría del trabajo, que puede ser SCHEDULED_BACKUP, ON_DEMAND_BACKUP o RESTORE.
sourceResourceId ID del recurso protegido.
resourceType Tipo de recurso. Por ejemplo, una instancia de Compute Engine.
jobStatus El estado del trabajo, que puede ser SUCCESSFUL, FAILED, RUNNING o SKIPPED.
backupRule El nombre de la regla de copia de seguridad que ha activado el trabajo de copia de seguridad.
backupVaultName El nombre relativo del almacén de copias de seguridad donde se almacenan las copias de seguridad.
startTime La hora de inicio del trabajo, que está en formato YYYY-MM-DD HH:MM:SS.SSS UTC.
backupPlanName El nombre relativo del plan de copia de seguridad asociado al recurso. En el caso de los trabajos de restauración, el campo Nombre del plan de copia de seguridad sigue siendo Null.
errorCode Código de error asociado al trabajo fallido. El código de error se muestra como Null si no se ha producido ningún error en el trabajo.
errorType Nombre del tipo de error. Por ejemplo, PERMISSION_DENIED. El tipo de error se muestra como Null si no se ha producido ningún error en la tarea.
errorMessage El mensaje de error del trabajo fallido. El mensaje de error se muestra como Null si no se ha producido ningún error en el trabajo.
restoreResourceName El nombre relativo del recurso que se crea después de la restauración.
backupName En el caso de los trabajos de copia de seguridad, el nombre de la copia de seguridad es un nombre generado por el sistema para la copia de seguridad en forma de UUID. En el caso de los trabajos de restauración, el nombre de la copia de seguridad es el nombre de la copia de seguridad que se ha usado para realizar la restauración.

El siguiente ejemplo es una entrada de registro de una copia de seguridad programada en una instancia de 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"
      }

Consultas de ejemplo

Para ver los registros seleccionados, puedes escribir consultas personalizadas en la sección de consultas.

Usa la siguiente consulta para ver los trabajos fallidos.

    logName:"bdr_backup_restore_jobs" jsonPayload.jobStatus="FAILED"

Usa la siguiente consulta para ver los trabajos almacenados en un almacén de copias de seguridad.

    logName:"bdr_backup_restore_jobs" jsonPayload.backupVaultName:"backupVaults/BACKUPVAULT_NAME"

Usa la siguiente consulta para ver los trabajos creados con un plan de copia de seguridad.

    logName:"bdr_backup_restore_jobs" jsonPayload.backupPlanName:"backupPlans/BACKUPPLAN_NAME"

Ver los registros de detalles del plan de copia de seguridad

Puedes ver los registros de detalles del plan de copia de seguridad en Cloud Logging mediante laGoogle Cloud consola y la CLI de Google Cloud. Para ver los trabajos de copia de seguridad, selecciona el proyecto en el que se creó el plan de copia de seguridad.

Consola

En la consola de Google Cloud , puedes usar el Explorador de registros para obtener las entradas de registro de detalles del plan de copia de seguridad:

  1. En la Google Cloud consola, ve a Registro > Explorador de registros.
  2. Selecciona un proyecto de Cloud.
  3. En el panel Generador de consultas, seleccione bdr_backup_plan_details en el menú desplegable Seleccionar nombre de registro.

gcloud

Google Cloud CLI proporciona una interfaz de línea de comandos a la API Logging. Para leer las entradas de registro de copia de seguridad y restauración de un proyecto, ejecuta el siguiente comando:

 ```none
 gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
 ```

Haz los cambios siguientes:

  • PROJECT_ID: el nombre del proyecto en el que se creó el plan de copia de seguridad.

Formato del registro de detalles del plan de copia de seguridad

Las entradas de registro de copias de seguridad y restauración incluyen los siguientes campos:

Campo Descripción
backupPlanName El nombre relativo del plan de copia de seguridad.
ruleName Nombre de la regla de copia de seguridad utilizada en los trabajos de copia de seguridad.
recurrence El tipo de periodicidad de la copia de seguridad, que puede ser horaria, diaria, semanal, mensual o anual.
recurrenceSchedule La programación de recurrencia de una copia de seguridad basada en la regla de copia de seguridad.
backupWindow El periodo en el que se pueden iniciar los trabajos de copia de seguridad.
retentionDays Duración en días durante la que se deben conservar las copias de seguridad.
backupWindowTimezone Zona horaria que se aplica al periodo de backup.
backupVaultName El nombre relativo del almacén de copias de seguridad asociado al plan de copias de seguridad.
resourcesProtectedCount Número de recursos protegidos por el plan de copias de seguridad.
protectedDataVolumeGib Tamaño total en GiB de los datos de origen protegidos por el plan de copias de seguridad.

El siguiente ejemplo muestra una entrada de registro de 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"
        }

Consultas de ejemplo

Para ver los registros seleccionados, puedes escribir consultas personalizadas en la sección de consultas.

Usa la siguiente consulta para ver los planes de copia de seguridad asociados a un plan de copia de seguridad específico:

    logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"

Usa la siguiente consulta para ver los planes de copia de seguridad asociados a un almacén de copias de seguridad específico:

    logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"

Usa la siguiente consulta para ver los planes de copia de seguridad que contengan un nombre de regla específico:

    logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME

Ver informes de planes de copias de seguridad protegidas

Puedes ver los registros de detalles del plan de copia de seguridad en Cloud Logging mediante laGoogle Cloud consola y la CLI de Google Cloud. Para ver los trabajos de copia de seguridad, selecciona el proyecto en el que se creó el plan de copia de seguridad.

Consola

En la consola de Google Cloud , puedes usar el Explorador de registros para obtener las entradas de registro de detalles del plan de copia de seguridad:

  1. En la Google Cloud consola, ve a Registro > Explorador de registros.
  2. Selecciona un proyecto de Cloud.
  3. En el panel Generador de consultas, seleccione bdr_backup_plan_details en el menú desplegable Seleccionar nombre de registro.

gcloud

Google Cloud CLI proporciona una interfaz de línea de comandos a la API Logging. Para leer las entradas de registro de copia de seguridad y restauración de un proyecto, ejecuta el siguiente comando:

 ```none
 gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
 ```

Haz los cambios siguientes:

  • PROJECT_ID: el nombre del proyecto en el que se creó el plan de copia de seguridad.

Formato del informe del plan de copia de seguridad

Este informe proporciona información detallada sobre los planes de copias de seguridad configurados, sus reglas, los depósitos de copias de seguridad asociados y las estadísticas de los recursos que protegen.

El informe incluye los siguientes campos:

  • Fecha: la fecha más reciente en la que se actualizó la información del plan de copia de seguridad.
  • backup_plan_name: nombre asignado al plan de copia de seguridad.
  • backup_plan_location: la ubicación geográfica del plan de copia de seguridad.
  • backup_rules: un registro repetido (array) que contiene detalles específicos de cada regla de copia de seguridad del plan. Cada registro de regla incluye lo siguiente:
    • backup_rules.rule_name: nombre asignado a la regla de copia de seguridad.
    • backup_rules.recurrence: el tipo de periodicidad especificado para la copia de seguridad (por ejemplo, "hourly", "daily", "weekly", "monthly" o "yearly").
    • backup_rules.recurrence_schedule: la frecuencia definida de la regla de copia de seguridad (por ejemplo, "todos los días a las 10:00" o "todos los lunes").
    • backup_rules.backup_window: el periodo definido (en formato de reloj de 24 horas) durante el cual se permite que comiencen los trabajos de copia de seguridad (por ejemplo, "02:00-08:00").
    • backup_rules.backup_window_time_zone: la zona horaria en la que se programan las copias de seguridad (por ejemplo, "UTC", "America/Los_Angeles").
    • backup_rules.retention_days: la duración especificada (en días) durante la cual se conservarán las copias de seguridad de acuerdo con esta regla.
  • backup_vault_name: nombre del almacén de copias de seguridad vinculado de forma intrínseca al plan de copias de seguridad.
  • backup_vault_location: la ubicación geográfica del almacén de copias de seguridad asociado al plan de copias de seguridad.
  • resources_protected_count: número cuantificable de recursos protegidos por este plan de copia de seguridad específico.
  • protected_data_volume_gib: el volumen de datos agregado (expresado en GiB) de los recursos protegidos por este plan de copias de seguridad.
  • minimum_enforced_retention_days: el periodo de conservación mínimo obligatorio (en días) aplicable a las copias de seguridad asociadas a este plan de copias de seguridad.
  • effective_date_for_enforced_retention_lock: fecha exacta de entrada en vigor del bloqueo de conservación obligatorio.

  • lock_on_enforced_retention: indicador que indica si la conservación está bloqueada. Este campo se genera de forma dinámica según la siguiente lógica:

    • Si la marca de tiempo effective_date_for_enforced_retention_lock está presente y corresponde a la hora actual o a una hora anterior, el valor se designa como "bloqueado".
    • Si no se cumple esta condición, el valor se designa como "desbloqueado".

Consultas de ejemplo

Para ver los registros seleccionados, puedes escribir consultas personalizadas en la sección de consultas.

Usa la siguiente consulta para ver los planes de copia de seguridad asociados a un plan de copia de seguridad específico:

    logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"

Usa la siguiente consulta para ver los planes de copia de seguridad asociados a un almacén de copias de seguridad específico:

    logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"

Usa la siguiente consulta para ver los planes de copia de seguridad que contengan un nombre de regla específico:

    logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME

Siguientes pasos