Benachrichtigungsrichtlinien mit einer PromQL-basierten Bedingung erstellen (Console)

Auf dieser Seite wird beschrieben, wie Sie mit der Google Cloud Console eine Benachrichtigungsrichtlinie mit einer PromQL-basierten Bedingung erstellen.

Hinweise

1. Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Editor (roles/monitoring.editor) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von Benachrichtigungsrichtlinien mit einer PromQL-basierten Bedingung in der 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 und PromQL in Cloud Monitoring vertraut. Weitere Informationen finden Sie unter folgenden Links:

   • Benachrichtigungen – Übersicht
   • PromQL in Cloud Monitoring

3. Konfigurieren Sie die Benachrichtigungskanäle, über die Sie Benachrichtigungen erhalten möchten. Aus Gründen der Redundanz empfehlen wir, mehrere Benachrichtigungskanäle zu erstellen. Weitere Informationen finden Sie unter Benachrichtigungskanäle erstellen und verwalten.

4. Wenn in der PromQL-Abfrage in Ihrer Benachrichtigungsrichtlinie ein benutzerdefinierter Messwert verwendet wird, muss dieser bereits vorhanden sein.

PromQL-Benachrichtigungsrichtlinien erstellen

So erstellen Sie eine Benachrichtigungsrichtlinie mit einer PromQL-basierten Bedingung in der Google Cloud Console:

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. Klicken Sie auf der Seite Benachrichtigungen auf Richtlinie erstellen.

3. Wählen Sie unter Richtlinienkonfigurationsmodus die Option Code-Editor (MQL oder PromQL) aus.

4. Prüfen Sie, ob PromQL in der Ein-/Aus-Schaltfläche PromQL ausgewählt ist. Die Sprachschaltfläche befindet sich in derselben Symbolleiste, mit der Sie Ihre Abfrage formatieren können.

5. Geben Sie die PromQL-Abfrage ein, mit der die zu überwachenden Daten ausgewählt werden. Wenn Automatisch ausführen nicht aktiviert ist, klicken Sie auf Abfrage ausführen.

   In der folgenden Abfrage wird beispielsweise die Rate der Abrechnungsprotokolldaten zusammengefasst, die in einem 60-Sekunden-Intervall aufgenommen wurden, und ermittelt, ob die zusammengefasste Rate über 300 Byte liegt:

   sum(rate(logging_googleapis_com:billing_bytes_ingested{monitored_resource="global"}[60s]))>300
   

   Nach der Ausführung der Abfrage wird ein Diagramm angezeigt. Für ein Projekt hat diese Abfrage das folgende Ergebnis erzeugt:

   

6. Klicken Sie auf Weiter und konfigurieren Sie den Benachrichtigungstrigger.

   1. Wählen Sie einen Wert für den Benachrichtigungstrigger aus. Mit diesem Wert wird angegeben, wie viele von der Abfrage zurückgegebene Zeitreihen den Benachrichtigungsvorgang erfüllen müssen, bevor die Benachrichtigungsrichtlinie ausgelöst werden kann. Sie können aus den folgenden Kriterien auswählen:

      • Beliebige Zeitreihe.
      • Ein Prozentsatz der Zeitachsen.
      • Eine bestimmte Anzahl von Zeitachsen.
      • Alle Zeitachsen.

   2. Wählen Sie ein Zeitfenster für den Test aus. In diesem Feld wird festgelegt, wie lange die Bedingung erfüllt sein muss, bevor die Benachrichtigungsrichtlinie ausgelöst wird.

      Der Standardwert ist 0 Sekunden. Bei dieser Einstellung kann bereits eine einzelne Messung zu einer Benachrichtigung führen. Weitere Informationen und ein Beispiel finden Sie unter Einstellungen für den Ausrichtungszeitraum und die Dauer.

   3. Legen Sie mit einem Wert für das Bewertungsintervall fest, wie oft die PromQL-Abfrage für Benachrichtigungen ausgewertet werden soll.

      Hinweis: Vorfälle, die durch eine Benachrichtigungsrichtlinie mit einer PromQL-basierten Bedingung erstellt wurden, unterliegen nicht der automatischen Schließungsdauer der Benachrichtigungsrichtlinie. Stattdessen wird der Vorfall automatisch geschlossen, wenn nach dem letzten Mal, dass die Bedingung erfüllt wurde, ein bestimmter Zeitraum verstrichen ist. Dieser Wert ist der größere von 270 Sekunden und dem doppelten Auswertungsintervall der Bedingung.

   4. Geben Sie einen Namen für die Bedingung ein und klicken Sie auf Weiter.

7. Fügen Sie Benachrichtigungskanäle hinzu.

8. Optional: Fügen Sie Labels für Benachrichtigungsrichtlinien und Dokumentation hinzu.

9. Klicken Sie auf Name der Benachrichtigung und geben Sie einen Namen für die Benachrichtigungsrichtlinie ein.

10. Klicken Sie auf Richtlinie erstellen.

Eine vollständige Anleitung finden Sie unter Benachrichtigungsrichtlinien verwalten.