Como os eventos são coletados e enviados pelo IBM Cloud Backup for VPC

Os trabalhos de backup cumprem dois tipos de tarefas. Uma tarefa é responsável por tirar os instantâneos de backup conforme programado, a outra tarefa gerencia os backups existentes e aplica a regra de retenção nos backups. Se um trabalho de backup falhar, o IBM Cloud Backup for VPC se comunica com uma instância conectada do Event Notifications para encaminhar uma notificação a um destino suportado.

Eventos para IBM Cloud Backup for VPC

A tabela a seguir lista os eventos do IBM Cloud Backup for VPC.

Ao ver esses alertas, você pode usar a API ou CLI para confirmar o motivo do status de falha.

Para obter mais informações sobre como resolver o problema, consulte Solução de problemas do Backup para VPC.

Ativando notificações

Os eventos gerados por uma instância do serviço “ IBM Cloud Backup for VPC ” podem ser encaminhados para uma instância do serviço “ Event Notifications ” disponível na mesma conta. É possível configurar apenas uma fonte do serviço de backup para uma instância do serviço “ Event Notifications ”.

Se uma autorização de IAM entre IBM Cloud Backup for VPC e Event Notifications ainda não existir em sua conta, crie uma com a função Event Source Manager. Para obter mais informações, consulte Estabelecimento de autorizações de serviço para serviço.

Antes de ativar as notificações para o IBM Cloud Backup for VPC, certifique-se de que você tenha uma instância de serviço Event Notifications que esteja na mesma conta que a sua instância do IBM Cloud Backup for VPC.

Em seguida, você pode usar a seção Ações > Notificações de eventos na página de detalhes da política “ IBM Cloud Backup ” para conectar os serviços.

Então, você pode se conectar ao Event Notifications programaticamente, chamando a API de Notificação de Eventos.

ibmcloud event-notifications sources-create --instance-id INSTANCE-ID --name NAME --source BACKUP POLICY CRN --description DESCRIPTION [--enabled ENABLED]

curl -X POST "{base_url}/v1/instances/{instance_id}/sources"
    -H "Authorization: Bearer {iam_token}"
    -H "Content-Type: application/json"
    -d '{
      "name":"Event Notification Source - Backup policy",
      "source" : "crn:v1:bluemix:public:is:us-south:a/{{account_id}}::backup-policy:",
      "description":"Backup policy service registration. This source provides notifications for backup job failures.",
      "enabled":true,
      "event_notifications_instance_crn": "crn:v1:bluemix:public:event-notifications:<region>:a/<account-id>:<service-instance>::"
      }'

resource "ibm_en_source" "en_source" {
  instance_guid = ibm_resource_instance.en_terraform_test_resource.guid
  name          = "EN Source for Backup jobs"
  source        = "crn:v1:bluemix:public:is:us-south:a/{{account_id}}::backup-policy:"
  description   = "API source for Event notification destinations"
  enabled       = true
}

Entregando notificações para destinos selecionados

Depois de ativar as notificações no IBM Cloud Backup for VPC, crie tópicos e assinaturas no Event Notifications para que os alertas possam ser encaminhados e entregues aos destinos selecionados.

Para obter uma lista completa de destinos suportados, consulte a Documentação do Event Notifications.

Email Title: Volume Backup Job Creation Failure

Email Body:

Volume Backup Job Creation Failure. Resource: crn:v1:bluemix:public:is:us-south-1:a/be09dae34250437f96fc8b27ae7d233b::volume:r006-f6583aac-8ba9-4d04-ab7a-acfe7b420016. BackupJobID: r006-899ab8fb-3b71-4fc8-bca5-1544cb425e4f. Reason: Snapshot quota per volume reached.

Notification details:

 {
        "backup_policy": "r006-306fd8f6-b14c-410d-8f29-f05282b6daa9",
        "backup_policy_job": "r006-899ab8fb-3b71-4fc8-bca5-1544cb425e4f",
        "backup_policy_plan": "r006-444bb07f-3399-42d5-b895-febcaca8d1bc",
        "match_resource_type" : "volume",
        "job_type" : "creation",
        "reasons": [
          {
            "more_info": "https://cloud.ibm.com/docs/vpc?topic=vpc-troubleshooting-backup-for-vpc",
            "status": "source_volume_too_large"
          }
        ],
        "resource": "crn:v1:bluemix:public:is:us-south-1:a/be09dae34250437f96fc8b27ae7d233b::volume:r006-f6583aac-8ba9-4d04-ab7a-acfe7b420016"
 }

Detalhes da carga útil de notificação

Os eventos bem-sucedidos gerados pelo IBM Cloud Backup for VPC contêm vários campos que ajudam a identificar a origem e os detalhes de um evento.

As notificações de eventos do IBM Cloud Backup for VPC contêm apenas propriedades de metadados, como nomes ou identificadores de recursos. Os dados sensíveis, por exemplo, chaves de API ou senhas, não são incluídos nos eventos gerados.

As propriedades enviadas para Event Notifications variam de acordo com o tipo de evento. Por exemplo, se um evento Backup job creation failed ocorrer, o IBM Cloud Backup for VPC enviará uma carga de notificação para Event Notifications semelhante ao exemplo a seguir.

{
  "ibmendefaultlong": "{\"status\":\"Backup job creation / retention failed\",
                        \"backup_policy\": r006-6da51cfe-6f7b-4638-a6ba-00e9c327b178,
                        \"backup_policy_plan\":\"r006-076191ba-49c2-4763-94fd-c70de73ee2e6\",
                        \"status_reason\": \"source_volume_busy: The source volume has busy set (after multiple retries)\",
                        \"match_resource_type\": \"instance\",
                        \"job_type\": \"creation\",
                        \"more_info\": \"https://cloud.ibm.com/docs/vpc?topic=vpc-baas-troubleshoot\"}",
  "ibmendefaultshort": "Backup Job creation / retention failed",
  "id": "b2198eb8-04b1-48ec-a78c-ee87694dd845",
  "time": "2024-04-22T20:59:34Z",
  "ibmenseverity": "medium",
  "type": "com.ibm.cloud.is.backup-policy.backup-volume-creation",
  "source": "com.ibm.cloud.is.backup-policy",
  "specversion": "1.0",
  "ibmensourceid": "41cdb7d4-db3e-496b-b7df-d4ead362c412:api"
}