Vorfälle für logbasierte Benachrichtigungsrichtlinien

Mit Cloud Monitoring-Benachrichtigungen können Sie Probleme verfolgen und untersuchen, wenn einzelne Logeinträge in Cloud Logging der Bedingung einer logbasierten Benachrichtigungsrichtlinie entsprechen. Für jede Benachrichtigung sendet Monitoring eine Benachrichtigung und erstellt eine Seite Benachrichtigungsdetails, damit Sie den Fehler beheben und den Benachrichtigungslebenszyklus verwalten können.

Auf der Seite Benachrichtigungsdetails können Sie passende Logeinträge und Links zu ähnlichen Benachrichtigungen aufrufen. Beim Monitoring wird keine neue Benachrichtigung erstellt, wenn die Richtlinie pausiert oder deaktiviert ist oder wenn die Anzahl der Benachrichtigungsrichtlinien oder Benachrichtigungen die Grenzwerte für Benachrichtigungen überschreitet. Wenn ein weiterer Logeintrag der Bedingung einer bereits geöffneten Benachrichtigung entspricht, sendet Monitoring eine zusätzliche Benachrichtigung, anstatt eine neue Benachrichtigung zu öffnen.

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 die 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 finden Sie Informationen zu Ihren Benachrichtigungsrichtlinien, Pausen und Benachrichtigungen:

    • Im Bereich Zusammenfassung wird die Anzahl der offenen Benachrichtigungen aufgeführt.
    • In der Tabelle Benachrichtigungen werden die letzten 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 Warnungsdetails finden Sie in diesem Dokument im Abschnitt Warnung untersuchen.

Ältere Benachrichtigungen finden

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

  • Wenn Sie die Einträge in der Tabelle Benachrichtigungen durchblättern möchten, klicken Sie auf  Neuere oder  Ältere.

  • 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 Alerts 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 dann eine Auswahl im Menü. Weitere Informationen finden Sie unter Alerts 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 Filterkriterien erfüllen.

So filtern Sie die Tabelle mit Benachrichtigungen:

  1. Klicken Sie auf der Seite Benachrichtigungen auf  Tabelle filtern und wählen Sie dann eine Filterproperty aus. Zu den Filtereigenschaften 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 die gcloud verwenden, um Benachrichtigungen zu erhalten und aufzulisten.

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. Sie können beispielsweise mit --filter='close_time>="2025-09-10T00:00:00Z"' nach Zeit oder mit --filter='resource.labels.key="value"' nach Label filtern.

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

  • --uri: Die Befehlsausgabe ist eine Liste von Ressourcen-URIs anstelle der Standardausgabe.

  • --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 mit der Monitoring API Details zu einer einzelnen Benachrichtigung 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 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

Wenn Sie mit der Monitoring API Benachrichtigungen in Ihrem Projekt auflisten und die Ergebnisse filtern möchten, verwenden Sie die Methode alerts.list.

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 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}"
    }
  ]
}
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 vom letzten Tag 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

Die Seite Benachrichtigungsdetails enthält Informationen, die Ihnen helfen können, die Ursache einer Benachrichtigung zu ermitteln.

Logeinträge ansehen

Suchen Sie in den Logeinträgen nach Mustern und wiederkehrenden Problemen, die mit Ihrer Untersuchung zusammenhängen. 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 das Log-Panel im Metrics Explorer aufrufen möchten, klicken Sie auf  Daten untersuchen.

Zusätzliche Informationen ansehen

Im Bereich Labels werden die Labels und Werte für die überwachte Ressource angezeigt, die im Logeintrag enthalten sind, der die Benachrichtigung ausgelöst hat. Anhand dieser Informationen können Sie die spezifische überwachte Ressource ermitteln, die die Benachrichtigung 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 Bereich 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 können einen der folgenden Status haben:

  •  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 geöffnet ist, wird keine neue Benachrichtigung geöffnet.

  •  Bestätigt: Die Benachrichtigung ist offen und wurde manuell als bestätigt markiert. Normalerweise bedeutet dieser Status, 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, eine Warnung als bestätigt zu markieren, wenn 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 dann 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 Schlummermodus für eine Benachrichtigung, die Sie gerade ansehen:

  1. Klicken Sie auf der Seite Benachrichtigungsdetails auf Richtlinie aufschieben.

  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 die gewünschte Benachrichtigung, klicken Sie auf  Weitere Optionen und wählen Sie dann Schlummern aus. Sie können Benachrichtigungsrichtlinien während Ausfällen pausieren, 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 Dauer für das automatische Schließen 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 automatische Schließdauer 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 gehen Sie dann so vor:

    • 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 in einigen Minuten noch einmal. Sie können einen neuen Vorfall nicht sofort schließen, da die Bedingungen, die den Vorfall 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