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
<a name="Create_PromQL_Alarm"></a>

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](alarm-promql.md)

## Erstellen eines PromQL-Alarms mit dem AWS-Managementkonsole
<a name="promql-alarm-create-console"></a>

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**

1. Öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)

1. Wählen Sie im Navigationsbereich zuerst **Alarme** und dann **Alle Alarme** aus.

1. Wählen Sie **Create alarm** (Alarm erstellen) aus.

1. Wählen Sie **PromQL** als Metriktyp.

1. Geben Sie im **Editor-Modus** die PromQL-Abfrage ein:

   ```
   my_gauge_metric < 20
   ```

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

1. Konfigurieren Sie Benachrichtigungen und Aktionen nach Bedarf.

1. Geben Sie einen Namen und eine Beschreibung für den Alarm ein.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie **Alarm erstellen** aus.

## Einen PromQL-Alarm erstellen ()AWS CLI
<a name="promql-alarm-create-cli"></a>

Verwenden Sie die [PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)API-Aktion, um einen PromQL-Alarm zu erstellen.

**Example 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
```

**Example 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
```

**Example 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
<a name="promql-alarm-create-query-studio"></a>

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**

1. Öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)

1. Wählen Sie im Navigationsbereich unter **Metrics** die Option **Query Studio (Preview)** aus.

1. Wählen Sie **PromQL** aus dem Drop-down-Menü für die Abfragesprache aus.

1. 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
     ```

1. Wählen Sie **Ausführen**, um die Abfrage auszuführen und zu überprüfen, ob sie die erwarteten Ergebnisse zurückgibt.

1. Wählen Sie im Aktionsmenü die Option **Alarm erstellen** aus.

1. Sie werden auf die Seite zur CloudWatch Alarmerstellung weitergeleitet, auf der Ihre PromQL-Abfrage bereits ausgefüllt ist.

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

1. Konfigurieren Sie Benachrichtigungen und Aktionen nach Bedarf.

1. Geben Sie einen Namen und eine Beschreibung für den Alarm ein.

1. Wählen Sie **Weiter** aus.

1. 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 wie`sum`, oder`avg`, um das Ergebnis auf eine einzige Reihe `topk` zu reduzieren, bevor Sie den Alarm erstellen.