In diesem Dokument wird beschrieben, wie Sie mit der Google Cloud Console eine messwertbasierte Benachrichtigungsrichtlinie erstellen, die Benachrichtigungen sendet, wenn die Werte eines Messwerts den Schwellenwert für ein bestimmtes Fenster für den erneuten Test über- oder unterschreiten. Die Bedingung einer Benachrichtigungsrichtlinie kann beispielsweise erfüllt sein, wenn die CPU-Auslastung mindestens fünf Minuten lang über 80% liegt.
Dieser Inhalt gilt nicht für logbasierte Benachrichtigungsrichtlinien. Informationen zu logbasierten Benachrichtigungsrichtlinien, mit denen Sie informiert werden, wenn eine bestimmte Meldung in Ihren Logs angezeigt wird, finden Sie unter Logs überwachen.
In diesem Dokument wird Folgendes nicht beschrieben:
- So werden Sie benachrichtigt, wenn keine Daten eingehen. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien für fehlende Messwerte erstellen.
- Wie Sie basierend auf dem vorhergesagten Wert eines Messwerts benachrichtigt werden. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien für prognostizierte Messwerte erstellen.
Benachrichtigungsrichtlinie mit der Cloud Monitoring API erstellen Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien mit der API erstellen.
Benachrichtigungsrichtlinie erstellen, deren Bedingung eine MQL-Abfrage (Monitoring Query Language) enthält Diese Richtlinien können einen statischen oder dynamischen Schwellenwert verwenden. Weitere Informationen finden Sie in folgenden Dokumenten:
Hinweise
-
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (
roles/monitoring.editor
) für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Erstellen und Ändern von Benachrichtigungsrichtlinien über die Google Cloud Console benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.Möglicherweise können Sie 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.
Machen Sie sich mit den allgemeinen Konzepten von Benachrichtigungsrichtlinien vertraut. Informationen zu diesen Themen finden Sie unter Benachrichtigungen.
Konfigurieren Sie die Benachrichtigungskanäle, die Sie für Benachrichtigungen verwenden möchten. Aus Gründen der Redundanz empfehlen wir, mehrere Arten von Benachrichtigungskanälen zu erstellen. Weitere Informationen finden Sie unter Benachrichtigungskanäle erstellen und verwalten.
Benachrichtigungsrichtlinie erstellen
So erstellen Sie eine Benachrichtigungsrichtlinie, die den Wert dieses Messwerts mit einem statischen Schwellenwert vergleicht:
-
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 Richtlinie erstellen aus.
Wählen Sie die zu überwachende Zeitreihe aus:
Klicken Sie auf Messwert auswählen, wählen Sie in den Menüs einen Ressourcentyp und einen Messwerttyp aus und klicken Sie dann auf Anwenden.
Das Menü Messwert auswählen enthält Funktionen, mit denen Sie die verfügbaren Messwerttypen finden können:
- Über die Filterleiste filter_list können Sie einen bestimmten Messwerttyp finden.
Wenn Sie beispielsweise
util
eingeben, schränken Sie das Menü auf Einträge ein, dieutil
enthalten. Einträge werden angezeigt, wenn sie einen „Enthält“-Test bestehen, bei dem die Groß-/Kleinschreibung nicht berücksichtigt wird.
- Klicken Sie auf Messwert nicht im Menü aufgeführt. Aktiv, um alle Messwerttypen (auch solche ohne Daten) aufzurufen. Standardmäßig werden in den Menüs nur Messwerttypen mit Daten angezeigt. Weitere Informationen finden Sie unter
Sie können jeden integrierten Messwert oder jeden benutzerdefinierten Messwert überwachen.
- Über die Filterleiste filter_list können Sie einen bestimmten Messwerttyp finden.
Wenn Sie beispielsweise
Optional: Klicken Sie auf Filter hinzufügen, um einen Teil der Zeitreihen zu überwachen, die den im vorherigen Schritt ausgewählten Messwert- und Ressourcentypen entsprechen. Wählen Sie im Dialogfeld „Filter“ das Label aus, nach dem gefiltert werden soll, einen Vergleichsoperator und dann den Filterwert. Der Filter
zone =~ ^us.*.a$
verwendet beispielsweise einen regulären Ausdruck, um alle Zeitachsendaten abzugleichen, deren Zonenname mitus
beginnt und mita
endet. Weitere Informationen finden Sie unter Ausgewählte Zeitachsen filtern.Optional: Wenn Sie ändern möchten, wie die Punkte in einer Zeitachse ausgerichtet werden, legen Sie im Bereich Daten transformieren die Felder Rollierendes Fenster und Funktion für rollierendes Zeitfenster fest.
Diese Felder geben an, wie die in einem Fenster aufgezeichneten Punkte kombiniert werden. Angenommen, das Fenster hat 15 Minuten und die Fensterfunktion ist
max
. Der ausgerichtete Punkt ist der Maximalwert aller Punkte in den letzten 15 Minuten. Weitere Informationen finden Sie unter Ausrichtung: Regularisierung innerhalb einer Reihe.Sie können auch die Rate, um die sich ein Messwert ändert, überwachen, indem Sie das Feld Funktion für rollierendes Zeitfenster für die prozentuale Änderung verwenden. Weitere Informationen finden Sie unter Änderungsrate überwachen.
Optional: Kombinieren Sie Zeitachsen, wenn Sie die Anzahl der von einer Richtlinie überwachten Zeitachsen reduzieren oder nur eine Sammlung von Zeitachsen überwachen möchten. Anstatt beispielsweise die CPU-Auslastung jeder VM-Instanz zu überwachen, möchten Sie möglicherweise die Durchschnitt der CPU-Auslastung für alle VMs in einer Zone berechnen und dann diesen Durchschnitt überwachen. Standardmäßig werden Zeitachsen nicht kombiniert. Allgemeine Informationen finden Sie unter Reduktion: Zeitachsen kombinieren.
So kombinieren Sie alle Zeitreihen:
- Klicken Sie im Abschnitt Über mehrere Zeitreihen auf expand_more Maximieren.
- Legen Sie für das Feld Zeitachsenaggregation einen anderen Wert als
none
fest. Wenn Sie beispielsweise den Durchschnittswert der Zeitachse aufrufen möchten, wählen Siemean
aus. - Achten Sie darauf, dass das Feld Zeitachsen gruppieren nach leer ist.
So kombinieren oder gruppieren Sie Zeitreihen nach Labelwerten:
- Klicken Sie im Abschnitt Über mehrere Zeitreihen auf expand_more Maximieren.
- Legen Sie für das Feld Zeitachsenaggregation einen anderen Wert als
none
fest. - Wählen Sie im Feld Zeitachsen gruppieren nach die Labels aus, nach denen gruppiert werden soll.
Wenn Sie beispielsweise nach dem Label
zone
gruppieren und dann das Aggregationsfeld auf den Wertmean
festlegen, wird im Diagramm eine Zeitachse für jede Zone angezeigt, für die Daten vorhanden sind. Die für eine bestimmte Zone angezeigte Zeitachse ist der Durchschnitt aller Zeitachsen mit dieser Zone.Klicken Sie auf Weiter.
Konfigurieren Sie den Bedingungstrigger:
Belassen Sie das Feld Bedingungstyp auf dem Standardwert Schwellenwert.
Wählen Sie einen Wert für das Menü Trigger für Benachrichtigungen aus. In diesem Menü können Sie die Teilmenge der Zeitachsen angeben, die gegen den Schwellenwert verstoßen müssen, bevor die Bedingung erfüllt ist.
Geben Sie in den Feldern Grenzwertposition und Schwellenwert an, wann der Wert eines Messwerts den Grenzwert überschreitet. Wenn Sie diese Werte beispielsweise auf Über Grenzwert und
0.3
festlegen, verstößt jede Messung über0.3
gegen den Grenzwert.Optional: Wenn Sie festlegen möchten, wie lange Messungen den Grenzwert überschreiten müssen, bevor Monitoring eine Benachrichtigung sendet, maximieren Sie Erweiterte Optionen und verwenden Sie dann das Menü Fenster noch einmal testen.
Der Standardwert ist Keine erneute Prüfung. Bei dieser Einstellung kann eine einzelne Messung zu einer Benachrichtigung führen. Weitere Informationen und ein Beispiel finden Sie unter Einstellungen für Ausrichtungszeitraum und Dauer.
Optional: Wenn Sie festlegen möchten, wie Monitoring die Bedingung auswertet, wenn keine Daten eingehen, maximieren Sie Erweiterte Optionen und verwenden Sie dann das Menü Daten fehlen für Auswertung.
Das Menü Fehlende Daten für die Bewertung ist deaktiviert, wenn der Wert für Fenster für nochmalige Prüfung auf Kein neuer Test gesetzt ist.
Google Cloud Console
Feld „Auswertung fehlender Daten“Zusammenfassung Details Fehlende Daten leer Offene Vorfälle bleiben offen.
Neue Vorfälle werden nicht geöffnet.Wenn Bedingungen erfüllt sind, ist die Bedingung weiterhin erfüllt, wenn keine Daten mehr eingehen. Wenn ein Vorfall für diese Bedingung offen ist, bleibt er offen. Wenn ein Vorfall offen ist und keine Daten eintreffen, startet der Timer für das automatische Schließen nach einer Verzögerung von mindestens 15 Minuten. Wenn der Timer abläuft, wird der Vorfall geschlossen.
Nicht erfüllte Bedingungen sind weiterhin nicht erfüllt, wenn keine Daten mehr eingehen.
Fehlende Datenpunkte, die als Werte behandelt werden, die gegen die Richtlinienbedingung verstoßen Offene Vorfälle bleiben offen.
Neue Vorfälle können geöffnet werden.Wenn Bedingungen erfüllt sind, ist die Bedingung weiterhin erfüllt, wenn keine Daten mehr eingehen. Wenn ein Vorfall für diese Bedingung offen ist, bleibt er offen. Wenn ein Vorfall offen ist und für die Dauer des automatischen Schließens plus 24 Stunden keine Daten eintreffen, wird er geschlossen.
Bei nicht erfüllten Bedingungen verhält sich diese Einstellung wie eine
metric-absence condition
-Bedingung. Wenn Daten nicht innerhalb der im Fenster für den erneuten Test festgelegten Zeit eintreffen, wird die Bedingung als erfüllt bewertet. Bei einer Benachrichtigungsrichtlinie mit einer Bedingung wird ein Vorfall geöffnet, wenn die Bedingung erfüllt ist.Fehlende Datenpunkte werden als Werte behandelt, die nicht gegen die Richtlinienbedingung verstoßen Offene Vorfälle werden geschlossen.
Neue Vorfälle werden nicht geöffnet.Wenn Bedingungen erfüllt sind, ist die Bedingung nicht mehr erfüllt, wenn keine Daten mehr eingehen. Wenn ein Vorfall für diese Bedingung offen ist, wird er geschlossen.
Nicht erfüllte Bedingungen sind weiterhin nicht erfüllt, wenn keine Daten mehr eingehen.
Klicken Sie auf Weiter.
Optional: Erstellen Sie eine Benachrichtigungsrichtlinie mit mehreren Bedingungen.
Die meisten Richtlinien überwachen einen einzelnen Messwerttyp. Eine Richtlinie kann beispielsweise die Anzahl der in eine VM-Instanz geschriebenen Byte überwachen. Wenn Sie mehrere Messwerttypen überwachen möchten, erstellen Sie eine Richtlinie mit mehreren Bedingungen. Jede Bedingung überwacht einen Messwerttyp. Nachdem Sie die Bedingungen erstellt haben, geben Sie an, wie die Bedingungen kombiniert werden sollen. Weitere Informationen finden Sie unter Richtlinien mit mehreren Bedingungen.
So erstellen Sie eine Benachrichtigungsrichtlinie mit mehreren Bedingungen:
- Klicken Sie für jede zusätzliche Bedingung auf Benachrichtigungsbedingung hinzufügen und konfigurieren Sie diese Bedingung.
- Klicken Sie auf Weiter und konfigurieren Sie, wie Bedingungen kombiniert werden sollen.
- Klicken Sie auf Weiter, um zur Einrichtung der Benachrichtigungen und Dokumentation zu gelangen.
Konfigurieren Sie die Benachrichtigungen:
Maximieren Sie das Menü Benachrichtigungen und Name und wählen Sie Ihre Benachrichtigungskanäle aus. Aus Gründen der Redundanz empfehlen wir, einer Benachrichtigungsrichtlinie mehrere Arten von Benachrichtigungskanälen hinzuzufügen. Weitere Informationen finden Sie unter Benachrichtigungskanäle verwalten.
Optional: Wenn Sie benachrichtigt werden möchten, wenn ein Vorfall geschlossen wird, wählen Sie Bei Schließung wegen Vorfalls benachrichtigen aus. Wenn Sie eine Benachrichtigungsrichtlinie mit der Google Cloud Console erstellen, wird standardmäßig nur dann eine Benachrichtigung gesendet, wenn ein Vorfall erstellt wird.
Optional: Um zu ändern, wie lange Monitoring wartet, bevor ein Vorfall geschlossen wird, nachdem keine Daten eingehen, wählen Sie eine Option aus dem Menü Dauer für automatisches Schließen von Vorfällen aus. Wenn keine Daten eingehen, wartet Monitoring standardmäßig sieben Tage, bevor ein offener Vorfall geschlossen wird.
Wählen Sie im Menü Schweregrad der Richtlinie eine Option aus. Bei Vorfällen und Benachrichtigungen wird der Schweregrad angezeigt.
Optional: So fügen Sie der Benachrichtigungsrichtlinie im Abschnitt Richtliniennutzerlabels benutzerdefinierte Labels hinzu:
- Klicken Sie auf Label hinzufügen und geben Sie im Feld Schlüssel einen Namen für das Label ein. Labelnamen müssen mit einem Kleinbuchstaben beginnen und können Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche enthalten.
Geben Sie beispielsweise
severity
ein. - Klicken Sie auf Wert und geben Sie einen Wert für das Label ein. Labelwerte können Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche enthalten.
Geben Sie beispielsweise
critical
ein.
Informationen dazu, wie Sie Ihre Benachrichtigungen mithilfe von Richtlinienlabels verwalten können, finden Sie unter Vorfälle mit Labels annotieren.
- Klicken Sie auf Label hinzufügen und geben Sie im Feld Schlüssel einen Namen für das Label ein. Labelnamen müssen mit einem Kleinbuchstaben beginnen und können Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche enthalten.
Geben Sie beispielsweise
Optional: Geben Sie im Abschnitt Dokumentation alle Inhalte ein, die in der Benachrichtigung enthalten sein sollen.
Zur Formatierung Ihrer Dokumentation können Sie Nur-Text, Markdown und Variablen verwenden. Sie können auch Links einfügen, um Nutzern beim Debuggen des Vorfalls zu helfen, z. B. Links zu internen Playbooks, Google Cloud-Dashboards und externen Seiten. Die folgende Dokumentationsvorlage beschreibt beispielsweise einen CPU-Auslastungsvorfall für eine
gce_instance
-Ressource und enthält mehrere Variablen, um auf die Benachrichtigungsrichtlinie und die REST-Ressourcen für Bedingungen zu verweisen. Die Dokumentationsvorlage leitet die Leser dann für die Fehlerbehebung auf externe Seiten weiter.Beim Erstellen von Benachrichtigungen ersetzt Monitoring die Dokumentationsvariablen durch ihre Werte. Die Werte ersetzen die Variablen nur in Benachrichtigungen. Im Vorschaubereich und an anderen Stellen in der Google Cloud Console wird nur die Markdown-Formatierung angezeigt.
Vorschau
## CPU utilization exceeded ### Summary The ${metric.display_name} of the ${resource.type} ${resource.label.instance_id} in the project ${resource.project} has exceeded 90% for over 15 minutes. ### Additional resource information Condition resource name: ${condition.name} Alerting policy resource name: ${policy.name} ### Troubleshooting and Debug References Repository with debug scripts: example.com Internal troubleshooting guide: example.com ${resource.type} dashboard: example.com
In Benachrichtigung formatieren
Weitere Informationen finden Sie unter Benachrichtigungen mit benutzerdefinierter Dokumentation annotieren und Kanalsteuerelemente verwenden.
Klicken Sie auf Name der Benachrichtigung und geben Sie einen Namen für die Benachrichtigungsrichtlinie ein.
Klicken Sie auf Richtlinie erstellen.
Ausgewählte Zeitreihe filtern
Filter sorgen dafür, dass nur Zeitachsen überwacht werden, die bestimmte Kriterien erfüllen. Wenn Sie Filter anwenden, können Sie die Anzahl der Linien im Diagramm reduzieren, was die Leistung des Diagramms verbessern kann. Sie können die Menge der überwachten Daten auch durch Aggregation reduzieren. Filter stellen sicher, dass nur Zeitachsen verwendet werden, die bestimmte Kriterien erfüllen. Wenn Sie Filter anwenden, müssen weniger Zeitreihen ausgewertet werden, wodurch die Leistung der Benachrichtigung verbessert werden kann.
Ein Filter besteht aus einem Label, einem Vergleichsoperator und einem Wert. Wenn Sie beispielsweise alle Zeitachsen abgleichen möchten, deren zone
-Label mit "us-central1"
beginnt, können Sie den Filter zone=~"us-central1.*"
verwenden. Dieser verwendet einen regulären Ausdruck für den Vergleich.
Wenn Sie nach der Projekt-ID oder dem Ressourcencontainer filtern, müssen Sie den Gleichheitsoperator (=)
verwenden. Wenn Sie nach anderen Labels filtern, können Sie einen beliebigen unterstützten Vergleichsoperator verwenden.
In der Regel können Sie Messwert- und Ressourcenlabels sowie nach Ressourcengruppe filtern.
Wenn Sie mehrere Filterkriterien angeben, werden nur die Zeitachsen überwacht, die alle Kriterien erfüllen.
Um einen Filter hinzuzufügen, klicken Sie auf Filter hinzufügen, füllen Sie das Dialogfeld aus und klicken Sie dann auf Fertig. Im Dialogfeld verwenden Sie das Feld Filter, um das Kriterium auszuwählen, nach dem gefiltert werden soll. Anschließend wählen Sie den Vergleichsoperator und dann den Wert aus. In jeder Zeile der folgenden Tabelle sind ein Vergleichsoperator, seine Bedeutung und ein Beispiel aufgeführt:
Operator | Bedeutung | Beispiel |
---|---|---|
= |
Entsprechung | resource.labels.zone = "us-central1-a" |
!= |
Ungleichheit | resource.labels.zone != "us-central1-a" |
=~ |
Gleichheit mit regulärem Ausdruck2 | monitoring.regex.full_match("^us.*") |
!=~ |
Ungleichheit mit regulärem Ausdruck2 | monitoring.regex.full_match("^us.*") |
starts_with |
Wert beginnt mit | resource.labels.zone = starts_with("us") |
ends_with |
Wert endet mit | resource.labels.zone = ends_with("b") |
has_substring |
Wert enthält | resource.labels.zone = has_substring("east") |
one_of |
Eine von | resource.labels.zone = one_of("asia-east1-b", "europe-north1-a") |
!starts_with |
Wert beginnt nicht mit | resource.labels.zone != starts_with("us") |
!ends_with |
Wert endet nicht mit | resource.labels.zone != ends_with("b") |
!has_substring |
Wert enthält nicht | resource.labels.zone != has_substring("east") |
!one_of |
Wert ist keiner der folgenden Werte | resource.labels.zone != one_of("asia-east1-b", "europe-north1-a") |
Fehlerbehebung
Dieser Abschnitt enthält Tipps zur Fehlerbehebung.
Messwert nicht im Menü der verfügbaren Messwerte aufgeführt
Führen Sie einen der folgenden Schritte aus, um einen Messwert zu überwachen, der nicht im Menü Messwert auswählen aufgeführt ist:
Maximieren Sie das Menü Messwert auswählen und klicken Sie dann auf
Aktiv, um eine Benachrichtigungsrichtlinie zu erstellen, die einen Google Cloud-Messwert überwacht. Wenn das Menü deaktiviert ist, werden alle Messwerte für Google Cloud-Dienste und alle Messwerte mit Daten aufgelistet.Wenn Sie eine Bedingung für einen benutzerdefinierten Messwerttyp konfigurieren möchten, bevor der Messwerttyp Daten generiert, müssen Sie den Messwerttyp mithilfe eines Monitoring-Filters angeben:
- Wählen Sie ? in der Abschnittsüberschrift Messwert wählen und wählen Sie dann in der Kurzinfo Direkter Filtermodus aus.
Geben Sie einen Monitoringfilter oder eine Zeitachsenauswahl ein. Informationen zur Syntax finden Sie in den folgenden Dokumenten:
Änderungsrate überwachen
Wenn Sie die Änderungsrate eines Messwerts überwachen möchten, setzen Sie das Feld Funktion für rollierendes Zeitfenster auf Änderungsrate in Prozent. Wenn die Bedingung ausgewertet wird, berechnet Monitoring die Änderungsrate des Messwerts als Prozentsatz und vergleicht diesen Prozentsatz dann mit dem Schwellenwert der Bedingung. Dieser Vergleich umfasst zwei Schritte:
- Wenn die Zeitachse die Messwertart
DELTA
oderCUMULATIVE
hat, wird sie in eine Zeitachse mit der MesswertartGAUGE
konvertiert. Informationen zur Conversion finden Sie unter Arten, Typen und Conversions. - Monitoring berechnet die Veränderung in Prozent durch einen Vergleich des Durchschnittswerts im letzten 10-minütigen gleitenden Fenster mit dem Durchschnittswert aus dem 10-minütigen gleitenden Fenster vor dem Beginn des Ausrichtungszeitraums.
Das gleitende Zeitfenster von zehn Minuten, das für Vergleiche in einer Benachrichtigungsrichtlinie für die Änderungsrate verwendet wird, kann nicht geändert werden. Sie geben den Ausrichtungszeitraum jedoch beim Erstellen der Bedingung an.
Nächste Schritte
- Sie müssen MQL verwenden, um eine Richtlinie zu erstellen, die den Wert einer Zeitachse mit einem dynamischen Schwellenwert vergleicht. Weitere Informationen finden Sie unter Dynamische Schweregrade mit MQL erstellen.
Die Anleitung auf dieser Seite gilt für alle Benachrichtigungsrichtlinien. Die folgenden Dokumente enthalten Anleitungen für bestimmte Konfigurationen: