

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éez des CloudWatch alarmes pour les instances Amazon EC2 qui échouent aux vérifications de statut
<a name="creating_status_check_alarms"></a>

Vous pouvez utiliser les [métriques de vérification de statut](viewing_metrics_with_cloudwatch.md#status-check-metrics) pour créer des CloudWatch alarmes afin de vous avertir en cas d'échec de la vérification de statut d'une instance.

Les contrôles de statut et les alarmes de contrôle peuvent temporairement passer à un statut de *données insuffisant* s'il manque des points de données métriques. Bien que cela soit rare, cela peut se produire lorsqu'il y a une interruption dans les systèmes de rapports métriques, même lorsqu'une instance est saine. Nous vous recommandons de traiter cet état comme une donnée manquante plutôt que comme un échec de contrôle de statut ou comme le déclenchement d’une alarme. Ceci est particulièrement important lorsque vous effectuez des actions d’arrêt, de résiliation, de redémarrage ou de restauration sur l’instance en réponse.

------
#### [ Console ]

Cet exemple configure une alarme qui envoie une notification lorsqu’une instance échoue à un contrôle de statut. Vous pouvez éventuellement arrêter, résilier ou récupérer l’instance.

**Pour créer une alarme de contrôle de statut**

1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Dans le panneau de navigation, choisissez **Instances**.

1. Sélectionnez l’instance, choisissez l’onglet **Status Checks (Contrôles des statuts)**, puis choisissez **Actions**, **Create status check alarm (Créer une alarme de contrôle de statut)**.

1. Sur la page **Gérer les CloudWatch alarmes**, sous **Ajouter ou modifier une alarme**, choisissez **Créer une alarme**.

1. Pour **Alarm notification (Notification d’alarme)**, activez ou désactivez les notifications Amazon Simple Notiﬁcation Service (Amazon SNS). Sélectionnez une rubrique Amazon SNS existante ou entrez un nom pour créer une nouvelle rubrique.

   Si vous ajoutez une adresse e-mail à la liste des destinataires ou créez une nouvelle rubrique, Amazon SNS envoie un e-mail de confirmation à chaque nouvelle adresse. Chaque destinataire doit choisir le lien de confirmation dans l’e-mail. Seules les adresses confirmées reçoivent des notifications d’alerte.

1. Activez **Alarm action (Action d’alarme)** pour spécifier une action à effectuer lorsque l’alarme est déclenchée. Sélectionnez l’action.

1. Pour **Alarm thresholds (Seuils d’alarme)**, sélectionnez la métrique et les critères de l’alarme.

   Vous pouvez laisser les paramètres par défaut pour **Regrouper les échantillons par** (**Moyenne**) et **Type de données à échantillonner** (**Échec de la vérification de statut : soit**), ou vous pouvez les modifier en fonction de vos besoins.

   Dans **Consecutive period (Période consécutive)**, définissez le nombre de périodes que vous souhaitez évaluer et, dans **Period (Période)**, sélectionnez la période d’évaluation avant de déclencher l’alarme et d’envoyer un e-mail.

1. (Facultatif) Pour **Exemple de données de métrique**, choisissez **Ajouter au tableau de bord**.

1. Choisissez **Créer**.

Si vous devez apporter des modifications à une alarme de statut d’instance, vous pouvez modifier celle-ci.

**Pour modifier une alarme de contrôle de statut**

1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Dans le panneau de navigation, choisissez **Instances**.

1. Sélectionnez l'instance et choisissez **Actions**, **Surveillance**, **Gestion des CloudWatch alarmes**.

1. Sur la page **Gérer les CloudWatch alarmes**, sous **Ajouter ou modifier une alarme**, choisissez **Modifier une alarme**.

1. Dans **Search for alarm (Rechercher une alarme)**, sélectionnez l’alarme.

1. Une fois les modifications terminées, sélectionnez **Update (Mettre à jour)**.

------
#### [ AWS CLI ]

Dans l’exemple suivant, l’alarme publie une notification dans une rubrique SNS lorsque l’instance échoue lors d’un contrôle de statut d’instance ou un contrôle de statut de système pour au moins deux périodes consécutives. La CloudWatch métrique utilisée est`StatusCheckFailed`.

**Pour créer une alarme de contrôle de statut**

1. Sélectionnez une rubrique SNS existante ou créez-en une nouvelle. Pour plus d’informations, consultez la section [Accès à Amazon SNS dans l’ AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-sns.html) dans le *Guide de l’utilisateur AWS Command Line Interface *.

1. Utilisez la commande [list-metrics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) suivante pour afficher les métriques Amazon disponibles pour Amazon CloudWatch EC2.

   ```
   aws cloudwatch list-metrics --namespace AWS/EC2
   ```

1. Utilisez la [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html)commande suivante pour créer l'alarme.

   ```
   aws cloudwatch put-metric-alarm \
       --alarm-name {{StatusCheckFailed-Alarm-for-i-1234567890abcdef0}} \
       --metric-name StatusCheckFailed \
       --namespace AWS/EC2 \
       --statistic Maximum \
       --dimensions Name=InstanceId,Value={{i-1234567890abcdef0}} \
       --unit Count \
       --period 300 \
       --evaluation-periods 2 \
       --threshold 1 \
       --comparison-operator GreaterThanOrEqualToThreshold \
       --alarm-actions arn:aws:sns:{{us-west-2}}:{{111122223333}}:{{my-sns-topic}}
   ```

   La période est la période, en secondes, pendant laquelle CloudWatch les métriques Amazon sont collectées. Dans cet exemple, 300, qui correspond à 60 secondes multipliées par 5 minutes, est utilisé. La période d’évaluation est le nombre de périodes consécutives pour lesquelles la valeur de la métrique doit être comparée au seuil. Dans cet exemple, 2 est utilisé. Les actions d’alarme correspondent aux actions à exécuter lors du déclenchement de cette alarme.

------
#### [ PowerShell ]

**Pour créer une alarme de contrôle de statut**  
Utilisez l'applet de commande [Write- CWMetric Alarm](https://docs.aws.amazon.com/powershell/latest/reference/items/Write-CWMetricAlarm.html) comme suit pour publier des notifications sur une rubrique SNS lorsque l'instance échoue aux vérifications de statut pendant au moins deux périodes consécutives.

```
Write-CWMetricAlarm `
    -AlarmName "{{StatusCheckFailed-Alarm-for-i-1234567890abcdef0}}" `
    -MetricName "StatusCheckFailed" `
    -Namespace "AWS/EC2" `
    -Statistic "Maximum" `
    -Dimension @{Name="InstanceId"; Values="{{i-1234567890abcdef0}}"} `
    -Unit "Count" `
    -Period 300 `
    -EvaluationPeriod 2 `
    -Threshold 1 `
    -ComparisonOperator "GreaterThanOrEqualToThreshold" `
    -AlarmAction "arn:aws:sns:{{us-west-2}}:{{111122223333}}:{{my-sns-topic}}"
```

La période est la période, en secondes, pendant laquelle CloudWatch les métriques Amazon sont collectées. Dans cet exemple, 300, qui correspond à 60 secondes multipliées par 5 minutes, est utilisé. La période d’évaluation est le nombre de périodes consécutives pour lesquelles la valeur de la métrique doit être comparée au seuil. Dans cet exemple, 2 est utilisé. Les actions d’alarme correspondent aux actions à exécuter lors du déclenchement de cette alarme.

------