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.

Hinweis

  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 Siehe 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:

  3. Konfigurieren Sie die Benachrichtigungskanäle, über die Sie Benachrichtigungen empfangen möchten Warnungen. 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 Daten ausgewählt werden, die Sie überwachen möchten. Wenn Automatisch ausführen nicht aktiviert ist, klicken Sie auf Abfrage ausführen.

    Die folgende Abfrage fasst beispielsweise die Rate In einem 60-Sekunden-Intervall aufgenommene Abrechnungs-Logging-Daten und bestimmt, 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:

    Diagramm von einer PromQL-Benachrichtigungsbedingung, nachdem die Benachrichtigung angegeben wurde.

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

    1. Wählen Sie einen Wert für den Auslöser für Benachrichtigungen 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 Fenster für den erneuten Test aus. Mit diesem Feld wird festgelegt, wie lange Bedingung erfüllt sein muss, bevor die Benachrichtigungsrichtlinie ausgelöst wird.

      Der Standardwert ist 0 Sek.. Mit dieser Einstellung wird eine einzelne kann eine Benachrichtigung zur Folge haben. Weitere Informationen und ein Beispiel finden Sie unter Einstellungen für den Ausrichtungszeitraum und die Dauer.

    3. Um festzulegen, wie oft die Benachrichtigung die PromQL-Abfrage auswertet, wählen Sie Einen Wert für das Bewertungsintervall.

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

  7. Benachrichtigungskanäle hinzufügen

  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.

Die vollständigen Schritte finden Sie unter Benachrichtigungsrichtlinien verwalten.