Benachrichtigungsrichtlinien mit PromQL

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

Benachrichtigungsrichtlinien mit einer PromQL-basierten Bedingung sind eine Open-Source-Alternative zur Verwendung von MQL-Abfragen (Monitoring Query Language), um die Bedingungen für Benachrichtigungsrichtlinien zu konfigurieren. Mit PromQL-Abfragen lassen sich komplexe Bedingungen mit Funktionen wie Verhältnissen, dynamischen Grenzwerten und kombinierten Messwerten erstellen.

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

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

Übersicht

Sie haben folgende Möglichkeiten, Benachrichtigungsrichtlinien mit einer PromQL-basierten Bedingung zu erstellen:

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

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

  • Migrieren Sie Ihre Prometheus-Benachrichtigungsregeln und -kanäle mit der Google Cloud CLI zu Cloud Monitoring.

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

Die Bedingungen Ihrer 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-Syntax für Messwerte umwandeln. Weitere Informationen finden Sie unter Monitoring-Messwerte PromQL zuordnen.

Beschränkungen

Eine Benachrichtigungsrichtlinie mit einer PromQL-basierten Bedingung kann ein Zeitfenster für die Wiederholung von maximal 24 Stunden und einen Kalibrierungszeitraum von maximal 24 Stunden haben. Die Summe aus dem Zeitfenster für den Wiederholungstest und dem Kalibrierungszeitraum darf höchstens 25 Stunden betragen.

Wenn Ihre Prometheus-Benachrichtigungsregel auf einen benutzerdefinierten Messwert verweist, muss in Cloud Monitoring zuerst ein entsprechender Deskriptor für benutzerdefinierte Messwerte vorhanden sein.

Preise

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

Weitere Informationen zu den Preisen für Cloud Monitoring finden Sie in den folgenden Dokumenten:

Nächste Schritte

Informationen zum Erstellen von Benachrichtigungsrichtlinien mit einer PromQL-Abfrage in der Bedingung in 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 erstellen (API).

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.