Benachrichtigungen für SQL-basierte Benachrichtigungsrichtlinien verwalten

Mit Benachrichtigungen von Cloud Monitoring können Sie Probleme verfolgen und untersuchen, wenn SQL-Abfrageergebnisse für gruppierte Logeinträge die Bedingung einer SQL-basierten Benachrichtigungsrichtlinie erfüllen. Für jede Benachrichtigung sendet Monitoring eine Benachrichtigung und erstellt eine Seite mit Benachrichtigungsdetails, um Sie bei der Fehlerbehebung und der Verwaltung des Benachrichtigungslebenszyklus zu unterstützen.

Auf der Seite Benachrichtigungsdetails finden Sie Zusammenfassungen der SQL-Abfrageergebnisse und Links zu ähnlichen Benachrichtigungen. Monitoring erstellt keine Benachrichtigung, wenn die Richtlinie pausiert oder deaktiviert ist oder wenn die Anzahl der Benachrichtigungsrichtlinien oder Benachrichtigungen die Limits für Benachrichtigungen überschreitet.

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 listen 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 werden Informationen zu Ihren Benachrichtigungsrichtlinien, Schlummerfunktionen 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 anzeigen.

  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 dieses Dokuments.

Ältere Meldungen finden

In der Tabelle Benachrichtigungen auf der Seite Benachrichtigungen werden die neuesten offenen Benachrichtigungen angezeigt. Führen Sie einen der folgenden Schritte aus, um ältere Benachrichtigungen aufzurufen:

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

  • Klicken Sie auf Alle Benachrichtigungen ansehen, um eine Seite zu öffnen, auf der Sie Ihre Benachrichtigungen auflisten und filtern können. Die Seite Benachrichtigungen wird geöffnet. Führen Sie auf dieser Seite die folgenden Schritte aus:

    • Alle Benachrichtigungen anzeigen, einschließlich geschlossener Benachrichtigungen. Wenn Sie alle Benachrichtigungen sehen möchten, klicken Sie auf Geschlossene Benachrichtigungen anzeigen.
    • Benachrichtigungen filtern Informationen zum Hinzufügen von Filtern finden Sie unter Benachrichtigungen filtern.
    • Benachrichtigung bestätigen oder schließen oder die zugehörige Benachrichtigungsrichtlinie vorübergehend deaktivieren. Klicken Sie in der Zeile der Benachrichtigung auf  Weitere Optionen und treffen Sie eine Auswahl im Menü, um auf diese Optionen zuzugreifen. 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 den Benachrichtigungen:

  1. Klicken Sie auf der Seite Benachrichtigungen auf  Tabelle filtern und wählen Sie dann ein Filterattribut 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 CLI verwenden, um Benachrichtigungen abzurufen 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 dann ungefähr so aus: 
{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "sql_alert"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
}

Benachrichtigungen auflisten

Sie können Benachrichtigungen in Ihrem Projekt auflisten und die Ergebnisse mit der gcloud CLI 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 dann ungefähr so aus: 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "sql_alert"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
    }
  ]
}
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: Der Befehl gibt anstelle der Standardausgabe eine Liste von Ressourcen-URIs aus.

  • --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 in etwa so aus: 
{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "sql_alert"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
}

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": "sql_alert"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
    }
  ]
}
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"`\")"

Benachrichtigungen auflisten und filtern, die am letzten Tag offen waren:

--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.

Abfrageergebnisse ansehen

Im Bereich Abfrageinformationen wird angezeigt, ob die Abfragen der Benachrichtigungsrichtlinie auf BigQuery-On-Demand-Slots oder auf einer Reservierung ausgeführt werden. In diesem Bereich werden auch die geschätzten gescannten Byte und die pro Tag verbrauchte Slotzeit angezeigt, basierend auf den Abfragen, die in den letzten sieben Tagen ausgeführt wurden.

Im Bereich SQL-Abfrageergebnisse wird eine Liste der Zusammenfassungen der Abfrageergebnisse für jedes Mal angezeigt, wenn Observability Analytics die SQL-Abfrage aus der Bedingung der Benachrichtigungsrichtlinie ausgeführt hat. Standardmäßig wird die Liste so gefiltert, dass nur Abfragen angezeigt werden, die der Bedingung der Benachrichtigungsrichtlinie entsprechen.

  • Wenn Sie die Abfrage und die Tabelle mit den Abfrageergebnissen für einen bestimmten Zeitpunkt aufrufen möchten, zu dem Observability Analytics die Abfrage ausgeführt hat, klicken Sie auf einen Wert in der Spalte Abfrageausführungszeit.
  • Wenn Sie zwischen der Anzeige nur der Abfrageergebnisse, die der Bedingung der Benachrichtigungsrichtlinie entsprechen, und allen Abfragen, die Observability Analytics über die Benachrichtigungsrichtlinie ausgeführt hat, wechseln möchten, klicken Sie auf Nur Abfragen anzeigen, die Benachrichtigungsbedingungen entsprechen.

Zusätzliche Informationen ansehen

Im Abschnitt Dokumentation wird die Dokumentationsvorlage für Benachrichtigungen angezeigt, die Sie beim Erstellen der Benachrichtigungsrichtlinie angegeben haben. Diese Informationen können eine Beschreibung dessen enthalten, was die Benachrichtigungsrichtlinie überwacht, sowie Tipps zur Behebung. 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.

Damit Sie zugrunde liegende Probleme in Ihrer Anwendung erkennen können, können Sie sich Benachrichtigungen zu anderen Bedingungen von Benachrichtigungsrichtlinien ansehen.

Im Abschnitt Zugehörige Benachrichtigungen wird eine Liste anderer Benachrichtigungen angezeigt, die erstellt wurden, als die Bedingung der Benachrichtigungsrichtlinie erfüllt wurde.

Benachrichtigungen verwalten

Benachrichtigungen können einen der folgenden Status haben:

  •  Offen: Die Bedingung der SQL-basierten 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. In der Regel bedeutet dieser Status, dass die Benachrichtigung untersucht wird.

  •  Geschlossen: Sie haben die Benachrichtigung manuell geschlossen oder sie wurde nach Ablauf des Zeitraums für das automatische Schließen automatisch geschlossen.

Benachrichtigungen bestätigen

Wir empfehlen, eine Benachrichtigung als bestätigt zu markieren, wenn Sie mit der Untersuchung der Ursache der Benachrichtigung beginnen.

So markieren Sie eine Benachrichtigung als bestätigt:

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

  2. Suchen Sie auf der Seite Benachrichtigungen die Benachrichtigung, die Sie bestätigen möchten, und führen Sie 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 Monitoring während eines bestimmten Zeitraums Benachrichtigungen erstellt und sendet, können Sie die zugehörige Benachrichtigungsrichtlinie in den Schlummermodus versetzen. Wenn Sie eine Benachrichtigungsrichtlinie in den Schlummermodus versetzen, bleiben Benachrichtigungen im Zusammenhang mit der Benachrichtigungsrichtlinie offen, führen aber nicht zu weiteren Benachrichtigungen. Die Benachrichtigungen werden gemäß der Dauer bis zur automatischen Schließung der Benachrichtigungsrichtlinie geschlossen.

So erstellen Sie eine Schlummerfunktion für eine Benachrichtigung, die Sie sich gerade ansehen:

  1. Klicken Sie auf der Seite Benachrichtigungsdetails auf Schlummerrichtlinie.

  2. Wählen Sie die Dauer der Schlummerfunktion 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 Benachrichtigung, die Sie in den Schlummermodus versetzen möchten, klicken Sie auf  Weitere Optionen und wählen Sie dann Schlummern aus. Sie können Benachrichtigungsrichtlinien während Ausfällen in den Ruhemodus versetzen, um weitere Benachrichtigungen während der Fehlerbehebung zu verhindern.

Benachrichtigungen schließen

Sie können eine Benachrichtigung von Monitoring schließen lassen oder sie selbst schließen.

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

Die Dauer bis zum automatischen Schließen gibt die Zeit an, die vergehen muss, ohne dass die Ursache der Benachrichtigung wiederholt wird, bevor die Benachrichtigung geschlossen wird. Aus diesem Grund kann eine Benachrichtigung, wenn sie offen ist und die Ursache erneut auftritt, länger als die Dauer des automatischen Schließens offen bleiben.

So schließen Sie eine Benachrichtigung:

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

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

    • Klicken Sie auf  Mehr anzeigen und wählen Sie dann 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 ein paar Minuten noch einmal. Sie können eine neue Benachrichtigung nicht sofort schließen, da die Bedingungen, die die Benachrichtigung ausgelöst haben, vom Benachrichtigungssystem noch als aktiv betrachtet werden.

Datenaufbewahrung und Limits

Informationen zu Limits und zur Aufbewahrungsdauer von Benachrichtigungen finden Sie unter Limits für Benachrichtigungen.

Nächste Schritte