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.

# Tutoriel : Utiliser une fonction mathématique métrique pour supprimer une alarme
<a name="suppress-alarms-tutorial-suppress"></a>

Le didacticiel suivant explique comment supprimer une CloudWatch alarme à l'aide des mathématiques métriques.

**Exemple de scénario**

Une activité est prévue entre 1 h 00 et 3 h 00 UTC le mardi prochain. Vous souhaitez créer une fonction mathématique CloudWatch métrique qui remplace les points de données réels pendant cette période par 0 (un point de données inférieur au seuil défini). 

1. Évaluez les critères qui déclenchent votre alarme. La capture d'écran suivante fournit un exemple de critères d'alarme :  
![CloudWatch écran affichant les détails de l'alarme.](http://docs.aws.amazon.com/fr_fr/IDR/latest/userguide/images/metric-math-assess-alarm-criteria.png)

   L'alarme illustrée dans la capture d'écran précédente surveille la `UnHealthyHostCount` métrique pour un groupe cible d'Application Load Balancer. Cette alarme entre dans l'`ALARM`état lorsque la `UnHealthyHostCount` métrique est supérieure ou égale à 3 pour 5 points de données sur 5. L'alarme considère les données manquantes comme étant incorrectes (franchissant le seuil configuré).

1. Créez la fonction mathématique métrique.

   Dans cet exemple, l'activité planifiée a lieu entre 1 h 00 et 3 h 00 UTC le mardi suivant. Créez donc une fonction mathématique CloudWatch métrique qui remplace les points de données réels pendant cette période par 0 (un point de données inférieur au seuil défini). 

   Notez que le point de données de remplacement que vous devez configurer varie en fonction de la configuration de votre alarme. Par exemple, si vous avez une alarme qui surveille le taux de réussite HTTP, avec un seuil inférieur à 98, remplacez vos points de données réels pendant l'activité planifiée par une valeur supérieure au seuil configuré, 100. Voici un exemple de fonction mathématique métrique pour ce scénario.

   ```
   IF((DAY(m1) == 2 && HOUR(m1) >= 1 && HOUR(m1) < 3), 0, m1)
   ```

   La fonction mathématique métrique précédente contient les éléments suivants :
   + **JOUR (m1) == 2** : garantit que c'est mardi (lundi = 1, dimanche = 7).
   + **HEURE (m1) >= 1 && HEURE (m1) < 3** : Spécifie la plage horaire comprise entre 1 h et 3 h UTC.
   + **IF (condition, value\_if\_true, value\_if\_false)** : si les conditions sont vraies, la fonction remplace la valeur de la métrique par 0. Dans le cas contraire, la valeur d'origine (m1) est renvoyée.

   Pour plus d'informations sur la syntaxe et les fonctions disponibles, consultez [Syntaxe et fonctions mathématiques métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html#metric-math-syntax) dans le *guide de CloudWatch l'utilisateur Amazon*

1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. Choisissez **Alarmes**, puis localisez l'alarme à laquelle vous souhaitez ajouter la fonction mathématique métrique.

1. Dans la section des mathématiques métriques, choisissez **Modifier**.

1. Choisissez **Ajouter des données mathématiques**, puis **Commencer par une expression vide**.

1. Entrez votre expression mathématique, puis choisissez **Appliquer**.

   La métrique existante surveillée automatiquement par l'alarme devient **m1** et votre expression mathématique est **e1**, comme illustré dans l'exemple suivant :  
![CloudWatch écran affichant des expressions mathématiques métriques.](http://docs.aws.amazon.com/fr_fr/IDR/latest/userguide/images/metric-math-expression.png)

1. (Facultatif) Modifiez l'étiquette de l'expression mathématique métrique pour aider les autres utilisateurs à comprendre sa fonction et pourquoi elle a été créée, comme indiqué dans l'exemple suivant :  
![CloudWatch écran montrant la modification d'une étiquette d'expression de correspondance métrique.](http://docs.aws.amazon.com/fr_fr/IDR/latest/userguide/images/metric-math-edit-label.png)

1. Désélectionnez **m1**, sélectionnez **e1**, puis **sélectionnez Sélectionner** une métrique. Cela permet de configurer l'alarme pour qu'elle surveille directement l'expression mathématique au lieu de la métrique sous-jacente.

1. Choisissez **Passer à l'aperçu et créez**.

1. Vérifiez que l'alarme est configurée comme prévu, puis choisissez **Mettre à jour l'alarme pour enregistrer la modification**.

Dans l'exemple précédent, sans l'application de la fonction mathématique métrique, la `UnHealthyHostCount` métrique réelle aurait été signalée lors de l'activité planifiée. Cela aurait entraîné l'entrée en `ALARM` état de l' CloudWatch alarme et l'activation de la détection et de la réponse aux incidents, comme le montre l'exemple suivant :

![CloudWatch écran affichant les points de données menant à un état d'alarme.](http://docs.aws.amazon.com/fr_fr/IDR/latest/userguide/images/metric-math-example-alarm-state.png)


Lorsque la fonction mathématique métrique est en place, les points de données réels sont remplacés par 0 pendant l'activité, et l'alarme reste active, ce qui supprime `OK` l'engagement de détection et de réponse aux incidents. 

![CloudWatch écran affichant les points de données sans état d'alarme.](http://docs.aws.amazon.com/fr_fr/IDR/latest/userguide/images/metric-math-datapoints-no-alarm.png)