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:
-
Sie können Benachrichtigungen mit der Google Cloud CLI oder der Cloud Monitoring API aufrufen:
Monitoring-Benachrichtigungsbetrachter (
roles/monitoring.alertViewer) -
So rufen Sie Benachrichtigungen über die Google Cloud Console auf:
- Monitoring Cloud Console Incident Viewer (
roles/monitoring.cloudConsoleIncidentViewer) - Betrachter von Stackdriver-Konten (
roles/stackdriver.accounts.viewer)
- Monitoring Cloud Console Incident Viewer (
-
So verwalten Sie Benachrichtigungen über die Google Cloud -Konsole:
- Monitoring Cloud Console Incident Editor (
roles/monitoring.cloudConsoleIncidentEditor) - Betrachter von Stackdriver-Konten (
roles/stackdriver.accounts.viewer)
- Monitoring Cloud Console Incident Editor (
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:
-
Rufen Sie in der Google Cloud Console die Seite notifications Benachrichtigungen auf:
Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.
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.
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 arrow_back_ios Neuer oder arrow_forward_ios Ä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 more_vert 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:
Klicken Sie auf der Seite Benachrichtigungen auf filter_list 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
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
{
"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
{
"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}"
}
]
}
--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 auf2oder 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: