Benachrichtigungsrichtlinien mit einer PromQL-basierten Bedingung erstellen (Console)

Auf dieser Seite wird beschrieben, wie Sie mithilfe 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 zu gewähren, damit Sie die Berechtigungen 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 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.

  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, die Sie zum Empfangen von 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.

  4. Wenn die PromQL-Abfrage in Ihrer Benachrichtigungsrichtlinie einen benutzerdefinierten Messwert verwendet, muss dieser bereits vorhanden sein.

PromQL-Benachrichtigungsrichtlinien erstellen

So erstellen Sie über die Google Cloud Console eine Benachrichtigungsrichtlinie mit einer PromQL-basierten Bedingung:

  1. Wählen Sie im Navigationsbereich der Google Cloud Console Monitoring und anschließend  Benachrichtigungen aus:

    Zu Benachrichtigungen

  2. Klicken Sie auf der Seite Benachrichtigungen auf Richtlinie erstellen.

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

  4. Prüfen Sie, ob PromQL in der Ein-/Aus-Schaltfläche Sprache 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 der über ein 60-Sekunden-Intervall aufgenommenen Abrechnungs-Logging-Daten zusammen und bestimmt, ob die Summe über 300 Byte liegt:

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

    Nachdem Sie die Abfrage ausgeführt haben, wird ein Diagramm angezeigt. Für ein Projekt hat diese Abfrage das folgende Ergebnis erzeugt:

    Diagramm aus einer PromQL-Benachrichtigungsbedingung nach Angabe der Benachrichtigung.

  6. Klicken Sie auf Weiter und konfigurieren Sie den Trigger für die Benachrichtigung.

    1. Wählen Sie für Trigger für Benachrichtigungen einen Wert aus. Dieser Wert gibt an, wie viele Zeitachsen, die von der Abfrage zurückgegeben werden, dem Benachrichtigungsvorgang entsprechen 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 noch einmal testen aus. In diesem Feld wird definiert, wie lange die Bedingung erfüllt sein muss, bevor die Benachrichtigungsrichtlinie ausgelöst wird.

      Der Standardwert ist 0 sec. 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.

    3. Wählen Sie einen Wert für das Bewertungsintervall aus, um festzulegen, wie oft Benachrichtigungen die PromQL-Abfrage auswerten.

    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 eine 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.