Backup e restauração de logs de jobs para backups no cofre

Nesta página, explicamos como visualizar os registros de jobs de backup e restauração para backups armazenados no Cloud Logging. Esses backups são para os recursos protegidos usando planos de backup. Se você quiser conferir os registros de jobs de backup e restauração protegidos usando o modelo de backup no console de gerenciamento, consulte Registros de jobs de backup e recuperação.

Permissões e papéis

Você precisa da permissão roles/logging.viewer do IAM para ver os registros de jobs de backup e restauração. A função Logs Viewer concede acesso somente leitura para visualizar os registros de jobs de backup e restauração de todos os recursos protegidos pelo plano de backup no projeto especificado. Se as operações de backup e restauração forem realizadas em um projeto diferente, peça ao administrador para atribuir a permissão roles/logging.viewer no projeto em que você quer ver os registros. Para mais informações sobre as permissões e os papéis do IAM para controlar o acesso aos dados de registros, consulte Controle de acesso com o IAM.

Ver registros de jobs de backup e restauração

É possível conferir os registros de jobs de backup e restauração para backups em cofre no Cloud Logging usando o console Google Cloud e a Google Cloud CLI. Para ver os jobs de backup, selecione o projeto do backup vault ou o projeto do recurso em que o backup é realizado. Para ver os jobs de restauração, selecione o projeto do backup vault ou o projeto em que o recurso foi restaurado.

Console

No console do Google Cloud , use o Explorador de registros para recuperar as entradas de registro de backup e restauração dos seus backups do Vault:

  1. No console Google Cloud , acesse Logging > Explorador de registros.
  2. Selecione um projeto do Cloud existente.
  3. No painel Criador de consultas, selecione bdr_backup_restore_jobs no menu suspenso Selecionar nome do registro.

gcloud

A Google Cloud CLI fornece uma interface de linha de comando para a API Logging. Para ler as entradas de registro de backup e restauração de um projeto, execute o seguinte comando:

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

Substitua:

  • PROJECT_ID: o nome do projeto. Para ver os jobs de backup, insira o projeto do backup vault ou o projeto do recurso em que o backup é realizado. Para ver os jobs de restauração, insira o projeto do backup vault ou o projeto em que o recurso foi restaurado.

Formato do registro de jobs de backup e restauração

As entradas de registro de backup e restauração incluem os seguintes campos:

Campo Descrição
jobId O ID associado ao job.
sourceResourceName O nome relativo do recurso protegido.
jobCategory A categoria do job, que pode ser SCHEDULED_BACKUP, ON_DEMAND_BACKUP ou RESTORE.
sourceResourceId O ID do recurso protegido.
resourceType O tipo de recurso. Por exemplo, uma instância do Compute Engine.
jobStatus O status do job, que pode ser SUCCESSFUL, FAILED, RUNNING ou SKIPPED.
backupRule O nome da regra de backup que acionou o job de backup.
backupVaultName O nome relativo do backup vault em que os backups são armazenados.
startTime O horário de início da vaga, que está no formato UTC YYYY-MM-DD HH:MM:SS.SSS.
backupPlanName O nome relativo do plano de backup associado ao recurso. Para jobs de restauração, o campo de nome do plano de backup permanece Null.
errorCode O código de erro associado ao job com falha. O código de erro é exibido como Null se nenhum erro ocorreu no job.
errorType O nome do tipo de erro. Por exemplo, PERMISSION_DENIED O tipo de erro é mostrado como Null se nenhum erro ocorreu no job.
errorMessage A mensagem de erro do job com falha. A mensagem de erro é exibida como Null se nenhum erro ocorreu no job.
restoreResourceName O nome relativo do recurso criado após a restauração.
backupName Para jobs de backup, o nome é gerado pelo sistema no formato de UUID. Para jobs de restauração, o nome do backup é o nome do backup usado para realizar a restauração.

O exemplo a seguir é uma entrada de registro de um backup programado em uma instância do 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"
      }

Amostras de consultas

Para ver os registros selecionados, escreva consultas personalizadas na seção de consultas.

Use a consulta a seguir para conferir os jobs com falha.

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

Use a consulta a seguir para ver os jobs armazenados em um backup vault.

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

Use a consulta a seguir para ver os jobs criados com um plano de backup.

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

Conferir registros de detalhes do plano de backup

É possível conferir os registros de detalhes do plano de backup no Cloud Logging usando o consoleGoogle Cloud e a Google Cloud CLI. Para ver os jobs de backup, selecione o projeto em que o plano de backup foi criado.

Console

No console do Google Cloud , use o Explorador de registros para recuperar as entradas de registros de detalhes do plano de backup:

  1. No console Google Cloud , acesse Logging > Explorador de registros.
  2. Selecione um projeto do Cloud existente.
  3. No painel Criador de consultas, selecione bdr_backup_plan_details no menu suspenso Selecionar nome do registro.

gcloud

A Google Cloud CLI fornece uma interface de linha de comando para a API Logging. Para ler as entradas de registro de backup e restauração de um projeto, execute o seguinte comando:

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

Substitua:

  • PROJECT_ID: o nome do projeto em que o plano de backup foi criado.

Formato do registro de detalhes do plano de backup

As entradas de registro de backup e restauração incluem os seguintes campos:

Campo Descrição
backupPlanName O nome relativo do plano de backup.
ruleName O nome da regra de backup usada para jobs de backup.
recurrence O tipo de recorrência do backup, que pode ser por hora, diário, semanal, mensal ou anual.
recurrenceSchedule A programação de recorrência de um backup com base na regra de backup.
backupWindow O período em que os jobs de backup podem começar.
retentionDays A duração em dias em que os backups devem ser retidos.
backupWindowTimezone O fuso horário que se aplica à janela de backup.
backupVaultName O nome relativo do cofre de backup associado ao plano de backup.
resourcesProtectedCount O número de recursos protegidos pelo plano de backup.
protectedDataVolumeGib O tamanho total em GiB dos dados de origem protegidos pelo plano de backup.

Confira a seguir um exemplo de entrada de registro 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"
        }

Amostras de consultas

Para ver os registros selecionados, escreva consultas personalizadas na seção de consultas.

Use a consulta a seguir para conferir os planos de backup associados a um plano específico:

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

Use a consulta a seguir para conferir os planos de backup associados a um cofre de backup específico:

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

Use a consulta a seguir para conferir os planos de backup que contêm um nome de regra específico:

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

Conferir relatórios de planos de backup para backups em vaults

É possível conferir os registros de detalhes do plano de backup no Cloud Logging usando o consoleGoogle Cloud e a Google Cloud CLI. Para ver os jobs de backup, selecione o projeto em que o plano de backup foi criado.

Console

No console do Google Cloud , use o Explorador de registros para recuperar as entradas de registros de detalhes do plano de backup:

  1. No console Google Cloud , acesse Logging > Explorador de registros.
  2. Selecione um projeto do Cloud existente.
  3. No painel Criador de consultas, selecione bdr_backup_plan_details no menu suspenso Selecionar nome do registro.

gcloud

A Google Cloud CLI fornece uma interface de linha de comando para a API Logging. Para ler as entradas de registro de backup e restauração de um projeto, execute o seguinte comando:

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

Substitua:

  • PROJECT_ID: o nome do projeto em que o plano de backup foi criado.

Formato do relatório do plano de backup

Esse relatório oferece insights abrangentes sobre os planos de backup configurados, detalhando as regras, os vaults de backup associados e as estatísticas dos recursos protegidos.

O relatório inclui os seguintes campos:

  • date: a data mais recente em que as informações do plano de backup foram atualizadas.
  • backup_plan_name: o nome designado do plano de backup.
  • backup_plan_location: a localização geográfica do plano de backup.
  • backup_rules: um registro repetido (matriz) que contém detalhes granulares para cada regra de backup no plano. Cada registro de regra inclui:
    • backup_rules.rule_name: o nome designado da regra de backup.
    • backup_rules.recurrence: o tipo de recorrência especificado para o backup (por exemplo, "por hora", "diariamente", "semanalmente", "mensalmente", "anualmente".
    • backup_rules.recurrence_schedule: a programação de recorrência definida para a regra de backup (por exemplo, "todos os dias às 10h", "todas as segundas-feiras").
    • backup_rules.backup_window: o período definido (no formato de relógio de 24 horas) em que os jobs de backup podem começar (por exemplo, "02:00-08:00").
    • backup_rules.backup_window_time_zone: o fuso horário em que os backups são programados (por exemplo, "UTC", "America/Los_Angeles").
    • backup_rules.retention_days: a duração especificada (em dias) durante a qual os backups serão retidos de acordo com essa regra.
  • backup_vault_name: o nome do backup vault intrinsecamente vinculado ao plano de backup.
  • backup_vault_location: o local geográfico do backup vault associado ao plano de backup.
  • resources_protected_count: o número quantificável de recursos protegidos por esse plano de backup específico.
  • protected_data_volume_gib: o volume agregado de dados (expresso em GiB) dos recursos protegidos por este plano de backup.
  • minimum_enforced_retention_days: o período mínimo obrigatório de retenção (em dias) aplicável aos backups associados a este plano de backup.
  • effective_date_for_enforced_retention_lock: a data de início da vigência exata do bloqueio da retenção obrigatória.
  • lock_on_enforced_retention: um indicador de se a retenção está em um estado bloqueado. Esse campo é gerado dinamicamente com base na seguinte lógica:

    • Se o carimbo de data/hora effective_date_for_enforced_retention_lock estiver presente e corresponder à hora atual ou a uma hora passada, o valor será designado como "bloqueado".
    • Se essa condição não for atendida, o valor será designado como "desbloqueado".

Amostras de consultas

Para ver os registros selecionados, escreva consultas personalizadas na seção de consultas.

Use a consulta a seguir para conferir os planos de backup associados a um plano específico:

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

Use a consulta a seguir para conferir os planos de backup associados a um cofre de backup específico:

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

Use a consulta a seguir para conferir os planos de backup que contêm um nome de regra específico:

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

A seguir