Benachrichtigungsrichtlinien mit PromQL

Auf dieser Seite werden verschiedene Methoden zum Erstellen von Benachrichtigungsrichtlinien mit einer PromQL-Abfrage in ihrer Bedingung erläutert.

Benachrichtigungsrichtlinien mit einer PromQL-basierten Bedingung bieten eine Open-Source-Alternative zur Konfiguration von Bedingungen für Benachrichtigungsrichtlinien (Monitoring Query Language, MQL). Sie können PromQL-Abfragen verwenden, um komplexe Bedingungen mit Features wie Verhältnissen, dynamischen Schwellenwerten und kombinierten Messwerten zu erstellen.

Wenn Sie Prometheus in Umgebungen außerhalb von Google Cloud oder Benachrichtigungen in Managed Service for Prometheus verwenden, können Sie Ihre Prometheus-Benachrichtigungsregeln zu Benachrichtigungsrichtlinien mit einer PromQL-basierten Bedingung migrieren. Auf diese Weise können Sie alle Benachrichtigungsrichtlinien in Cloud Monitoring verwalten.

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

• Allgemeine Informationen zur Verwendung von PromQL in Monitoring finden Sie unter PromQL in Cloud Monitoring.
• Allgemeine Informationen zu Benachrichtigungsrichtlinien finden Sie unter Verhalten von messwertbasierten Benachrichtigungsrichtlinien.

Überblick

Sie können Benachrichtigungsrichtlinien mit einer PromQL-basierten Bedingung so erstellen:

• Erstellen Sie in der Google Cloud Console eine Benachrichtigungsrichtlinie und definieren Sie eine PromQL-Abfrage im Codeeditor.

• Erstellen Sie mithilfe der gcloud CLI oder des Konstrukts AlertPolicy in der Monitoring API eine Benachrichtigungsrichtlinie mit einer PromQL-basierten Bedingung.

• Migrieren Sie Ihre Prometheus-Benachrichtigungsregeln und -Benachrichtigungskanäle über die Google Cloud CLI zu Cloud Monitoring.

Vorfälle, die von einer Benachrichtigungsrichtlinie mit einer PromQL-basierten Bedingung erstellt werden, werden in der Google Cloud Console zusammen mit Ihren anderen Vorfällen angezeigt. Sie können in der Google Cloud Console mit diesen Vorfällen interagieren.

Hinweis: Bei Vorfällen, die von einer Benachrichtigungsrichtlinie mit einer PromQL-basierten Bedingung erstellt werden, gilt nicht die Dauer des automatischen Schließens der Benachrichtigungsrichtlinie. Stattdessen wird der Vorfall automatisch geschlossen, wenn eine festgelegte Zeit nach der letzten Erfüllung der Bedingung erreicht wird. Diese Zeit ist mit 270 Sekunden der größere Wert und doppelt so hoch wie das Auswertungsintervall der Bedingung.

Die Bedingungen der PromQL-Benachrichtigungsrichtlinie können auf jeden Messwert in Cloud Monitoring verweisen, einschließlich Google Cloud-Systemmesswerten, benutzerdefinierten und logbasierten Messwerten sowie Prometheus-Messwerten. Sie müssen die Namen von Nicht-Prometheus-Messwerten in die PromQL-Messwertsyntax umwandeln. Weitere Informationen finden Sie unter Monitoring-Messwerte zu PromQL zuordnen.

Einschränkungen

Eine Benachrichtigungsrichtlinie mit einer PromQL-basierten Bedingung kann ein Zeitfenster für Wiederholungen von höchstens 24 Stunden und einen Ausrichtungszeitraum von maximal 24 Stunden haben. Die Summe aus Fenster für den erneuten Test und Ausrichtungszeitraum darf höchstens 25 Stunden betragen.

Wenn Ihre Prometheus-Benachrichtigungsregel auf einen benutzerdefinierten Messwert verweist, müssen Sie zuerst einen entsprechenden benutzerdefinierten Messwertdeskriptor in Cloud Monitoring haben.

Preise

Im Allgemeinen sind Cloud Monitoring-Systemmesswerte kostenlos, Messwerte von externen Systemen, Agents oder Anwendungen nicht. Abrechenbare Messwerte werden entweder nach der Anzahl der Byte oder der Anzahl der aufgenommenen Stichproben berechnet.

Weitere Informationen zu den Cloud Monitoring-Preisen finden Sie in den folgenden Dokumenten:

• Cloud Monitoring-Preisübersicht
• Cloud Monitoring-Preise.

Nächste Schritte

Informationen zum Erstellen von Benachrichtigungsrichtlinien mit einer PromQL-Abfrage in der Bedingung mithilfe der Google Cloud Console finden Sie unter Benachrichtigungsrichtlinien mit einer PromQL-basierten Bedingung erstellen (Console).

Informationen zum Erstellen von Benachrichtigungsrichtlinien mit PromQL direkt über die Cloud Monitoring API finden Sie unter Benachrichtigungsrichtlinien mit einer PromQL-basierten Bedingung (API) erstellen.

Informationen zum Migrieren von PromQL-Benachrichtigungsregeln zu Benachrichtigungsrichtlinien mit einer PromQL-Abfrage finden Sie unter Benachrichtigungsregeln und Empfänger von Prometheus migrieren.

Informationen zum Importieren von Grafana-Dashboards finden Sie unter Grafana-Dashboards in Cloud Monitoring importieren.