Logbasierte Benachrichtigung für im Safe gespeicherte Ressourcen konfigurieren

Auf dieser Seite wird erklärt, wie Sie auf der Seite Log-Explorer in der Google Cloud Console eine logbasierte Benachrichtigung für gesicherte Ressourcen konfigurieren.

Auf der Seite Log-Explorer werden Sie durch die folgenden Schritte zum Erstellen und Bearbeiten logbasierter Benachrichtigungen geführt:

  • Geben Sie einen Namen und eine Beschreibung für die Benachrichtigung ein.
  • Wählen Sie die Logs aus, für die Sie eine Benachrichtigung erhalten möchten.
  • Legen Sie das Zeitintervall zwischen Benachrichtigungen fest.
  • Legen Sie die Zeit für das automatische Schließen von Vorfällen fest.
  • Geben Sie an, wer benachrichtigt werden soll.

Sie können Benachrichtigungen für die Jobkategorien für Sicherungs- und Wiederherstellungsjobs konfigurieren: SCHEDULED_BACKUP, ON_DEMAND_BACKUP und RESTORE.

Sie können auch Benachrichtigungen für die Jobkategorien für Sicherungspläne und Sicherungsplanzuordnungen konfigurieren: UPDATE.

Die verfügbaren Jobstatus sind: SUCCESSFUL, FAILED, SKIPPED und RUNNING.

Sie können einen oder mehrere Benachrichtigungskanäle konfigurieren, z. B. Google Chat, E‑Mail, SMS oder Chatprogrammkanäle, um Benachrichtigungen zu erhalten, wenn eine Benachrichtigung ausgelöst wird. Eine Anleitung finden Sie unter siehe Benachrichtigungskanäle erstellen und verwalten.

Hinweis

Logbasierte Benachrichtigung erstellen

Um eine Benachrichtigung zu erhalten, benötigen Sie einen Benachrichtigungskanal. Sie können den Benachrichtigungskanal vor oder während des Erstellens einer Benachrichtigung erstellen.

So erstellen Sie eine logbasierte Benachrichtigung:

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

  2. Definieren Sie im Bereich Abfrage die Benachrichtigung, für die Sie benachrichtigt werden möchten.

    • Die folgende Abfrage ist ein Beispiel, um benachrichtigt zu werden, wenn ein geplanter Sicherungsjob fehlschlägt.

      logName="projects/PROJECT_ID/logs/backupdr.googleapis.com/LOG_NAME"
jsonPayload.jobCategory="SCHEDULED_BACKUP"
jsonPayload.jobStatus="FAILED"

      Ersetzen Sie Folgendes:

      • PROJECT_ID: der Name des Projekts.

      • LOG_NAME: der Name des Logs, entweder:

        • bdr_backup_plan_jobs: Jobs im Zusammenhang mit einem Sicherungsplan
        • bdr_backup_plan_association_jobs: Jobs im Zusammenhang mit der Sicherungsplanzuordnung im Administratorprojekt bei projektübergreifendem Schutz.
        • bdr_backup_plan_association_source_jobs: Jobs im Zusammenhang mit der Sicherungsplanzuordnung im Workload-Projekt.

  3. Klicken Sie in der Kopfzeile des Bereichs Abfrageergebnisse auf Benachrichtigung erstellen.

  4. Gehen Sie im Abschnitt Benachrichtigungsdetails so vor:

    1. Geben Sie im Feld Name der Benachrichtigungsrichtlinie einen Namen für die Benachrichtigung ein. Dieser Name wird in der Benachrichtigungsüberschrift angezeigt.
    2. Geben Sie im Feld Dokumentation die Beschreibung für die Benachrichtigung ein. Informationen zum Formatieren und Optimieren des Inhalts dieses Felds finden Sie unter Markdown und Variablen in Dokumentationsvorlagen verwenden.

  5. Klicken Sie auf Weiter.

  6. Gehen Sie im Abschnitt Logs für diese Benachrichtigung auswählen so vor:

    1. Klicken Sie auf Vorschau der Logs, um die Abfrage und die Ergebnisse zu prüfen. Sie können die Abfrage bei Bedarf auch in diesem Bereich bearbeiten.

    2. Klicken Sie auf Label hinzufügen und gehen Sie so vor. Mit den Labels können Sie Benachrichtigungen anpassen und informativer gestalten.

      1. Geben Sie im Feld Anzeigename einen Namen für das Label ein.
      2. Wählen Sie in der Liste Name des Logfelds einen Namen für das Logfeld aus. Diese Felder werden basierend auf dem ausgewählten Abfrageergebnis angezeigt.
      3. Geben Sie im Feld Regulärer Ausdruck einen Ausdruck ein, um einen Wert aus dem Feld zu extrahieren, das genau eine Gruppe für reguläre Ausdrücke enthalten muss.

  7. Klicken Sie auf Weiter.

  8. Führen Sie im Abschnitt Benachrichtigungshäufigkeit und Dauer für automatisches Schließen festlegen die folgenden Schritte aus:

    1. Wählen Sie in der Liste Zeit zwischen Benachrichtigungen die Mindestzeit zwischen Benachrichtigungen aus. Mit diesem Wert können Sie die Anzahl der Benachrichtigungen steuern, die Sie von dieser Benachrichtigung erhalten, wenn sie mehrmals ausgelöst wird.
    2. Wählen Sie in der Liste Dauer bis zur automatischen Schließung von Vorfällen eine Dauer aus, nach der der Vorfall automatisch geschlossen wird, wenn entsprechende Logeinträge fehlen.

  9. Klicken Sie auf Weiter.

  10. Wählen Sie in der Liste Benachrichtigungskanäle einen oder mehrere Benachrichtigungskanäle für die Benachrichtigung aus. Wenn Sie keinen Benachrichtigungskanal konfiguriert haben, klicken Sie auf Benachrichtigungskanäle verwalten , um einen zu erstellen. Eine Anleitung finden Sie unter siehe Benachrichtigungskanäle erstellen und verwalten.

  11. Klicken Sie auf Speichern.

Logbasierte Benachrichtigung testen

Zum Testen der von Ihnen erstellten logbasierten Benachrichtigung können Sie manuell einen Logeintrag schreiben, der mit der Abfrage übereinstimmt.

So schreiben Sie den Logeintrag:

  1. Rufen Sie die logEntries.write Referenzseite auf.

    Zu „logEntries.write“

  2. Konfigurieren Sie den folgenden Logeintrag, indem Sie die PROJECT_ID Variable in Ihre Projekt-ID ändern.

          {
        "entries": [
          {
            "jsonPayload": {
              "jobCategory": "SCHEDULED_BACKUP",
              "jobStatus": "FAILED"
            }
          }
        ],
        "resource": {
          "type": "backupdr.googleapis.com/BackupDRProject"
        },
        "logName": "projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs"
      }

    Ersetzen Sie Folgendes:

    • PROJECT_ID: der Name des Projekts.

  3. Kopieren Sie den zuvor konfigurierten Logeintrag.

  4. Führen Sie im Bereich API testen die folgenden Schritte aus:

    1. Ersetzen Sie im Feld Anfragetext den Inhalt durch den Logeintrag, den Sie im vorherigen Schritt kopiert haben.
    2. Klicken Sie auf Ausführen. Folgen Sie der Anleitung zur Authentifizierung, wenn Sie dazu aufgefordert werden.

  5. Wenn der Aufruf logEntries.write erfolgreich ist, erhalten Sie einen HTTP-Antwortcode 200 und einen leeren Antworttext: {}. Weitere Informationen zum APIs Explorer finden Sie unter APIs Explorer verwenden.

    Der Logeintrag stimmt mit dem für die Benachrichtigung angegebenen Filter auf folgende Weise überein:

    • Der Wert logName gibt die Logs für Sicherungs- oder Wiederherstellungsjobs in Ihrem Cloud-Projekt an.
    • Das Feld jsonPayload enthält die Kategorie für fehlgeschlagene Jobs SCHEDULED_BACKUP, die angibt, dass sich das Log auf eine Sicherung bezieht, die von einem Sicherungsplan geplant wurde.
    • Das Feld jsonPayload enthält den Jobstatus FAILED, der angibt, dass der Job fehlgeschlagen ist.

  6. Nach dem Schreiben des Logeintrags tritt die folgende Sequenz auf:

    1. Der neue Logeintrag wird im Log-Explorer angezeigt und löst die Benachrichtigung aus.
    2. Auf der Seite Cloud Monitoring wird ein Vorfall geöffnet.

    3. Sie erhalten dann eine Benachrichtigung für den Vorfall. Wenn Sie einen E‑Mail-Benachrichtigungskanal konfiguriert haben, wird die Benachrichtigung angezeigt.

      Sie können in der E‑Mail auf Vorfall ansehen klicken, um den Vorfall auf der Seite Cloud Monitoring aufzurufen. Weitere Informationen zu Vorfällen, einschließlich des Bestätigens und Schließens von Vorfällen, finden Sie unter Vorfälle für logbasierte Benachrichtigungen verwalten.