Registros de eventos de backup e DR

Esta página explica como visualizar os registros de eventos criados no dispositivo de backup/recuperação no Cloud Logging. Os registros de eventos fornecem insights sobre o dispositivo de backup/recuperação, como eventos ou erros do sistema.

Permissões e papéis

As permissões e os papéis do IAM determinam se você pode acessar os dados dos registros de eventos do serviço de backup e DR.

Você precisa da permissão roles/logging.viewer para acessar os registros de eventos. O papel de Visualizador de registros concede acesso somente leitura para visualizar registros de eventos de todos os appliances de backup/recuperação no projeto especificado. Para mais informações sobre as permissões e os papéis do IAM que se aplicam aos dados de registros de eventos, consulte Controle de acesso com IAM.

Conferir os registros de eventos

É possível conferir os logs de eventos de backup e DR no Cloud Logging usando o console do Google Cloud e a CLI do Google Cloud .

Console

No console do Google Cloud , é possível usar o Análise de registros para recuperar as entradas de registro de eventos de backup e DR dos seus dispositivos de backup/recuperação:

  1. No console do Google Cloud , acesse Gerar registros > Explorador de registros.
  2. Selecione um projeto do Cloud existente.

  3. No painel Criador de consultas, siga estas etapas:

    1. No menu suspenso Recurso, selecione o Dispositivo de recuperação de backup.
    2. No menu suspenso Selecionar nome do registro, selecione backup_recovery_appliance_events para conferir os registros de eventos de aparelhos de backup/recuperação.

gcloud

A CLI do Google Cloud fornece uma interface de linha de comando para a API Logging. Insira um identificador de recurso válido em cada um dos nomes de registro. Para ler as entradas do registro de eventos de dispositivos de backup/recuperação em um projeto, execute o seguinte comando:

```gcloud
gcloud logging read "logName : projects/PROJECT_ID/logs/backup_recovery_appliance_events"\
 --project=PROJECT_ID
 ```

API

Para conferir as entradas de registro de auditoria dos dispositivos de backup/recuperação em um projeto, faça o seguinte:

  1. Acesse a seção Testar esta API na documentação do método entries.list.

  2. Digite o seguinte na parte do Corpo da solicitação do formulário Teste esta API. Clique nesse formulário preenchido automaticamente para preencher automaticamente o corpo da solicitação, mas é necessário fornecer um PROJECT_ID válido em cada um dos campos de nome de registro.

    ```API
{
  "resourceNames": [
    "projects/PROJECT_ID"
  ],
  "pageSize": 5,
  "filter": "logName : projects/PROJECT_ID/logs/backupdr_audit_log"
}
```

  3. Clique em Executar.

Formato do registro de eventos

As entradas de registro de eventos de backup e DR incluem os seguintes campos:

  • appName: esse campo mostra o nome do aplicativo associado ao evento.
  • srcid: esse campo mostra um ID exclusivo do evento que ocorre no appliance de backup/recuperação.
  • jobName: esse campo mostra o nome da atividade associada ao evento.
  • appType: esse campo mostra o tipo do aplicativo associado ao evento.
  • eventId: esse campo mostra um ID exclusivo associado ao erro.
  • Componente: esse campo mostra a origem do evento.
  • eventTime: esse campo mostra o horário em que o evento foi informado.
  • errorMessage: esse campo descreve o erro detalhado associado ao evento.

O exemplo a seguir é uma entrada de registro registrada em um dispositivo de backup/recuperação ba-1-52973 para um job de snapshot com falha.

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

Amostras de consultas

Você pode escrever consultas de eventos personalizados na seção de consulta para conferir os registros de eventos que você quer.

Use a consulta a seguir para conferir todos os logs de eventos associados a aparelhos de backup/recuperação de um determinado PROJECT_ID:

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"

Se você estiver procurando registros de eventos de um dispositivo de backup/recuperação específico, adicione o seguinte nome do dispositivo:

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    resource.labels.backup_recovery_appliance_id= "backup/recovery appliance name"

Se você estiver procurando logs de eventos para um ID de evento específico, use a consulta de registro abaixo. Use AND em letras maiúsculas.

    logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
    AND jsonPayload.eventId = event ID

Se você estiver procurando logs de eventos para vários IDs de evento específicos, use a consulta de registro abaixo. Use AND e OR em letras maiú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)

Se você estiver procurando logs de eventos e quiser excluir IDs de eventos específicos, use a consulta de registro abaixo. Use letras maiúsculas para AND NOT e OR.

    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)

Se você estiver procurando logs de eventos para um aplicativo específico, use a consulta de registro abaixo. Use letras maiúsculas AND.

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

A seguir