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

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

Permissões e papéis

Você precisa da permissão roles/logging.viewer do IAM para conferir os logs de backup e restauração de jobs. O papel Logs Viewer concede acesso de leitura para conferir os registros de trabalhos 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 acessar 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.

Conferir os registros de jobs de backup e restauração

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

Console

No console do Google Cloud, é possível usar o Explorador de registros para recuperar as entradas de registro de backup e restauração dos backups armazenados:

  1. No console do Google Cloud, acesse Logging > Análise 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 CLI do Google Cloud fornece uma interface de linha de comando para a API de registro. Para ler as entradas de registro de backup e restauração de um projeto, execute o seguinte comando:

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

Substitua:

  • PROJECT_ID: o nome do projeto. Para conferir os trabalhos de backup, entre no projeto do backup vault ou do recurso em que o backup é realizado. Para conferir os jobs de restauração, entre no projeto do cofre de backup ou no projeto em que o recurso é 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, SKIPPED.
backupRule O nome da regra de backup que acionou o job.
backupVaultName O nome relativo do backup vault em que os backups são armazenados.
startTime O horário de início do job, 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 como 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 será mostrado como Null se nenhum erro ocorrer no job.
errorMessage A mensagem de erro do job com falha. A mensagem de erro será exibida como Null se nenhum erro ocorrer no job.
restoreResourceName O nome relativo do recurso criado após a restauração.
backupName Para trabalhos de backup, o nome do backup é um nome gerado pelo sistema no formato de UUID. Para trabalhos 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 conferir 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 conferir os jobs armazenados em um backup vault.

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

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

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

A seguir