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: