Esta página explica como ver os registos de tarefas de cópia de segurança e restauro para cópias de segurança protegidas no Cloud Logging. Estas cópias de segurança destinam-se aos recursos protegidos através de planos de cópia de segurança. Se quiser ver os registos de tarefas de cópia de segurança e restauro protegidos através do modelo de cópia de segurança na consola de gestão, consulte o artigo Registos de tarefas de cópia de segurança e recuperação.
Autorizações e funções
Precisa da autorização de IAM roles/logging.viewer para ver os registos de tarefas de cópia de segurança e restauro. A função Logs Viewer concede-lhe acesso só de leitura
para ver os registos de tarefas de cópia de segurança e restauro de todos os recursos protegidos
pelo plano de cópia de segurança no projeto especificado. Se as operações de cópia de segurança e restauro forem
realizadas num projeto diferente, peça ao seu administrador para atribuir a autorização
roles/logging.viewer no projeto onde quer ver os registos. Para mais
informações acerca das autorizações e funções da IAM para controlar o acesso
aos dados de registos, consulte o artigo Controlo de acesso com a IAM.
Veja registos de tarefas de cópia de segurança e restauro
Pode ver os registos de tarefas de cópia de segurança e restauro de cópias de segurança protegidas no Cloud Logging através da Google Cloud consola e da CLI Google Cloud. Para ver tarefas de cópia de segurança, selecione o projeto do cofre de cópias de segurança ou o projeto de recursos onde a cópia de segurança é realizada. Para ver tarefas de restauro, selecione o projeto do cofre de cópias de segurança ou o projeto no qual o recurso é restaurado.
Consola
Na Google Cloud consola, pode usar o Explorador de registos para obter as entradas de registos de cópias de segurança e restauro das suas cópias de segurança protegidas:
- Na Google Cloud consola, aceda a Registo > Explorador de registos.
- Selecione um projeto na nuvem existente.
- No painel Criador de consultas, selecione bdr_backup_restore_jobs no menu pendente Selecionar nome do registo.
gcloud
A CLI gcloud fornece uma interface de linhas de comando para a API Logging. Para ler as entradas do registo de cópia de segurança e restauro de um projeto, execute o seguinte comando:
```none
gcloud logging read "logName:bdr_backup_restore_jobs" --project=PROJECT_ID
```
Substitua o seguinte:
PROJECT_ID: o nome do projeto. Para ver tarefas de cópia de segurança, pode introduzir o projeto do cofre de cópias de segurança ou o projeto de recursos onde a cópia de segurança é realizada. Para ver as tarefas de restauro, pode introduzir o projeto do contentor de cópias de segurança ou o projeto no qual o recurso é restaurado.
Formato do registo de trabalhos de cópia de segurança e restauro
As entradas do registo de cópia de segurança e restauro incluem os seguintes campos:
| Campo | Descrição |
|---|---|
jobId |
O ID associado à tarefa. |
sourceResourceName |
O nome relativo do recurso protegido. |
jobCategory |
A categoria da tarefa, 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 estado da tarefa, que pode ser SUCCESSFUL, FAILED, RUNNING, SKIPPED. |
backupRule |
O nome da regra de cópia de segurança que acionou a tarefa de cópia de segurança. |
backupVaultName |
O nome relativo do cofre de cópias de segurança onde as cópias de segurança estão armazenadas. |
startTime |
A hora de início da tarefa, que está no formato YYYY-MM-DD HH:MM:SS.SSS UTC. |
backupPlanName |
O nome relativo do plano de cópia de segurança associado ao recurso. Para tarefas de restauro, o campo do nome do plano de cópia de segurança permanece Null. |
errorCode |
O código de erro associado à tarefa com falha. O código de erro é apresentado como Null se não tiver ocorrido nenhum erro na tarefa. |
errorType |
O nome do tipo de erro. Por exemplo, PERMISSION_DENIED. O tipo de erro é apresentado como Null se não tiver ocorrido nenhum erro na tarefa. |
errorMessage |
A mensagem de erro para a tarefa com falha. A mensagem de erro é apresentada como Null se não tiver ocorrido nenhum erro na tarefa. |
restoreResourceName |
O nome relativo do recurso que é criado após o restauro bem-sucedido. |
backupName |
Para tarefas de cópia de segurança, o nome da cópia de segurança é um nome gerado pelo sistema para a cópia de segurança no formato de UUID. Para tarefas de restauro, o nome da cópia de segurança é o nome da cópia de segurança usada para realizar o restauro. |
O exemplo seguinte é um exemplo de uma entrada de registo para uma cópia de segurança agendada numa 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"
}
Consultas de exemplo
Para ver os registos selecionados, pode escrever consultas personalizadas na secção de consultas.
Use a seguinte consulta para ver as tarefas com falhas.
logName:"bdr_backup_restore_jobs" jsonPayload.jobStatus="FAILED"
Use a seguinte consulta para ver tarefas armazenadas num cofre de cópias de segurança.
logName:"bdr_backup_restore_jobs" jsonPayload.backupVaultName:"backupVaults/BACKUPVAULT_NAME"
Use a seguinte consulta para ver tarefas criadas com um plano de yedekleme.
logName:"bdr_backup_restore_jobs" jsonPayload.backupPlanName:"backupPlans/BACKUPPLAN_NAME"
Veja os registos de detalhes do plano de cópia de segurança
Pode ver os registos de detalhes do plano de cópia de segurança no Cloud Logging através da Google Cloud consola e da CLI Google Cloud. Para ver tarefas de cópia de segurança, selecione o projeto onde o plano de cópia de segurança foi criado.
Consola
Na Google Cloud consola, pode usar o Explorador de registos para obter as entradas de registos de detalhes do plano de backup:
- Na Google Cloud consola, aceda a Registo > Explorador de registos.
- Selecione um projeto na nuvem existente.
- No painel Criador de consultas, selecione bdr_backup_plan_details no menu pendente Selecionar nome do registo.
gcloud
A CLI gcloud fornece uma interface de linhas de comando para a API Logging. Para ler as entradas do registo de cópia de segurança e restauro de um projeto, execute o seguinte comando:
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
Substitua o seguinte:
PROJECT_ID: o nome do projeto onde o plano de cópia de segurança foi criado.
Formato do registo de detalhes do plano de cópia de segurança
As entradas do registo de cópia de segurança e restauro incluem os seguintes campos:
| Campo | Descrição |
|---|---|
backupPlanName |
O nome relativo do plano de cópia de segurança. |
ruleName |
O nome da regra de cópia de segurança usada para trabalhos de cópia de segurança. |
recurrence |
O tipo de recorrência da cópia de segurança, que pode ser de hora a hora, diária, semanal, mensal ou anual. |
recurrenceSchedule |
A programação de recorrência de uma cópia de segurança com base na regra de cópia de segurança. |
backupWindow |
O período durante o qual as tarefas de cópia de segurança podem ser iniciadas. |
retentionDays |
A duração, em dias, durante a qual as cópias de segurança devem ser retidas. |
backupWindowTimezone |
O fuso horário aplicável ao período de cópia de segurança. |
backupVaultName |
O nome relativo do cofre de cópias de segurança associado ao plano de cópias de segurança. |
resourcesProtectedCount |
O número de recursos protegidos pelo plano de cópia de segurança. |
protectedDataVolumeGib |
O tamanho total em GiB dos dados de origem protegidos pelo plano de cópia de segurança. |
O exemplo seguinte é um exemplo de uma entrada de registo 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 exemplo
Para ver os registos selecionados, pode escrever consultas personalizadas na secção de consultas.
Use a seguinte consulta para ver os planos de cópia de segurança associados a um plano de cópia de segurança específico:
logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"
Use a seguinte consulta para ver os planos de cópia de segurança associados a um cofre de cópias de segurança específico:
logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"
Use a seguinte consulta para ver planos de cópia de segurança que contêm um nome de regra específico:
logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME
Veja relatórios do plano de cópia de segurança para cópias de segurança protegidas
Pode ver os registos de detalhes do plano de cópia de segurança no Cloud Logging através da Google Cloud consola e da CLI Google Cloud. Para ver tarefas de cópia de segurança, selecione o projeto onde o plano de cópia de segurança foi criado.
Consola
Na Google Cloud consola, pode usar o Explorador de registos para obter as entradas de registos de detalhes do plano de backup:
- Na Google Cloud consola, aceda a Registo > Explorador de registos.
- Selecione um projeto na nuvem existente.
- No painel Criador de consultas, selecione bdr_backup_plan_details no menu pendente Selecionar nome do registo.
gcloud
A CLI gcloud fornece uma interface de linhas de comando para a API Logging. Para ler as entradas do registo de cópia de segurança e restauro de um projeto, execute o seguinte comando:
```none
gcloud logging read "logName: bdr_backup_plan_details" --project=PROJECT_ID
```
Substitua o seguinte:
PROJECT_ID: o nome do projeto onde o plano de cópia de segurança foi criado.
Formato do relatório do plano de cópia de segurança
Este relatório oferece estatísticas abrangentes sobre os planos de cópia de segurança configurados, detalhando as respetivas regras, cofres de cópias de segurança associados e as estatísticas dos recursos que protegem.
O relatório inclui os seguintes campos:
- date: a data mais recente em que as informações do plano de cópia de segurança foram atualizadas.
- backup_plan_name: o nome designado do plano de cópia de segurança.
- backup_plan_location: a localização geográfica do plano de cópia de segurança.
- backup_rules: um registo repetido (matriz) que contém detalhes detalhados para cada regra de cópia de segurança no plano. Cada registo de regra compreende:
- backup_rules.rule_name: o nome designado da regra de cópia de segurança.
- backup_rules.recurrence: o tipo de recorrência especificado para a cópia de segurança (por exemplo, "hourly" (de hora em hora), "daily" (diariamente), "weekly" (semanalmente), "monthly" (mensalmente) e "yearly" (anualmente).
- backup_rules.recurrence_schedule: o agendamento de recorrência definido para a regra de cópia de segurança (por exemplo, "todos os dias às 10:00", "todas as segundas-feiras").
- backup_rules.backup_window: O intervalo de tempo definido (no formato de relógio de 24 horas) durante o qual os trabalhos de cópia de segurança têm permissão para começar (por exemplo, "02:00-08:00").
- backup_rules.backup_window_time_zone: O fuso horário no qual as cópias de segurança são agendadas (por exemplo, "UTC" ou "America/Los_Angeles").
- backup_rules.retention_days: a duração especificada (em dias) durante a qual as cópias de segurança devem ser retidas de acordo com esta regra.
- backup_vault_name: O nome do cofre de cópias de segurança intrinsecamente associado ao plano de cópias de segurança.
- backup_vault_location: a localização geográfica do cofre de cópias de segurança associado ao plano de cópia de segurança.
- resources_protected_count: O número quantificável de recursos protegidos por este plano de cópia de segurança específico.
- protected_data_volume_gib: O volume de dados agregado (expresso em GiB) dos recursos protegidos por este plano de cópia de segurança.
- minimum_enforced_retention_days: O período de retenção obrigatório mínimo (em dias) aplicável às cópias de segurança associadas a este plano de cópia de segurança.
- effective_date_for_enforced_retention_lock: A data de entrada em vigor precisa do bloqueio de retenção aplicado.
lock_on_enforced_retention: um indicador que mostra se a retenção está num estado bloqueado. Este campo é gerado dinamicamente com base na lógica subsequente:
- Se a data/hora
effective_date_for_enforced_retention_lockestiver presente e corresponder à hora atual ou a uma hora anterior, o valor é designado como "bloqueado". - Se esta condição não for cumprida, o valor é designado como "desbloqueado".
- Se a data/hora
Consultas de exemplo
Para ver os registos selecionados, pode escrever consultas personalizadas na secção de consultas.
Use a seguinte consulta para ver os planos de cópia de segurança associados a um plano de cópia de segurança específico:
logName:"bdr_backup_plan_details" jsonPayload.backupPlanName:"projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUPPLAN_NAME"
Use a seguinte consulta para ver os planos de cópia de segurança associados a um cofre de cópias de segurança específico:
logName:"bdr_backup_plan_details" jsonPayload.backupVaultName:"projects/PROJECT_ID/locations/LOCATION/backupVaults/BACKUPVAULT_NAME"
Use a seguinte consulta para ver planos de cópia de segurança que contêm um nome de regra específico:
logName:"bdr_backup_plan_details" jsonPayload.backupRuleDetails.ruleName:"RULE_NAME
O que se segue?
- Para configurar alertas baseados em registos para o serviço de cópia de segurança e recuperação de desastres, crie uma consulta de registos, usando o filtro de registos de tarefas e, de seguida, configure alertas baseados em registos.