Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création d'une alarme à l'aide d'une requête ProMQL
<a name="Create_PromQL_Alarm"></a>

Vous pouvez créer une CloudWatch alarme qui utilise une requête instantanée ProMQL pour surveiller les métriques ingérées via le CloudWatch point de terminaison OTLP. Toutes les séries chronologiques correspondantes renvoyées par la requête sont considérées comme des violations, et l'alarme suit chaque série chronologique de violation en tant que contributrice. Pour plus d'informations sur le fonctionnement des alarmes ProMQL, consultez. [Alarmes ProMQL](alarm-promql.md)

## Création d'une alarme ProMQL à l'aide du AWS Management Console
<a name="promql-alarm-create-console"></a>

Cet exemple montre comment créer une alarme qui surveille une métrique de jauge et vous avertit lorsque sa valeur tombe en dessous de 20.

**Pour créer une alarme ProMQL**

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le panneau de navigation, choisissez **Alarms** (alertes), **All Alarms** (Toutes les alertes).

1. Choisissez **Create alarm (Créer une alerte)**.

1. Choisissez **ProMQL** pour le type de métrique.

1. En mode **éditeur**, entrez la requête ProMQL :

   ```
   my_gauge_metric < 20
   ```

1. Sous **Conditions**, spécifiez les éléments suivants :
   + Pour **Intervalle d'évaluation**, choisissez**1 minute**, pour définir la fréquence à laquelle la requête ProMQL est évaluée.
   + Pour **Période d'attente****120**, entrez la durée en secondes qu'un contributeur doit franchir avant de passer à l'état ALARM.
   + Pour la **période de récupération****300**, entrez la durée en secondes qu'un contributeur ne doit pas franchir avant de passer à l'état OK.

1. Configurez les notifications et les actions selon les besoins.

1. Ajoutez un nom et une description pour votre alarme.

1. Choisissez **Suivant**.

1. Sélectionnez **Créer une alerte**.

## Création d'une alarme ProMQL ()AWS CLI
<a name="promql-alarm-create-cli"></a>

Utilisez l'action [PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)API pour créer une alarme ProMQL.

**Example Créez une alarme ProMQL qui se déclenche lorsqu'une métrique de jauge tombe en dessous de 20**  

```
aws cloudwatch put-metric-alarm \
  --alarm-name MyPromQLAlarm \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20"}}' \
  --evaluation-interval 60
```

**Example Création d'une alarme ProMQL avec une période d'attente**  
Cette alarme attend 300 secondes (5 minutes) avant de passer à `ALARM` l'état, et attend 600 secondes (10 minutes) avant de se rétablir.  

```
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 Création d'une alarme ProMQL avec une action de notification SNS**  

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

## Création d'une alarme ProMQL depuis Query Studio
<a name="promql-alarm-create-query-studio"></a>

Cet exemple montre comment créer une alarme ProMQL à partir de Query Studio qui vous alerte lorsque la durée moyenne des requêtes HTTP pour un service dépasse 500 millisecondes.

Contrairement aux CloudWatch alarmes standard où le seuil est configuré comme une étape séparée, les alarmes ProMQL définissent la condition d'alarme (seuil) dans le cadre de la requête elle-même. Par exemple, l'opérateur de comparaison (`>`) et la valeur de seuil (`0.5`) sont intégrés directement dans l'expression ProMQL.

**Pour créer une alarme ProMQL à partir de Query Studio**

1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Dans le volet de navigation situé sous **Metrics**, choisissez **Query Studio (Preview)**.

1. Sélectionnez **ProMQL** dans le menu déroulant du langage de requête.

1. Créez votre requête en utilisant l'un des modes suivants :
   + En mode **Générateur**, sélectionnez un nom de métrique dans le champ **Métrique** (par exemple,`http.server.request.duration`). Ajoutez des filtres d'étiquette selon vos besoins (par exemple, `@resource.service.name` =`my-api`). Pour définir le seuil d'alarme, sélectionnez une **opération de base** (par exemple`>`) et entrez un **numéro** (par exemple,`0.5`).
   + En mode **Code**, entrez directement l'expression ProMQL, par exemple :

     ```
     histogram_avg({"http.server.request.duration", "@resource.service.name"="my-api"}) > 0.5
     ```

1. Choisissez **Exécuter** pour exécuter la requête et vérifier qu'elle renvoie les résultats attendus.

1. Choisissez **Créer une alarme** dans le menu Actions.

1. Vous êtes redirigé vers la page de création CloudWatch d'alarme avec votre requête ProMQL préremplie.

1. Sous **Conditions**, spécifiez les éléments suivants :
   + Pour **Intervalle d'évaluation**, choisissez**1 minute**, pour définir la fréquence à laquelle la requête ProMQL est évaluée.
   + Pour **Période d'attente****60**, entrez la durée en secondes que la requête doit enfreindre avant de passer à l'état ALARM. Cela signifie que la latence doit dépasser le seuil pendant au moins 60 secondes avant que l'alarme ne se déclenche.
   + Pour la **période de restauration****120**, entrez la durée en secondes que la requête ne doit pas enfreindre avant de passer à l'état OK. Cela signifie que la latence doit rester inférieure au seuil pendant au moins 120 secondes avant que l'alarme ne se rétablisse.

1. Configurez les notifications et les actions selon les besoins.

1. Ajoutez un nom et une description pour votre alarme.

1. Choisissez **Suivant**.

1. Sélectionnez **Créer une alerte**.

**Note**  
La requête ProMQL doit renvoyer une seule série chronologique pour créer une alarme. Si votre requête renvoie plusieurs séries chronologiques, utilisez des fonctions d'agrégation telles que `sum``avg`, ou `topk` pour réduire le résultat à une seule série avant de créer l'alarme.