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.

# Verwendung von PromQL in Alarmen
<a name="CloudWatch-PromQL-Alarms"></a>

Sie können CloudWatch Alarme erstellen, die PromQL-Abfragen verwenden, um Ihre Metriken zu überwachen. PromQL-Alarme werten einen PromQL-Ausdruck aus und lösen basierend auf den Abfrageergebnissen Änderungen des Alarmstatus aus.

Informationen zu Alarmkonzepten finden Sie unter. [Konzepte](alarm-concepts.md)

Hinweise zu Alarmdatenabfragen finden Sie unter[Abfragen von Alarmdaten](alarm-data-queries.md).

Hinweise zu Alarmaktionen finden Sie unter[Alarmaktionen](alarm-actions.md).

Hinweise zu Alarmgrenzwerten finden Sie unter[Einschränkungen](alarm-limits.md).

## Einen PromQL-Alarm erstellen
<a name="CloudWatch-PromQL-Alarms-Create"></a>

Sie können einen PromQL-Alarm von der CloudWatch Konsole, der oder der API aus erstellen. AWS CLI CloudWatch 

**Um einen PromQL-Alarm von der Konsole aus zu erstellen**

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

1. Wählen Sie im Navigationsbereich **Alarms** (Alarme) und **All alarms** (Alle Alarme) aus.

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

1. Wählen Sie **Metrik auswählen** und dann die Registerkarte **PromQL**.

1. Geben Sie Ihre PromQL-Abfrage ein. Die Abfrage muss eine einzelne Zeitreihe zurückgeben, damit der Alarm ausgewertet werden kann.

1. Konfigurieren Sie die Alarmbedingungen, einschließlich des Schwellenwerts, des Bewertungszeitraums und der zu meldenden Datenpunkte.

1. Konfigurieren Sie die Alarmaktionen, z. B. Amazon SNS SNS-Benachrichtigungen.

1. Geben Sie einen Namen und eine Beschreibung für den Alarm ein und wählen Sie dann **Alarm erstellen**.

Sie können einen PromQL-Alarm auch direkt [Ausführen von PromQL-Abfragen in Query Studio (Vorschau)](CloudWatch-PromQL-QueryStudio.md) nach der Ausführung einer Abfrage erstellen, die eine einzelne Zeitreihe zurückgibt.

## Erstellen eines CloudWatch Alarms mit PromQL zur Erkennung von Anomalien
<a name="promql_alarm_anomaly_detection"></a>

Sie können einen PromQL-Alarm erstellen, der ausgelöst wird, wenn eine Metrik einen durch statistische Grenzen definierten erwarteten Bereich überschreitet. Die Alarmabfrage kombiniert Ober- und Untergrenzen zu einem einzigen Ausdruck, der nur die anomalen Datenpunkte zurückgibt. Jede von der Abfrage zurückgegebene Zeitreihe gilt als fehlerhaft.

Der folgende Beispielausdruck erkennt, wenn eine Kennzahl für eine Anzeigenanfrage innerhalb eines Zeitfensters von 60 Minuten 3 Standardabweichungen vom Median überschreitet:

```
1 * {"app.ads.ad_requests"} > quantile_over_time(0.5, {"app.ads.ad_requests"}[60m] offset 1m)
    + 3 * stddev_over_time({"app.ads.ad_requests"}[60m] offset 1m)
or
1 * {"app.ads.ad_requests"} < clamp_min(
    quantile_over_time(0.5, {"app.ads.ad_requests"}[60m] offset 1m)
    - 3 * stddev_over_time({"app.ads.ad_requests"}[60m] offset 1m),
0)
```

Dieser Ausdruck funktioniert für mehrere Labelwerte, sodass der Alarm Anomalien in Ihrer gesamten Flotte verfolgen kann. Jede Zeitreihe, bei der ein Verstoß vorliegt, wird separat erfasst. Weitere Informationen darüber, wie PromQL-Alarme Mitwirkende bewerten, finden Sie unter. [PromQL-Alarme](alarm-promql.md)

Sie können den Multiplikator und das Zeitfenster an das Verhalten Ihrer Metrik anpassen. Ein höherer Multiplikator führt zu breiteren Grenzen mit weniger falsch positiven Ergebnissen. Ein längeres Zeitfenster gleicht kurzfristige Spitzen aus. Die `clamp_min` Funktion verhindert, dass die Untergrenze bei Kennzahlen, die keine negativen Werte haben können, negativ wird.

Weitere Informationen zum Aufbau von Bändern zur Erkennung von Anomalien mit PromQL finden Sie unter. [Erkennung von Anomalien mit PromQL](CloudWatch_Anomaly_Detection.md#anomaly_detection_promql)