Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Erstellen Sie einen Alarm mit einer PromQL-Abfrage
Sie können einen CloudWatch Alarm erstellen, der eine PromQL-Sofortabfrage verwendet, um die über den OTLP-Endpunkt aufgenommenen Metriken zu überwachen. CloudWatch Alle übereinstimmenden Zeitreihen, die von der Abfrage zurückgegeben werden, gelten als fehlerhaft, und der Alarm verfolgt jede Zeitreihe, bei der ein Verstoß vorliegt, als Mitverursacher. Weitere Informationen zur Funktionsweise von PromQL-Alarmen finden Sie unter. PromQL-Alarme
Erstellen eines PromQL-Alarms mit dem AWS-Managementkonsole
Dieses Beispiel zeigt, wie Sie einen Alarm erstellen, der eine Messgröße überwacht und Sie benachrichtigt, wenn ihr Wert unter 20 fällt.
Um einen PromQL-Alarm zu erstellen
Öffnen Sie die CloudWatch Konsole unter. https://console.aws.amazon.com/cloudwatch/
-
Wählen Sie im Navigationsbereich zuerst Alarme und dann Alle Alarme aus.
-
Wählen Sie Create alarm (Alarm erstellen) aus.
-
Wählen Sie PromQL als Metriktyp.
-
Geben Sie im Editor-Modus die PromQL-Abfrage ein:
my_gauge_metric < 20 -
Geben Sie unter Conditions (Bedingungen) Folgendes an:
-
Wählen Sie unter Bewertungsintervall, um zu definieren
1 minute, wie oft die PromQL-Abfrage ausgewertet wird. -
Geben Sie für Wartezeit die Dauer in Sekunden ein
120, die ein Mitwirkender überschreiten muss, bevor er in den ALARM-Status wechselt. -
Geben Sie für Wiederherstellungszeitraum die Dauer in Sekunden ein
300, die ein Mitwirkender nicht überschreiten darf, bevor er in den Status OK wechselt.
-
-
Konfigurieren Sie Benachrichtigungen und Aktionen nach Bedarf.
-
Geben Sie einen Namen und eine Beschreibung für den Alarm ein.
-
Wählen Sie Weiter aus.
-
Wählen Sie Alarm erstellen aus.
Einen PromQL-Alarm erstellen ()AWS CLI
Verwenden Sie die PutMetricAlarmAPI-Aktion, um einen PromQL-Alarm zu erstellen.
Beispiel Erstellen Sie einen PromQL-Alarm, der ausgelöst wird, wenn ein Messwert unter 20 fällt
aws cloudwatch put-metric-alarm \ --alarm-name MyPromQLAlarm \ --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20"}}' \ --evaluation-interval 60
Beispiel Erstellen Sie einen PromQL-Alarm mit einer Wartezeit
Dieser Alarm wartet 300 Sekunden (5 Minuten), bevor er in den ALARM Status wechselt, und wartet 600 Sekunden (10 Minuten), bevor er wiederhergestellt wird.
aws cloudwatch put-metric-alarm \ --alarm-name HighLatencyAlarm \ --evaluation-criteria '{"PromQLCriteria":{"Query":"histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m])) > 0.5","PendingPeriod":300,"RecoveryPeriod":600}}' \ --evaluation-interval 60
Beispiel Erstellen Sie einen PromQL-Alarm mit einer SNS-Benachrichtigungsaktion
aws cloudwatch put-metric-alarm \ --alarm-name MyPromQLAlarmWithAction \ --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20","PendingPeriod":0,"RecoveryPeriod":0}}' \ --evaluation-interval 60 \ --alarm-actions arn:aws:sns:us-east-1:123456789012:MyTopic
Einen PromQL-Alarm aus Query Studio erstellen
Dieses Beispiel zeigt, wie Sie in Query Studio einen PromQL-Alarm erstellen, der Sie benachrichtigt, wenn die durchschnittliche HTTP-Anforderungsdauer für einen Dienst 500 Millisekunden überschreitet.
Im Gegensatz zu CloudWatch Standardalarmen, bei denen der Schwellenwert als separater Schritt konfiguriert wird, definieren PromQL-Alarme den Alarmzustand (Schwellenwert) als Teil der Abfrage selbst. Beispielsweise sind der Vergleichsoperator (>) und der Schwellenwert (0.5) direkt in den PromQL-Ausdruck eingebettet.
Um einen PromQL-Alarm in Query Studio zu erstellen
Öffnen Sie die CloudWatch Konsole unter. https://console.aws.amazon.com/cloudwatch/
-
Wählen Sie im Navigationsbereich unter Metrics die Option Query Studio (Preview) aus.
-
Wählen Sie PromQL aus dem Drop-down-Menü für die Abfragesprache aus.
-
Erstellen Sie Ihre Abfrage in einem der folgenden Modi:
-
Wählen Sie im Builder-Modus einen Metriknamen aus dem Feld Metrik aus (z. B.
http.server.request.duration). Fügen Sie nach Bedarf Labelfilter hinzu (z. B.@resource.service.name=my-api). Um den Alarmschwellenwert zu definieren, wählen Sie eine Basisoperation (z. B.>) und geben Sie eine Zahl ein (z. B.0.5). -
Geben Sie im Codemodus den PromQL-Ausdruck direkt ein, zum Beispiel:
histogram_avg({"http.server.request.duration", "@resource.service.name"="my-api"}) > 0.5
-
-
Wählen Sie Ausführen, um die Abfrage auszuführen und zu überprüfen, ob sie die erwarteten Ergebnisse zurückgibt.
-
Wählen Sie im Aktionsmenü die Option Alarm erstellen aus.
-
Sie werden auf die Seite zur CloudWatch Alarmerstellung weitergeleitet, auf der Ihre PromQL-Abfrage bereits ausgefüllt ist.
-
Geben Sie unter Conditions (Bedingungen) Folgendes an:
-
Wählen Sie unter Bewertungsintervall, um zu definieren
1 minute, wie oft die PromQL-Abfrage ausgewertet wird. -
Geben Sie für Wartezeit die Dauer in Sekunden ein
60, die die Abfrage überschreiten muss, bevor sie in den ALARM-Status wechselt. Das bedeutet, dass die Latenz den Schwellenwert mindestens 60 Sekunden lang überschreiten muss, bevor der Alarm ausgelöst wird. -
Geben Sie als Wiederherstellungszeitraum die Dauer in Sekunden ein
120, die die Abfrage nicht überschreiten darf, bevor sie in den Status OK wechselt. Das bedeutet, dass die Latenz mindestens 120 Sekunden unter dem Schwellenwert bleiben muss, bevor der Alarm wiederhergestellt wird.
-
-
Konfigurieren Sie Benachrichtigungen und Aktionen nach Bedarf.
-
Geben Sie einen Namen und eine Beschreibung für den Alarm ein.
-
Wählen Sie Weiter aus.
-
Wählen Sie Alarm erstellen aus.
Anmerkung
Die PromQL-Abfrage muss eine einzelne Zeitreihe zurückgeben, um einen Alarm auszulösen. Wenn Ihre Abfrage mehrere Zeitreihen zurückgibt, verwenden Sie Aggregationsfunktionen wiesum, oderavg, um das Ergebnis auf eine einzige Reihe topk zu reduzieren, bevor Sie den Alarm erstellen.
