Benachrichtigungen für logbasierte Benachrichtigungsrichtlinien verwalten

Eine Benachrichtigung ist ein Eintrag, der angibt, wann die Bedingung einer Benachrichtigungsrichtlinie erfüllt ist. Normalerweise erstellt Cloud Monitoring eine Benachrichtigung und sendet eine Benachrichtigung, wenn ein Log empfangen wird, das der Bedingung Ihrer Benachrichtigungsrichtlinie entspricht. Unter den folgenden Umständen werden jedoch keine Benachrichtigungen erstellt:

  • Die Richtlinie ist pausiert oder deaktiviert.
  • Die Anzahl der Benachrichtigungsrichtlinien oder Benachrichtigungen überschreitet die vorhandenen Benachrichtigungslimits.
  • Ein anderer Logeintrag führt dazu, dass dieselbe Bedingung für eine offene Benachrichtigung erfüllt wird. In diesem Fall sendet Monitoring nur eine weitere Benachrichtigung für dieselbe Benachrichtigung.

Für jede Benachrichtigung wird in Monitoring eine Seite mit Benachrichtigungsdetails erstellt, auf der Sie die Benachrichtigung verwalten können. Außerdem werden dort Informationen zur Benachrichtigung angezeigt, die Ihnen bei der Fehlerbehebung helfen können. Auf der Seite Benachrichtigungsdetails wird beispielsweise eine Liste der Logeinträge angezeigt, die mit der Abfrage der logbasierten Benachrichtigungsrichtlinie übereinstimmen. Außerdem finden Sie dort Links zu zugehörigen Benachrichtigungen.

In diesem Dokument wird beschrieben, wie Sie Ihre Benachrichtigungen finden. Außerdem wird beschrieben, wie Sie auf der Seite Benachrichtigungsdetails Benachrichtigungen für logbasierte Benachrichtigungsrichtlinien verwalten können, die Logeinträge auswerten, die in einzelnen Logs in Cloud Logging gespeichert sind.

Diese Funktion wird nur für Google Cloud -Projekte unterstützt. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

Hinweis

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Aufrufen und Verwalten von Benachrichtigungen haben:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Weitere Informationen zu Cloud Monitoring-Rollen finden Sie unter Zugriff mit Identity and Access Management steuern.

Benachrichtigungen ansehen

Verwenden Sie die Google Cloud Console, die gcloud CLI oder die Monitoring API, um Benachrichtigungen in Ihrem Projekt aufzurufen.

Google Cloud Console

So rufen Sie eine Liste der Benachrichtigungen in Ihrem Google Cloud Projekt auf:

  1. Rufen Sie in der Google Cloud Console die Seite  Benachrichtigungen auf:

    Zu Benachrichtigungen

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie in der Symbolleiste der Google Cloud Console Ihr Google Cloud -Projekt aus. Wählen Sie für App Hub-Konfigurationen das App Hub-Hostprojekt oder das Verwaltungsprojekt aus.

    Auf der Seite Benachrichtigungen werden Informationen zu Ihren Benachrichtigungsrichtlinien, Pausen und Benachrichtigungen angezeigt:

    • Im Bereich Zusammenfassung wird die Anzahl der offenen Benachrichtigungen aufgeführt.
    • In der Tabelle Benachrichtigungen werden die neuesten offenen Benachrichtigungen angezeigt. Wenn Sie die neuesten Benachrichtigungen in der Tabelle auflisten möchten, einschließlich der geschlossenen, klicken Sie auf Geschlossene Benachrichtigungen einblenden.

  3. Wenn Sie die Details einer bestimmten Benachrichtigung aufrufen möchten, wählen Sie sie in der Liste aus.

    Die Seite Benachrichtigungsdetails wird geöffnet. Weitere Informationen zur Seite Benachrichtigungsdetails finden Sie im Abschnitt Benachrichtigung untersuchen in diesem Dokument.

Ältere Benachrichtigungen finden

In der Tabelle Benachrichtigungen auf der Seite Benachrichtigungen werden die jüngsten offenen Benachrichtigungen angezeigt. So rufen Sie ältere Benachrichtigungen auf:

  • Klicken Sie auf  Neuer oder  Älter, um die Einträge in der Tabelle Benachrichtigungen durchzugehen.

  • Wenn Sie eine Seite öffnen möchten, auf der Sie Ihre Benachrichtigungen auflisten und filtern können, klicken Sie auf Alle Benachrichtigungen ansehen. Die Seite Benachrichtigungen wird geöffnet. Gehen Sie auf dieser Seite so vor:

    • Alle Benachrichtigungen anzeigen, einschließlich geschlossener Benachrichtigungen. Wenn Sie alle Benachrichtigungen sehen möchten, klicken Sie auf Geschlossene Benachrichtigungen einblenden.
    • Benachrichtigungen filtern Informationen zum Hinzufügen von Filtern finden Sie unter Benachrichtigungen filtern.
    • Bestätigen oder schließen Sie eine Benachrichtigung oder aktivieren Sie die Schlummerfunktion für die zugehörige Benachrichtigungsrichtlinie. Klicken Sie in der Zeile der Benachrichtigung auf  Weitere Optionen und treffen Sie im Menü eine Auswahl. Weitere Informationen finden Sie unter Benachrichtigungen verwalten.

Benachrichtigungen filtern

Wenn Sie die in der Tabelle angezeigten Benachrichtigungen einschränken möchten, fügen Sie Filter hinzu. Wenn Sie mehrere Filter hinzufügen, werden in der Tabelle nur Benachrichtigungen angezeigt, die alle Filter erfüllen.

So filtern Sie die Tabelle mit Benachrichtigungen:

  1. Klicken Sie auf der Seite Benachrichtigungen auf  Tabelle filtern und wählen Sie ein Filterattribut aus. Zu den Filterattributen gehören:

    • Status der Benachrichtigung
    • Name der Benachrichtigungsrichtlinie
    • Wann die Benachrichtigung geöffnet oder geschlossen wurde

  2. Wählen Sie einen Wert aus dem sekundären Menü aus oder geben Sie einen Wert in die Filterleiste ein.

    Der Filter wird dann in der Tabelle Benachrichtigungen aufgeführt.

gcloud

Sie können mit gcloud Benachrichtigungen erhalten und Benachrichtigungen auflisten.

Benachrichtigung erhalten

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • ALERT_NAME: Der Ressourcenname der Benachrichtigung. Beispiel: projects/my-project/alerts/my-alert-id.

Führen Sie den Befehl gcloud alpha monitoring alerts describe aus:

Linux, macOS oder Cloud Shell

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (PowerShell)

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (cmd.exe)

gcloud alpha monitoring alerts describe ALERT_NAME
 Der Befehl gibt eine Antwort mit Benachrichtigungsdetails wie Benachrichtigungsstatus, angehängten Labels und der Quellbenachrichtigungsrichtlinie zurück. Die Antwort sieht ungefähr so aus: 
{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "cluster_name": "example_cluster",
      "project_id": "my-project"
    }
  },
  "log": {
    "extracted_labels": {
      "title": "my title"
    }
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}

Benachrichtigungen auflisten

Mit der gcloud CLI können Sie Warnungen in Ihrem Projekt auflisten und die Ergebnisse filtern.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • PROJECT_ID: Die Kennung des Projekts.

Führen Sie den Befehl gcloud alpha monitoring alerts list aus:

Linux, macOS oder Cloud Shell

gcloud alpha monitoring alerts list

Windows (PowerShell)

gcloud alpha monitoring alerts list

Windows (cmd.exe)

gcloud alpha monitoring alerts list
 Der Befehl gibt eine Antwort mit Benachrichtigungsdetails wie Benachrichtigungsstatus, angehängten Labels und der Quellbenachrichtigungsrichtlinie zurück. Die Antwort sieht ungefähr so aus: 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "k8s_cluster",
        "labels": {
          "location": "us-central1",
          "cluster_name": "example_cluster",
          "project_id": "my-project"
        }
      },
      "log": {
        "extracted_labels": {
          "title": "my title"
        }
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
    }
  ]
}
Sie können auch die folgenden optionalen Flags verwenden, um die Ausgabe zu filtern, zu sortieren oder zu ändern:

  • --filter: Geben Sie einen Filterausdruck an, um Benachrichtigungen nach Zeit oder Label zu filtern. Filtern Sie beispielsweise nach Zeit mit --filter='close_time>="2025-09-10T00:00:00Z"' oder nach Label mit --filter='resource.labels.key="value"'.

  • --sort-by: Eine durch Kommas getrennte Liste von Feldern, nach denen die Ausgabe sortiert werden soll. Beispiel: --sort-by=open_time.

  • --uri: Mit dem Befehl wird anstelle der Standardausgabe eine Liste von Ressourcen-URIs ausgegeben.

  • --limit: Setzen Sie dieses Flag auf 2 oder höher, um die Anzahl der zurückgegebenen Benachrichtigungen zu begrenzen. Verwenden Sie dieses Flag nicht in Verbindung mit dem Flag --filter.

Monitoring API

Mit der Monitoring API können Sie Benachrichtigungen abrufen und auflisten.

Benachrichtigung erhalten

Wenn Sie Details zu einer einzelnen Benachrichtigung mit der Monitoring API abrufen möchten, verwenden Sie die Methode alerts.get.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Die Kennung des Projekts.
  • ALERT_ID: Die ID der Benachrichtigung.

HTTP-Methode und URL: 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Der Befehl gibt eine Antwort mit Benachrichtigungsdetails wie Benachrichtigungsstatus, angehängten Labels und der Quellbenachrichtigungsrichtlinie zurück. Die Antwort sieht in etwa so aus: 
{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "cluster_name": "example_cluster",
      "project_id": "my-project"
    }
  },
  "log": {
    "extracted_labels": {
      "title": "my title"
    }
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}

Benachrichtigungen auflisten

Verwenden Sie die Methode alerts.list, um Benachrichtigungen in Ihrem Projekt aufzulisten und die Ergebnisse mit der Monitoring API zu filtern.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Die Kennung des Projekts.

HTTP-Methode und URL: 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Der Befehl gibt eine Antwort mit Benachrichtigungsdetails wie Benachrichtigungsstatus, angehängten Labels und der Quellbenachrichtigungsrichtlinie zurück. Die Antwort sieht in etwa so aus: 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "k8s_cluster",
        "labels": {
          "location": "us-central1",
          "cluster_name": "example_cluster",
          "project_id": "my-project"
        }
      },
      "log": {
        "extracted_labels": {
          "title": "my title"
        }
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
    }
  ]
}
Curl-Nutzer können das Flag --data-urlencode gefolgt von einem Filterausdruck hinzufügen, um Benachrichtigungen nach Zeit oder Label zu filtern. Betrachten Sie die folgenden Beispiele:

Benachrichtigungen auflisten, die in der letzten Stunde geöffnet wurden:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Offene Benachrichtigungen des letzten Tages auflisten und filtern:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND state=open)"

Benachrichtigungen auflisten und filtern, die zwischen zwei Zeiträumen geöffnet wurden:

--data-urlencode "filter=(open_time>=\"`date -u -d "2 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND open_time<=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Benachrichtigungen nach Nutzerlabel auflisten und filtern In diesem Beispiel wird nach einem Nutzerlabel mit dem Namen app und dem Wert my-gke-app gefiltert:

--data-urlencode "filter=(policy.user_labels.app=\"my-gke-app\")"
Powershell-Nutzer können das folgende Beispiel verwenden, um ihrer Anfrage-URL einen zeitbasierten Filter hinzuzufügen: 
$baseUrl = "https://monitoring.googleapis.com/v3/projects/my-project/alerts"
$filterValue = (Get-Date).AddHours(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
$filter = 'open_time >= "' + $filterValue + '"'
$encodedFilter = [System.Uri]::EscapeDataString($filter)
$url = $baseUrl + "?filter=" + $encodedFilter

Benachrichtigung untersuchen

Auf der Seite Benachrichtigungsdetails finden Sie Informationen, die Ihnen helfen können, die Ursache einer Benachrichtigung zu ermitteln.

Logeinträge ansehen

Sehen Sie sich die Logeinträge an, um Muster und wiederkehrende Probleme im Zusammenhang mit Ihrer Untersuchung zu finden. Im Bereich Logs werden Logeinträge angezeigt, die der Abfrage Ihrer logbasierten Benachrichtigungsrichtlinie entsprechen.

  • Wenn Sie die Logeinträge im Log-Explorer aufrufen möchten, klicken Sie auf Im Log-Explorer ansehen und wählen Sie dann ein Projekt mit Bereich aus.
  • Wenn Sie den Bereich „Logs“ im Metrics Explorer aufrufen möchten, klicken Sie auf  Daten analysieren.

Zusätzliche Informationen ansehen

Im Abschnitt Labels werden die Labels und Werte für die überwachte Ressource angezeigt, die in dem Logeintrag enthalten sind, der die Benachrichtigung ausgelöst hat. Anhand dieser Informationen können Sie die überwachte Ressource ermitteln, die den Alarm ausgelöst hat. Weitere Informationen finden Sie unter Benachrichtigungen mit Labels versehen.

Im Bereich Dokumentation sehen Sie die Dokumentationsvorlage für Benachrichtigungen, die Sie beim Erstellen der Benachrichtigungsrichtlinie angegeben haben. Diese Informationen können eine Beschreibung dessen enthalten, was mit der Benachrichtigungsrichtlinie überwacht wird, sowie Tipps zur Risikominderung. Weitere Informationen finden Sie unter Benachrichtigungen mit benutzerdefinierter Dokumentation versehen.

Wenn Sie keine Dokumentation für Ihre Benachrichtigungsrichtlinie konfiguriert haben, wird im Bereich Dokumentation die Meldung „Keine Dokumentation konfiguriert“ angezeigt.

Um zugrunde liegende Probleme in Ihrer Anwendung zu erkennen, können Sie sich Benachrichtigungen ansehen, die mit anderen Bedingungen für Benachrichtigungsrichtlinien zusammenhängen.

Im Abschnitt Zugehörige Benachrichtigungen wird eine Liste von Benachrichtigungen angezeigt, die einem der folgenden Kriterien entsprechen:

  • Die Benachrichtigung wurde erstellt, als eine Bedingung derselben Benachrichtigungsrichtlinie erfüllt wurde.
  • Die Benachrichtigung hat dasselbe Label wie die Benachrichtigung auf der Seite Benachrichtigungsdetails.

Benachrichtigungen verwalten

Benachrichtigungen haben einen der folgenden Status:

  •  Offen: Die Bedingung der logbasierten Benachrichtigungsrichtlinie wurde erfüllt und die Benachrichtigung ist noch offen. Wenn dieselbe Bedingung noch einmal erfüllt wird und bereits eine Benachrichtigung offen ist, wird keine neue Benachrichtigung geöffnet.

  •  Bestätigt: Die Benachrichtigung ist offen und wurde manuell als bestätigt markiert. Dieser Status deutet in der Regel darauf hin, dass die Benachrichtigung untersucht wird.

  •  Geschlossen: Sie haben die Benachrichtigung manuell geschlossen oder sie wurde automatisch geschlossen, nachdem der Zeitraum für das automatische Schließen abgelaufen ist.

Benachrichtigungen bestätigen

Wir empfehlen Ihnen, eine Warnung als bestätigt zu markieren, sobald Sie mit der Untersuchung der Ursache der Warnung beginnen.

So markieren Sie eine Benachrichtigung als bestätigt:

  1. Klicken Sie auf der Seite Benachrichtigungen in der Tabelle Benachrichtigungen auf Alle Benachrichtigungen ansehen.

  2. Suchen Sie auf der Seite Benachrichtigungen nach der Benachrichtigung, die Sie bestätigen möchten, und führen Sie dann einen der folgenden Schritte aus:

    • Klicken Sie auf  Weitere Optionen und wählen Sie Bestätigen aus.
    • Öffnen Sie die Detailseite für die Benachrichtigung und klicken Sie auf Benachrichtigung bestätigen.

Benachrichtigungsrichtlinie pausieren

Wenn Sie verhindern möchten, dass in Monitoring während eines bestimmten Zeitraums Benachrichtigungen erstellt und gesendet werden, können Sie die zugehörige Benachrichtigungsrichtlinie in den Schlummermodus versetzen. Wenn Sie eine Benachrichtigungsrichtlinie in den Schlummermodus versetzen, bleiben die zugehörigen Benachrichtigungen offen, lösen aber keine weiteren Benachrichtigungen aus. Die Benachrichtigungen werden basierend auf der Dauer bis zur automatischen Schließung der Benachrichtigungsrichtlinie geschlossen.

So erstellen Sie einen Schlummerzeitraum für eine Benachrichtigung, die Sie gerade ansehen:

  1. Klicken Sie auf der Seite Benachrichtigungsdetails auf Richtlinie für Schlummerfunktion.

  2. Wählen Sie die Schlummerdauer aus. Nachdem Sie die Schlummerdauer ausgewählt haben, beginnt die Schlummerfunktion sofort.

Sie können eine Benachrichtigungsrichtlinie auch auf der Seite Benachrichtigungen in den Schlummermodus versetzen. Suchen Sie dazu nach der Benachrichtigung, die Sie in den Schlummermodus versetzen möchten, klicken Sie auf  Mehr Optionen und wählen Sie dann Schlummern aus. Sie können Benachrichtigungsrichtlinien während Ausfällen in den Schlummermodus versetzen, um weitere Benachrichtigungen während der Fehlerbehebung zu vermeiden.

Benachrichtigungen schließen

Sie können Monitoring eine Benachrichtigung für Sie schließen lassen oder die Benachrichtigung selbst schließen.

Monitoring schließt eine Benachrichtigung automatisch, wenn die automatische Schließungsdauer für die Benachrichtigungsrichtlinie abläuft. Standardmäßig beträgt die Dauer für das automatische Schließen 7 Tage. Die Mindestdauer für das automatische Schließen beträgt 30 Minuten.

Die Dauer für das automatische Schließen gibt an, wie viel Zeit vergehen muss, ohne dass die Ursache der Benachrichtigung wieder auftritt, bevor die Benachrichtigung geschlossen wird. Wenn eine Benachrichtigung geöffnet ist und die Ursache erneut auftritt, kann die Benachrichtigung daher länger als die Dauer des automatischen Schließens geöffnet bleiben.

So schließen Sie eine Benachrichtigung:

  1. Klicken Sie auf der Seite Benachrichtigungen in der Tabelle Benachrichtigungen auf Alle Benachrichtigungen ansehen.

  2. Suchen Sie auf der Seite Benachrichtigungen nach der Benachrichtigung, die Sie schließen möchten, und führen Sie dann einen der folgenden Schritte aus:

    • Klicken Sie auf  Mehr ansehen und wählen Sie Benachrichtigung schließen aus.
    • Öffnen Sie die Seite Benachrichtigungsdetails für die Benachrichtigung und klicken Sie dann auf Benachrichtigung schließen.

Wenn die Meldung Unable to close alert angezeigt wird, versuchen Sie es nach einigen Minuten wieder. Sie können eine neue Benachrichtigung nicht sofort schließen, da die Bedingungen, die die Benachrichtigung ausgelöst haben, vom Benachrichtigungssystem weiterhin als aktiv betrachtet werden.

Datenaufbewahrung und ‑limits

Informationen zu Limits und zum Aufbewahrungszeitraum von Benachrichtigungen finden Sie unter Limits für Benachrichtigungen.

Nächste Schritte