Wie Ereignisse von IBM Cloud Backup for VPC gesammelt und gesendet werden

Sicherungsaufträge erfüllen 2 Arten von Aufgaben. Ein Task ist für die planmäßige Erstellung der Backup-Snapshots zuständig, der andere Task verwaltet die vorhandenen Backups und wendet die Aufbewahrungsregel auf die Backups an. Wenn ein Sicherungsauftrag fehlschlägt, kommuniziert IBM Cloud Backup for VPC mit einer verbundenen Event Notifications-Instanz, um eine Benachrichtigung an ein unterstütztes Ziel weiterzuleiten.

Ereignisse für IBM Cloud Backup for VPC

In der folgenden Tabelle sind die IBM Cloud Backup for VPC-Ereignisse aufgeführt.

Wenn Sie diese Warnungen sehen, können Sie die API oder CLI verwenden, um den Grund für den fehlgeschlagenen Status zu bestätigen.

Weitere Informationen zur Behebung des Problems finden Sie unter Fehlerbehebung bei Backup für VPC.

Benachrichtigungen aktivieren

Ereignisse, die von einer Instanz des Dienstes „ IBM Cloud Backup for VPC “ generiert werden, können an eine Instanz des Dienstes „ Event Notifications “ weitergeleitet werden, die im selben Konto verfügbar ist. Sie können pro „ Event Notifications “-Dienstinstanz nur eine Backup-Dienstquelle konfigurieren.

Wenn eine IAM-Berechtigung zwischen IBM Cloud Backup for VPC und Event Notifications in Ihrem Konto noch nicht vorhanden ist, erstellen Sie eine mit der Rolle Event Source Manager. Weitere Informationen finden Sie unter Einrichten von Dienst-zu-Dienst-Berechtigungen.

Bevor Sie Benachrichtigungen für IBM Cloud Backup for VPC aktivieren können, müssen Sie sicherstellen, dass Sie eine Event Notifications Service-Instanz haben, die sich im selben Konto befindet wie Ihre IBM Cloud Backup for VPC-Instanz.

Anschließend können Sie den Abschnitt „Aktionen > Ereignisbenachrichtigungen“ auf der Detailseite der Richtlinie „ IBM Cloud Backup “ nutzen, um die Dienste miteinander zu verknüpfen.

Anschließend können Sie programmgesteuert eine Verbindung zu „ Event Notifications “ herstellen, indem Sie die Event-Notification-API aufrufen.

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
}

Benachrichtigungen an ausgewählte Ziele zustellen

Nachdem Sie die Benachrichtigungen für IBM Cloud Backup for VPC aktiviert haben, erstellen Sie Themen und Abonnements unter Event Notifications, damit die Benachrichtigungen weitergeleitet und an die von Ihnen ausgewählten Ziele übermittelt werden können.

Eine vollständige Liste der unterstützten Ziele finden Sie in der Event Notifications-Dokumentation.

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

Details der Benachrichtigungsnutzdaten

Erfolgreiche Ereignisse, die von IBM Cloud Backup for VPC generiert werden, enthalten verschiedene Felder, anhand derer Sie die Quelle und die Details eines Ereignisses identifizieren können.

Ereignisbenachrichtigungen von IBM Cloud Backup for VPC enthalten ausschließlich Metadaten-Eigenschaften, wie beispielsweise Namen oder Identifikatoren von Ressourcen. Sensible Daten wie API-Schlüssel oder Kennwörter werden nicht in generierte Ereignisse eingeschlossen.

Die an Event Notifications übermittelten Eigenschaften variieren je nach Ereignistyp. Wenn beispielsweise ein Backup job creation failed-Ereignis eintritt, sendet IBM Cloud Backup for VPC eine Benachrichtigungs-Nutzlast an Event Notifications, die dem folgenden Beispiel ähnelt.

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