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.

# Alarmes sur CloudWatch les requêtes Metrics Insights dans CloudWatch
<a name="cloudwatch-metrics-insights-alarms"></a>

Vous pouvez créer des alarmes sur des requêtes Metrics Insights. Cela vous permet d'avoir des alarmes qui suivent plusieurs ressources sans avoir besoin d'être mises à jour ultérieurement. La requête capte les nouvelles ressources et les ressources qui changent. Par exemple, vous pouvez créer une alerte qui surveille l'utilisation du CPU de votre flotte, et l'alerte évalue automatiquement les nouvelles instances que vous lancez après avoir créé l'alerte.

Dans un compte de surveillance configuré pour l'observabilité CloudWatch entre comptes, vos alarmes Metrics Insights peuvent surveiller les ressources des comptes sources et du compte de surveillance lui-même. Pour plus d’informations sur la façon de limiter vos requêtes d’alarme à un compte spécifique ou de regrouper les résultats par identifiant de compte, veuillez consulter les sections `WHERE` et `GROUP BY` dans [Composants et syntaxe des requêtes dans CloudWatch Metrics Insights](cloudwatch-metrics-insights-querylanguage.md).

**Utilisation des balises dans les requêtes d’alarme**

Vous pouvez créer des alarmes sur les requêtes Metrics Insights qui utilisent AWS des balises de ressources pour filtrer et regrouper les métriques. Pour utiliser des balises avec des alarmes, sur le [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/), choisissez **Paramètres**. **Sur la page **CloudWatch Paramètres**, sous **Activer les balises de ressources en télémétrie**, choisissez Activer.** Les alarmes contextuelles surveillent automatiquement des applications, des environnements ou des équipes spécifiques au fur et à mesure que les ressources changent.

Par exemple, vous pouvez créer une alarme qui surveille l’utilisation de l’UC pour toutes les instances Amazon EC2 balisées avec une application spécifique.

```
SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE tag.Application = 'Orders' AND tag.Environment = 'Prod'
```

Les alarmes basées sur des balises s’adaptent automatiquement lorsque vous ajoutez ou supprimez des ressources avec des balises correspondantes, offrant ainsi une surveillance dynamique alignée sur votre structure opérationnelle.

**Contents**
+ [Création d'une CloudWatch alarme Metrics Insights](cloudwatch-metrics-insights-alarm-create.md)

# Création d'une CloudWatch alarme Metrics Insights
<a name="cloudwatch-metrics-insights-alarm-create"></a>

**Pour créer une alarme sur une requête Metrics Insights à l'aide de la console**

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, sélectionnez **Métriques**, **Toutes les métriques**.

1. (Facultatif) Pour exécuter un exemple de requête préétablie, choisissez **Add query** (Ajouter une requête) et sélectionnez la requête à exécuter. Ou, vous pouvez choisir **Editor** (Éditeur) pour modifier l'exemple de requête, puis choisir **Run** (Exécuter) pour exécuter la requête modifiée. 

1. Pour créer votre propre requête, sélectionnez **Requête multi-sources**. Vous pouvez ensuite utiliser la vue **Constructeur**, la vue **Éditeur** ou une combinaison des deux. Vous pouvez passer d'une vue à l'autre à tout moment et voir votre travail en cours dans les deux vues. 

   Dans la vue **Builder** (Générateur), vous pouvez parcourir et sélectionner l'espace de noms des métriques, le nom de la métrique, le filtre, le groupe et les options de commande. Pour chacune de ces options, le générateur de requêtes vous propose une liste de sélections possibles de votre environnement parmi lesquelles choisir.

   Dans la vue **Editor** (Éditeur), vous pouvez commencer à écrire votre requête. Au fur et à mesure que vous tapez, l'éditeur propose des suggestions basées sur les caractères que vous avez saisis jusqu'à présent.

   Par exemple, lorsque vous créez votre requête Metrics Insights pour l’alarme, vous pouvez utiliser des balises pour filtrer et regrouper les métriques pour une surveillance plus ciblée.
   + Filtrer par balises : utilisez `WHERE tag.keyName = 'value'` pour surveiller les ressources avec des balises spécifiques

     ```
     SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE tag.Environment = 'Prod'
     ```
   + Combiner les balises avec les dimensions : mélangez les filtres de balises avec les dimensions de métriques existantes

     ```
     SELECT AVG(Duration) FROM "AWS/Lambda" WHERE tag.Application = 'OrderService' AND FunctionName = 'process%'
     ```
**Note**  
Lorsque vous utilisez des balises, les alarmes ne correspondent aux métriques que si les balises spécifiées existaient sur les ressources associées pendant la période évaluée.

1. Lorsque vous êtes satisfait de votre requête, sélectionnez **Run** (Exécuter).

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

1. Sous **Conditions**, spécifiez les éléments suivants :

   1. Pour ***metric*Whenever is**, spécifiez si la métrique doit être supérieure, inférieure ou égale au seuil. Dans **than... (à...)**, spécifiez la valeur de seuil.

   1. Sélectionnez **Additional configuration (Configuration supplémentaire)**. Pour **Datapoints to alarm (Points de données avant l'alerte)**, spécifiez le nombre de périodes d'évaluation (points de données) devant être à l'état `ALARM` pour déclencher l'alerte. Si les deux valeurs sont compatibles, vous créez une alerte qui passe à l'état `ALARM` lorsque le nombre de périodes consécutives dépasse ces valeurs.

      Pour créer une alerte M sur N, spécifiez pour la première valeur un nombre inférieur à celui de la seconde valeur. Pour plus d'informations, consultez . [Évaluation des alarmes](alarm-evaluation.md).

   1. Pour **Missing data treatment (traitement des données manquantes)**, choisissez comment l'alerte doit se comporter lorsqu'il manque certains points de données. Pour plus d'informations, consultez . [Configuration de la façon dont les CloudWatch alarmes traitent les données manquantes](alarms-and-missing-data.md).

1. Choisissez **Next (Suivant)**.

1. Sous **Notification**, sélectionnez la rubrique SNS qui doit recevoir une notification lorsque l'alerte passe à l'état `ALARM`, `OK` ou `INSUFFICIENT_DATA`.

   Pour que l'alerte envoie plusieurs notifications pour le même état d'alerte ou pour les différents états d'alerte, choisissez **Add notification (Ajouter une notification)**.

   Pour que l'alerte n'envoie pas de notifications, choisissez **Remove (Supprimer)**.

1. Pour que l'alerte exécute Auto Scaling, EC2 ou des actions du Systems Manager, cliquez sur le bouton approprié, puis choisissez l'état de l'alerte et l'action à effectuer. Les alertes peuvent effectuer des actions du Systems Manager uniquement lorsqu'elles passent à l'état ALARM. Pour plus d'informations sur les actions de Systems Manager, consultez les sections [Configuration CloudWatch pour créer à OpsItems partir d'alarmes](https://docs.aws.amazon.com/systems-manager/latest/userguide/OpsCenter-create-OpsItems-from-CloudWatch-Alarms.html) et [Création d'incidents](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-creation.html).
**Note**  
Pour créer une alerte qui exécute une action SSM Incident Manager, vous devez disposer de certaines autorisations. Pour plus d'informations, consultez les [exemples de politiques basées sur l'identité pour AWS Systems Manager Incident Manager](https://docs.aws.amazon.com/incident-manager/latest/userguide/security_iam_id-based-policy-examples.html).

1. Lorsque vous avez terminé, choisissez **Suivant**.

1. Saisissez un nom et une description pour l'alerte. Le nom ne doit contenir que des caractères ASCII. Sélectionnez ensuite **Next (Suivant)**.

1. Dans **Preview and create (Prévisualiser et créer)**, confirmez que les informations et les conditions sont telles que vous les voulez, puis choisissez **Create alarm (Créer une alerte)**.

**Pour créer une alarme sur une requête Metrics Insights à l'aide du AWS CLI**

Utilisez la commande `put-metric-alarm` et spécifiez une requête Metrics Insights dans le paramètre `metrics`. Par exemple, la commande suivante définit une alarme qui passe à l'état ALARM si l'une de vos instances dépasse 50 % d'utilisation du CPU.

```
aws cloudwatch put-metric-alarm —alarm-name Prod-App-CPU-Alarm —evaluation-periods 1 —comparison-operator GreaterThanThreshold —metrics '[{"Id":"m1","Expression":"SELECT MAX(CPUUtilization) FROM \"AWS/EC2\" WHERE tag.Environment = '\''Prod'\'' AND tag.Application = '\''OrderService'\''", "Period":60}]' —threshold 80
```