Benachrichtigungsrichtlinien für fehlende Messwerte erstellen

In diesem Dokument wird beschrieben, wie Sie mit der Google Cloud Console eine Benachrichtigungs richtlinie erstellen, die Benachrichtigungen sendet, wenn eine überwachte Zeit achse für einen bestimmten Zeitraum keine Daten enthält.

Bei Bedingungen für fehlende Messwerte muss innerhalb des maximalen Zeitraums nach Installation oder Änderung der Richtlinie mindestens eine erfolgreiche Messung durchgeführt werden, d. h. eine Messung, bei der Daten abgerufen werden. Dieser Zeitraum wird als Zeit bis zum Auslösen bei Ausbleiben von Daten bezeichnet. Die maximal konfigurierbare Zeit bis zum Auslösen bei Ausbleiben von Daten beträgt 23,5 Stunden.

Nehmen wir beispielsweise an, Sie legen die Zeit bis zum Auslösen bei Ausbleiben von Daten in einer Richtlinie für einen fehlenden Messwert auf 30 Minuten fest. Die Bedingung wird nicht erfüllt, wenn das Subsystem, das Messwertdaten schreibt, noch nie einen Datenpunkt geschrieben hat. Das Subsystem muss mindestens einen Datenpunkt ausgeben, auf den 30 Minuten lang keine weiteren Datenpunkte folgen dürfen.

Dieser Inhalt gilt nicht für logbasierte Benachrichtigungsrichtlinien. Informationen zu logbasierten Benachrichtigungsrichtlinien, die Sie informieren, wenn eine bestimmte Nachricht in Ihren Logs angezeigt wird, finden Sie unter Logs überwachen.

In diesem Dokument wird Folgendes nicht beschrieben:

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

  1. Bitten Sie Ihren Administrator, Ihnen die Monitoring Editor (roles/monitoring.editor) IAM-Rolle für Ihr Projekt zuzuweisen, um die Berechtigungen zu 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 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.

  2. Machen Sie sich mit den allgemeinen Konzepten von Benachrichtigungsrichtlinien vertraut. Informationen zu diesen Themen finden Sie unter Benachrichtigungen – Übersicht.

  3. Konfigurieren Sie die Benachrichtigungskanäle, die Sie für Benachrichtigungen verwenden möchten. Aus Redundanzgründen 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 Benachrichtigungen sendet, wenn eine überwachte Zeitachse für eine bestimmte Zeit bis zum Auslösen bei Ausbleiben von Daten keine Daten enthält:

  1. Rufen Sie in der Google Cloud Console die  Benachrichtigungen Seite 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.
  3. Wählen Sie Richtlinie erstellen aus.

  4. Wählen Sie die zu überwachende Zeitreihe aus:

    1. Klicken Sie auf Messwert auswählen, wählen Sie in den Menüs einen Ressourcentyp und Messwerttyp aus und klicken Sie dann auf Anwenden.

      Das Menü Messwert auswählen enthält Funktionen, mit denen Sie die verfügbaren Messwerttypen suchen können:

      • Verwenden Sie die  Filterleiste, um einen bestimmten Messwerttyp zu finden. Wenn Sie beispielsweise util eingeben, werden im Menü nur Einträge angezeigt, die util enthalten. Einträge werden angezeigt, wenn sie einen Test des Typs „enthält“ (ohne Berücksichtigung der Groß-/Kleinschreibung) bestehen.

      Sie können jeden integrierten Messwert oder jeden benutzerdefinierten Messwert überwachen.

    2. Optional: Wenn Sie eine Teilmenge der Zeitachsen überwachen möchten, die mit den im vorherigen Schritt ausgewählten Messwert- und Ressourcentypen übereinstimmen, klicken Sie auf Filter hinzufügen. Wählen Sie im Filterdialog 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 Zeitreihendaten abzugleichen, deren Zonennamen mit us beginnen und mit a enden. Weitere Informationen finden Sie unter Ausgewählte Zeitachsen filtern.

    3. Optional: Wenn Sie ändern möchten, wie die Punkte in einer Zeitreihe ausgerichtet werden, legen Sie im Bereich Daten transformieren die Felder Rollierendes Zeitfenster und Fensterfunktion für rollierendes Zeitfenster fest.

      Wenn Sie einen logbasierten Messwert überwachen, sollte das Menü Rollierendes Zeitfenster auf mindestens 10 Minuten festgelegt sein.

      In diesen Feldern wird angegeben, wie die in einem Fenster aufgezeichneten Punkte kombiniert werden. Nehmen wir beispielsweise an, das Fenster beträgt 15 Minuten und die Fensterfunktion ist max. Der ausgerichtete Punkt ist der Höchstwert aller Punkte in den letzten 15 Minuten. Weitere Informationen finden Sie unter Ausrichtung: Regularisierung innerhalb der Reihe.

    4. 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, können Sie den Durchschnitt der CPU-Auslastung für alle VMs in einer Zone berechnen und diesen Durchschnitt überwachen. Standardmäßig werden Zeitachsen nicht kombiniert. Allgemeine Informationen finden Sie unter Reduzierung: Zeitachsen kombinieren.

      So kombinieren Sie alle Zeitachsen:

      1. Klicken Sie im Bereich Zeitachsenübergreifend auf Maximieren.
      2. Legen Sie für das Feld Zeitreihenaggregation einen anderen Wert als none fest. Wenn Sie beispielsweise den Durchschnittswert der Zeitachsen anzeigen möchten, wählen Sie mean aus.
      3. Achten Sie darauf, dass das Feld Zeitachsen gruppieren nach leer ist.

      So kombinieren oder gruppieren Sie Zeitachsen nach Labelwerten:

      1. Klicken Sie im Bereich Zeitachsenübergreifend auf Maximieren.
      2. Legen Sie für das Feld Zeitreihenaggregation einen anderen Wert als none fest.
      3. 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 das Aggregationsfeld auf mean setzen, wird im Diagramm für jede Zone, für die Daten vorhanden sind, eine Zeitachse angezeigt. Die für eine bestimmte Zone angezeigte Zeitachse ist der Durchschnitt aller Zeitachsen mit dieser Zone.

    5. Klicken Sie auf Weiter.

  5. Konfigurieren Sie den Auslöser für die Bedingung:

    1. Wählen Sie Fehlende Messwerte als Bedingungstyp aus.

    2. Optional: Aktualisieren Sie das Menü Benachrichtigungsauslöser mit den folgenden Werten:

      • Any time series violates (Wenn eine Zeitachse verstößt): Standardeinstellung. Jede Zeitachse, bei der für die gesamte Zeit bis zum Auslösen bei Ausbleiben von Daten keine Daten vorhanden sind, führt dazu, dass die Bedingung erfüllt ist.

      • Percent of time series violates (Prozent der Zeitachsen verstößt): Bei einem bestimmten Prozentsatz der Zeitachsen müssen für die gesamte Zeit bis zum Auslösen bei Ausbleiben von Daten keine Daten vorhanden sein , bevor die Bedingung erfüllt ist. Sie können beispielsweise benachrichtigt werden, wenn bei 50% der überwachten Zeitachsen für die gesamte Zeit bis zum Auslösen bei Ausbleiben von Daten keine Daten vorhanden sind.

      • Number of time series violates (Anzahl der Zeitachsen verstößt): Bei einer bestimmten Anzahl von Zeitachsen müssen für die gesamte Zeit bis zum Auslösen bei Ausbleiben von Daten keine Daten vorhanden sein, bevor die Bedingung erfüllt ist. Sie können beispielsweise benachrichtigt werden, wenn bei 32 der überwachten Zeitachsen für die gesamte Zeit bis zum Auslösen bei Ausbleiben von Daten keine Daten vorhanden sind.

      • All time series violate (Wenn alle Zeitachsen verstoßen): Bei allen Zeitachsen müssen für die gesamte Zeit bis zum Auslösen bei Ausbleiben von Daten keine Daten vorhanden sein, bevor die Bedingung erfüllt ist.

      Informationen zu den Intervallen, die Monitoring zum Ausrichten und Messen von Zeitreihendaten verwendet, finden Sie unter Ausrichtungszeiträume und Fenster zum nochmaligen Testen.

    3. Geben Sie im Feld Zeit bis zum Auslösen bei Ausbleiben von Daten an, wie lange keine Messwertdaten vorhanden sein dürfen, bevor Sie von Monitoring benachrichtigt werden.

    4. Klicken Sie auf Weiter.

  6. 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 sie kombiniert werden sollen. Weitere Informationen finden Sie unter Richtlinien mit mehreren Bedingungen.

    So erstellen Sie eine Benachrichtigungsrichtlinie mit mehreren Bedingungen:

    1. Klicken Sie für jede zusätzliche Bedingung auf Benachrichtigungsbedingung hinzufügen und konfigurieren Sie die jeweilige Bedingung.
    2. Klicken Sie auf Weiter und konfigurieren Sie, wie Bedingungen kombiniert werden.
    3. Klicken Sie auf Weiter , um mit der Einrichtung von Benachrichtigungen und Dokumentation fortzufahren.

  7. Konfigurieren Sie die Benachrichtigung und fügen Sie Nutzerlabels hinzu:

    1. Maximieren Sie das Menü Benachrichtigungen und Name und wählen Sie die gewünschten Benachrichtigungskanäle aus. Aus Redundanzgründen empfehlen wir, einer Benachrichtigungsrichtlinie mehrere Arten von Benachrichtigungskanälen hinzuzufügen. Weitere Informationen finden Sie unter Benachrichtigungskanäle verwalten.

    2. Optional: Wenn Sie in Ihrer Benachrichtigung anstelle der Standardbetreffzeile eine benutzerdefinierte Betreffzeile verwenden möchten, aktualisieren Sie das Feld Betreffzeile der Benachrichtigung.

    3. Optional: Wenn Sie benachrichtigt werden möchten, wenn ein Vorfall geschlossen wird, wählen Sie Beim Schließen von Vorfällen benachrichtigen aus. Wenn Sie eine Benachrichtigungsrichtlinie mit der Google Cloud Console erstellen, werden Benachrichtigungen standardmäßig nur beim Erstellen von Vorfällen gesendet.

    4. Optional: Wenn Sie ändern möchten, wie lange Monitoring wartet, bevor ein Vorfall geschlossen wird, nachdem keine Daten mehr eingehen, wählen Sie im Menü Dauer bis zur automatischen Schließung von Vorfällen eine Option aus. Wenn keine Daten mehr eingehen, wartet Monitoring standardmäßig sieben Tage, bevor ein offener Vorfall geschlossen wird.

    5. Optional: Wenn Sie Ihre Benachrichtigungsrichtlinie mit einer App Hub Anwendung verknüpfen möchten, wählen Sie im Anwendungs-Labels Bereich eine Anwendung und entweder einen Dienst oder eine Arbeitslast aus. Diese Labels werden in Vorfällen und Benachrichtigungen angezeigt.

    6. Optional: Wählen Sie im Menü Schweregrad der Richtlinie eine Option aus. In Vorfällen und Benachrichtigungen wird der Schweregrad angezeigt.

    7. Optional: So fügen Sie der Benachrichtigungsrichtlinie benutzerdefinierte Labels hinzu:

      1. 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.
      2. 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 Richtlinienlabels verwenden können, um Ihre Benachrichtigungen zu verwalten, finden Sie unter Vorfälle mit Labels versehen.

  8. Optional: Geben Sie im Bereich Dokumentation alle Inhalte ein, die in die Benachrichtigung aufgenommen werden sollen.

    Sie können die Dokumentation mit Nur-Text, Markdown und Variablen formatieren. Sie können auch Links einfügen, die Nutzern bei der Fehlerbehebung helfen,z. B. Links zu internen Playbooks, Google Cloud Dashboards und externen Seiten. Die folgende Dokumentationsvorlage beschreibt beispielsweise einen Vorfall zur CPU-Auslastung für eine gce_instance-Ressource und enthält mehrere Variablen, mit denen auf die REST-Ressourcen für Benachrichtigungsrichtlinien und -bedingungen verwiesen wird. Die Dokumentationsvorlage verweist die Leser dann auf externe Seiten, die bei der Fehlerbehebung helfen.

    Wenn Benachrichtigungen erstellt werden, ersetzt Monitoring die Dokumentationsvariablen durch ihre Werte. Die Werte ersetzen die Variablen nur in Benachrichtigungen. Im Vorschaufenster 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

    Format in Benachrichtigung

    Beispiel dafür, wie die Dokumentation in einer Benachrichtigung dargestellt wird.

    Weitere Informationen finden Sie unter Benachrichtigungen mit benutzerdefinierter Dokumentation versehen und Kanalsteuerelemente verwenden.

  9. Klicken Sie auf Benachrichtigungsname und geben Sie einen Namen für die Benachrichtigungsrichtlinie ein.

  10. Klicken Sie auf Richtlinie erstellen.

Ausgewählte Zeitachsen filtern

Filter stellen sicher, 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 auch die Menge der überwachten Daten reduzieren, indem Sie die Aggregation anwenden. Filter stellen sicher, dass nur Zeitachsen verwendet werden, die bestimmte Kriterien erfüllen. Wenn Sie Filter anwenden, müssen weniger Zeitachsen ausgewertet werden, was die Leistung der Benachrichtigung verbessern kann.

Ein Filter besteht aus einem Label, einem Vergleichsoperator und einem Wert. Wenn Sie beispielsweise alle Zeitreihen abgleichen möchten, deren zone Label mit "us-central1" beginnt, können Sie den Filter zone=~"us-central1.*" verwenden, der einen regulären Ausdruck für den Vergleich verwendet.

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 nach 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. Wählen Sie den Vergleichsoperator aus und wählen Sie dann den Wert aus oder geben Sie ihn ein. Im Drop-down-Menü werden nur Werte aufgeführt, die in der letzten Woche angezeigt wurden. Sie können aber einen beliebigen Wert eingeben. In jeder Zeile der folgenden Tabelle sind ein Vergleichsoperator, seine Bedeutung und ein Beispiel aufgeführt:

OperatorBedeutungBeispiel
= 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")