Diese Seite wurde von der Cloud Translation API übersetzt.

Logbasierte Benachrichtigung für im Safe gespeicherte Ressourcen konfigurieren

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

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

Geben Sie einen Namen und eine Beschreibung für die Benachrichtigung ein.
Wählen Sie die Protokolle aus, für die Sie eine Benachrichtigung erhalten möchten.
Legen Sie das Zeitintervall zwischen den 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 SCHEDULED_BACKUP, ON_DEMAND_BACKUP und RESTORE konfigurieren. Sie können auch Benachrichtigungen für den Jobstatus festlegen: SUCCESSFUL, FAILED, SKIPPED und RUNNING.

Sie können einen oder mehrere Benachrichtigungskanäle wie Google Chat, E-Mail, SMS oder Chatprogrammkanäle konfigurieren, um Benachrichtigungen zu erhalten, wenn eine Warnung auftritt. Eine Anleitung dazu finden Sie unter Benachrichtigungskanäle erstellen und verwalten.

Hinweise

Berechtigungen für logbasierte Benachrichtigungsrichtlinien zuweisen

Logbasierte Benachrichtigung erstellen

Wenn Sie eine Benachrichtigung erhalten möchten, benötigen Sie einen Benachrichtigungskanal. Sie können den Benachrichtigungskanal vor oder während der Erstellung einer Benachrichtigung erstellen.

So erstellen Sie eine logbasierte Benachrichtigung:

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

Zum Log-Explorer
Legen Sie im Bereich Abfrage die Benachrichtigung fest, über die Sie benachrichtigt werden möchten.

Die folgende Abfrage ist ein Beispiel dafür, wie Sie benachrichtigt werden, wenn ein geplanter Sicherungsjob fehlschlägt.
```
  logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs"
  jsonPayload.jobCategory="SCHEDULED_BACKUP"
  jsonPayload.jobStatus="FAILED"
```
Ersetzen Sie Folgendes:
- PROJECT_ID: der Name des Projekts.
Klicken Sie in der Kopfzeile des Bereichs Abfrageergebnisse auf Benachrichtigung erstellen.
Führen Sie im Abschnitt Benachrichtigungsdetails folgende Schritte aus:
1. Geben Sie im Feld Name der Benachrichtigungsrichtlinie einen Namen für die Benachrichtigung ein. Dieser Name wird im Benachrichtigungsheader angezeigt.
2. Geben Sie im Feld Dokumentation die Beschreibung der Benachrichtigung ein. Informationen zum Formatieren und Optimieren des Inhalts dieses Felds finden Sie unter Markdown und Variablen in Dokumentationsvorlagen verwenden.
Klicken Sie auf Weiter.
Führen Sie im Bereich Logs auswählen, die in die Benachrichtigung aufgenommen werden sollen die folgenden Schritte aus:
1. Klicken Sie auf Logvorschau ansehen, um die Abfrage und die Ergebnisse zu prüfen. Bei Bedarf können Sie die Abfrage 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 Logfeldname einen Logfeldnamen 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, der genau eine reguläre Ausdrucksgruppe enthalten muss.
Klicken Sie auf Weiter.
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 Mindestdauer zwischen Benachrichtigungen aus. Mit diesem Wert können Sie die Anzahl der Benachrichtigungen dieser Art steuern, 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.
Klicken Sie auf Weiter.
Wählen Sie in der Liste Benachrichtigungskanäle einen oder mehrere Benachrichtigungskanäle für Ihre Benachrichtigung aus. Wenn Sie noch keinen Benachrichtigungskanal konfiguriert haben, klicken Sie auf Benachrichtigungskanäle verwalten, um einen zu erstellen. Eine Anleitung dazu finden Sie unter Benachrichtigungskanäle erstellen und verwalten.
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.

Folgen Sie der Anleitung unten, um den Logeintrag zu schreiben.

Rufen Sie die Referenzseite logEntries.write auf.

Zu „logEntries.write“

Konfigurieren Sie den folgenden Logeintrag, indem Sie die Variable PROJECT_ID 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.

Kopieren Sie den zuvor konfigurierten Logeintrag.
Führen Sie im Bereich API testen folgende Schritte aus:
1. Ersetzen Sie im Feld Request body (Anfragetext) den Inhalt durch den Logeintrag, den Sie im vorherigen Schritt kopiert haben.
2. Klicken Sie auf Ausführen. Folgen Sie dem Authentifizierungsablauf, wenn Sie dazu aufgefordert werden.
Wenn der Aufruf logEntries.write erfolgreich ist, erhalten Sie einen HTTP 200-Antwortcode 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 logName-Wert gibt die Sicherungs- oder Wiederherstellungsjob-Logs in Ihrem Cloud-Projekt an.
- Der jsonPayload enthält die fehlgeschlagene Jobkategorie SCHEDULED_BACKUP, was darauf hinweist, dass das Protokoll sich auf eine Sicherung bezieht, die von einem Sicherungsplan geplant wurde.
- Das Feld jsonPayload enthält den Jobstatus FAILED, was bedeutet, dass der Job fehlgeschlagen ist.
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. Ein Vorfall wird auf der Seite Cloud Monitoring 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 der Bestätigung und Schließung, finden Sie unter Vorfälle für logbasierte Benachrichtigungen verwalten.