Mit PromQL Benachrichtigungsrichtlinien erstellen

Auf dieser Seite wird beschrieben, wie Sie PromQL-basierte Benachrichtigungsrichtlinien in Cloud Monitoring erstellen. Mit PromQL-Abfragen können Sie komplexe Bedingungen mit Funktionen wie Verhältnissen, dynamischen Grenzwerten basierend auf einem anderen Messwert und kombinierten Messwerten erstellen. Sie können auch PromQL-basierte Benachrichtigungsrichtlinien für einen Zeitraum von bis zu zwei Jahren konfigurieren.

Wenn Sie Prometheus in Umgebungen außerhalb von Google Cloudverwenden oder wenn Sie Benachrichtigungen in Managed Service for Prometheus verwenden, können Sie Ihre Prometheus-Benachrichtigungsregeln zu PromQL-basierten Benachrichtigungsrichtlinien migrieren. So können Sie alle Ihre Benachrichtigungsrichtlinien in Cloud Monitoring verwalten.

Sie können auch Grafana-Dashboards in Cloud Monitoring importieren.

PromQL in Cloud Monitoring-Benachrichtigungsrichtlinien verwenden

Sie können PromQL-basierte Benachrichtigungsrichtlinien auf folgende Arten erstellen:

Benachrichtigungen, die durch eine PromQL-basierte Benachrichtigungsrichtlinie erstellt wurden, werden in der Google Cloud Console zusammen mit Ihren anderen Benachrichtigungen angezeigt. Sie können in der Google Cloud Console mit diesen Benachrichtigungen interagieren.

In den Bedingungen Ihrer PromQL-basierten Benachrichtigungsrichtlinie kann auf jeden Messwert in Cloud Monitoring verwiesen werden, einschließlich Systemmesswerte von Google Cloud , benutzerdefinierte und logbasierte Messwerte sowie Prometheus-Messwerte. Sie müssen die Namen von Nicht-Prometheus-Messwerten in die PromQL-Messwertsyntax übersetzen. Weitere Informationen finden Sie unter Monitoring-Messwerte PromQL zuordnen.

Messwertdaten aus über 2 Jahren abfragen

Im Gegensatz zu anderen Benachrichtigungsrichtlinientypen, die nur Abfragen über 25 Stunden an Messwertdaten unterstützen, können Sie mit PromQL Benachrichtigungen für bis zu 2 Jahre an Messwertdaten erstellen. Dies unterstützt Anwendungsfälle wie:

  • Anomalien werden erkannt, indem die letzten 5 Minuten mit dem gleichen 5‑Minuten-Zeitraum vor einer Woche verglichen werden.
  • Eine 7‑Tages-Benachrichtigungsrichtlinie für langsame Burn-Rates wird ausgeführt.
  • Der Durchschnittswert des letzten Monats wird ermittelt und eine Benachrichtigung wird gesendet, wenn die Daten der letzten Stunde mehr als drei Standardabweichungen von diesem Durchschnitt abweichen.
  • Mit der Funktion predict_linear können Sie die Daten der letzten Woche analysieren, um festzustellen, ob Sie am nächsten Tag einen Schwellenwert überschreiten werden.

PromQL-Benachrichtigungsrichtlinien, die auf den letzten 25 Stunden an Daten basieren (definiert als Summe aus dem Abgleichszeitraum und einer Zeitverschiebung durch den offset-Modifikator), können so oft wie alle 30 Sekunden ausgewertet werden. Richtlinien, die ältere Daten berücksichtigen, werden seltener ausgewertet. Der Mindestzeitraum hängt davon ab, wie weit in die Vergangenheit Ihre Benachrichtigungsrichtlinie zurückblickt:

Zeitraum für Abfragen Mindestauswertungsintervall (Standard)
Bis zu 25 Stunden1 30 Sekunden
25 Stunden bis 8 Tage 5 Minuten
8 bis 16 Tage 1 Stunde
16 bis 32 Tage 2 Stunden
32 bis 93 Tage 6 Stunden
93 Tage bis 2 Jahre 12 Stunden

1 Einige Messwerte aus Google Cloud -Diensten unterstützen nur 30-Sekunden-Auswertungsintervalle für bis zu 23 Stunden und 30 Minuten.

Legen Sie für alle rate-Zeiträume eine Dauer fest, die mindestens so lang ist wie das Bewertungsintervall, damit in Ihrer Benachrichtigungsrichtlinie keine Daten fehlen. Wenn Ihr Auswertungsintervall beispielsweise 1 Stunde beträgt, sollte Ihre Abfrage so aussehen: rate(metric[1h]).

Für Bedingungen, die mehr als 25 Stunden Daten umfassen, gilt ein Zeitlimit von 2 Minuten für die Abfrage. Das entspricht dem Zeitlimit im Metrics Explorer. Wenn für Ihre PromQL-Abfrage im Metrics Explorer kein Zeitlimit überschritten wird, wird auch für Ihre Benachrichtigung kein Zeitlimit überschritten.

PromQL-basierte Benachrichtigungsrichtlinien sind deutlich zuverlässiger, wenn sie auf den Daten der letzten 25 Stunden basieren. Für maximale Zuverlässigkeit sollte die Summe aus dem Testzeitraum, dem Anpassungszeitraum und einer Zeitverschiebung, die durch die Verwendung des Modifikators offset verursacht wird, höchstens 25 Stunden betragen.

Testwiederholungsfenster sind für PromQL-Benachrichtigungsabfragen deaktiviert, die auf Daten zugreifen, die älter als 25 Stunden sind.

Benachrichtigungen können nur für die letzten 25 Stunden von Daten für benutzerdefinierte Messwerte (das Präfix custom.googleapis.com) und benutzerdefinierte logbasierte Messwerte (das Präfix logging.googleapis.com/user/) eingerichtet werden.

Beschränkungen

Fügen Sie Ihren PromQL-basierten Benachrichtigungsrichtlinien keine Filter hinzu, die Systemmetadaten-Labels verwenden.

Eine PromQL-basierte Benachrichtigungsrichtlinie kann ein Testwiederholungsfenster von maximal 24 Stunden haben. Wenn Sie ein Retest-Fenster verwenden, darf die Summe aus Ihrem Retest-Fenster, dem Anpassungszeitraum und einer Zeitverschiebung, die durch die Verwendung des Modifikators offset verursacht wird, höchstens 25 Stunden betragen.

Wenn in Ihrer Prometheus-Benachrichtigungsregel auf einen Messwert verwiesen wird, müssen Sie zuerst einen entsprechenden Messwertdeskriptor in Cloud Monitoring haben, bevor Sie Ihre PromQL-basierte Benachrichtigungsrichtlinie erstellen können. Sie können diese Validierung jedoch überschreiben, indem Sie Ihre PromQL-basierte Benachrichtigungsrichtlinie mit der Cloud Monitoring API konfigurieren. Weitere Informationen finden Sie unter Prüfung auf Messwertexistenz deaktivieren.

Wenn Ihre Benachrichtigungsrichtlinie ein Verhältnis von Messwerten überwacht, legen Sie die Dauer auf mindestens das Doppelte des Bewertungsintervalls fest. Kürzere Zeiträume können zu Fehlalarmen führen. Weitere Informationen finden Sie unter Falsche Benachrichtigungen aufgrund von Anomalien bei der Berechnung von Verhältnissen.

Preise

Informationen zu den Preisen für Cloud Monitoring finden Sie auf der Seite Google Cloud Observability-Preise.