

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.

# Surveillez les ressources Amazon EC2
<a name="monitoring_ec2"></a>

La surveillance joue un rôle important dans le maintien de la fiabilité, de la disponibilité et des performances de vos instances Amazon EC2 et de vos AWS solutions. Vous devez collecter des données de surveillance provenant de tous les composants de vos AWS solutions afin de pouvoir corriger plus facilement une défaillance multipoint, le cas échéant.

AWS fournit différents outils que vous pouvez utiliser pour surveiller Amazon EC2. Les tableaux de bord Amazon EC2 et de CloudWatch la console fournissent un at-a-glance aperçu de l'état de votre environnement Amazon EC2. En outre, nous offrons les éléments suivants :
+ **Contrôles de l'état du système** : surveillez les AWS systèmes requis pour utiliser votre instance afin de vous assurer qu'ils fonctionnent correctement. Ces vérifications détectent les problèmes liés à votre instance qui nécessitent une AWS intervention pour les réparer. Lorsqu’un contrôle de statut échoue, vous pouvez choisir d’attendre qu’ AWS résolve le problème ou le résoudre vous-même (par exemple, en arrêtant et en redémarrant une instance, ou en y mettant fin et en la remplaçant). Voici quelques exemples de problèmes entraînant l’échec des contrôles de statut du système :
  + Perte de connectivité réseau
  + Perte d’alimentation système
  + Problèmes logiciels sur un hôte physique
  + Problèmes matériels sur un hôte physique ayant un impact sur l’accessibilité du réseau

  Pour plus d’informations, veuillez consulter [Contrôles du statut des instances Amazon EC2](monitoring-system-instance-status-check.md).
+ **Contrôles du statut de l’instance** : surveillez la configuration logicielle et réseau de votre instance. Ces contrôles détectent les problèmes nécessitant votre intervention pour les résoudre. Lorsqu’un contrôle du statut de l’instance échoue, vous devez généralement résoudre le problème vous-même (en redémarrant par exemple l’instance ou en apportant des modifications à votre système d’exploitation). Voici quelques exemples de problèmes susceptibles d’entraîner l’échec des contrôles du statut de l’instance :
  + Échec de contrôles de statut de système
  + Configuration de mise en réseau ou de démarrage incorrecte
  + Mémoire épuisée
  + Système de fichiers corrompu
  + Noyau incompatible

  Pour de plus amples informations, veuillez consulter [Contrôles du statut des instances Amazon EC2](monitoring-system-instance-status-check.md).
+ ** CloudWatch Alarmes Amazon** : surveillez une seule métrique sur une période que vous spécifiez et effectuez une ou plusieurs actions en fonction de la valeur de la métrique par rapport à un seuil donné sur un certain nombre de périodes. L’action est une notification envoyée à une rubrique Amazon Simple Notification Service (Amazon SNS) ou une politique Amazon EC2 Auto Scaling. Les alarmes déclenchent des actions uniquement pour les changements d'état prolongés. CloudWatch les alarmes ne déclencheront pas d'actions simplement parce qu'elles sont dans un état particulier ; l'état doit avoir changé et être maintenu pendant un certain nombre de périodes. Pour de plus amples informations, veuillez consulter [Surveillez vos instances à l'aide de CloudWatch](using-cloudwatch.md).
+ **Amazon EventBridge events** — Automatisez vos AWS services et répondez automatiquement aux événements du système. Les événements issus AWS des services sont transmis EventBridge en temps quasi réel, et vous pouvez spécifier des actions automatisées à effectuer lorsqu'un événement correspond à une règle que vous avez écrite. Pour de plus amples informations, veuillez consulter [Automatisez Amazon EC2 en utilisant EventBridge](automating_with_eventbridge.md).
+ **AWS CloudTrail journaux** — Capturez des informations détaillées sur les appels passés à l'API Amazon EC2 et stockez-les sous forme de fichiers journaux dans Amazon S3. Vous pouvez utiliser CloudTrail les journaux pour déterminer quels appels ont été passés, l'adresse IP source de l'appel, l'auteur de l'appel et la date de l'appel. Pour de plus amples informations, veuillez consulter [Enregistrez les appels d' EC2 API Amazon à l'aide de AWS CloudTrail](monitor-with-cloudtrail.md).
+ **CloudWatch agent** : collectez les journaux et les mesures au niveau du système auprès des hôtes et des invités sur vos instances EC2 et vos serveurs sur site. Pour plus d'informations, consultez la section [Collecte de métriques et de journaux à partir d'instances Amazon EC2 et de serveurs sur site avec l' CloudWatch agent dans le guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) de l'utilisateur *Amazon CloudWatch *.

# Surveillez le statut de vos instances Amazon EC2
<a name="monitoring-instances-status-check"></a>

Vous pouvez surveiller le statut de vos instances en affichant les contrôles de statut et les événements planifiés pour vos instances.

Un contrôle de statut vous fournit les informations provenant de contrôles automatisés exécutés par Amazon EC2. Ces contrôles automatisés détectent si des problèmes spécifiques concernent vos instances. Les informations de vérification du statut, associées aux données fournies par Amazon CloudWatch, vous offrent une visibilité opérationnelle détaillée sur chacune de vos instances. 

Vous pouvez également consulter le statut d’ événements spécifiques planifiés pour vos instances. Les statuts des événements fournissent des informations sur les activités à venir planifiées pour vos instances, comme le redémarrage ou la mise hors service. Ils fournissent aussi les heures prévues de début et de fin de chaque événement.

**Topics**
+ [

# Contrôles du statut des instances Amazon EC2
](monitoring-system-instance-status-check.md)
+ [

# Événements de changement de statut pour les instances Amazon EC2
](monitoring-instance-state-changes.md)
+ [

# Événements programmés pour les instances Amazon EC2
](monitoring-instances-status-check_sched.md)

# Contrôles du statut des instances Amazon EC2
<a name="monitoring-system-instance-status-check"></a>

Avec la surveillance du statut des instances, vous pouvez rapidement déterminer si Amazon EC2 a détecté des problèmes susceptibles d’empêcher vos instances d’exécuter des applications. Amazon EC2 exécute des contrôles automatisés sur chaque instance EC2 en cours d’exécution pour identifier les problèmes matériels et logiciels. Vous pouvez afficher les résultats de ces contrôles de statut pour identifier des problèmes spécifiques et détectables. Les données d'état des événements complètent les informations déjà fournies par Amazon EC2 concernant l'état de chaque instance (par exemple`running`,`stopping`,) et les mesures d'utilisation surveillées par CloudWatch Amazon (utilisation du processeur, trafic réseau et activité du disque). `pending`

Les contrôles de statut sont exécutés toutes les minutes et chacun d’entre eux renvoie un statut de réussite ou d’échec. Si tous les contrôles réussissent, le statut global de l’instance est **OK**. Si un ou plusieurs contrôles échouent, le statut global de l’instance est **dégradé**. Les contrôles de statut sont intégrés à Amazon EC2. Ils ne peuvent donc pas être désactivés ou supprimés.

Lorsqu'une vérification de statut échoue, la CloudWatch métrique correspondante pour les vérifications de statut est incrémentée. Pour de plus amples informations, veuillez consulter [Métriques de contrôle de statut](viewing_metrics_with_cloudwatch.md#status-check-metrics). Vous pouvez utiliser ces métriques pour créer des alarmes CloudWatch qui sont déclenchées en fonction du résultat des contrôles de statut. Par exemple, vous pouvez créer une alarme pour vous avertir si des contrôles de statut échouent sur une instance spécifique. Pour de plus amples informations, veuillez consulter [Créez des CloudWatch alarmes pour les instances Amazon EC2 qui échouent aux vérifications de statut](creating_status_check_alarms.md).

Vous pouvez également créer une CloudWatch alarme Amazon qui surveille une instance Amazon EC2 et la récupère automatiquement si elle est altérée en raison d'un problème sous-jacent. Pour de plus amples informations, veuillez consulter [Récupération automatique des instances](ec2-instance-recover.md).

**Topics**
+ [

## Types de contrôles de statut
](#types-of-instance-status-checks)
+ [

# Affichez les contrôles de statut pour les instances Amazon EC2
](viewing_status.md)
+ [

# Créez des CloudWatch alarmes pour les instances Amazon EC2 qui échouent aux vérifications de statut
](creating_status_check_alarms.md)

## Types de contrôles de statut
<a name="types-of-instance-status-checks"></a>

Il existe trois types de contrôles de statuts.
+ [Contrôles de statut de système](#system-status-checks)
+ [Contrôles de statut des instances](#instance-status-checks)
+ [Contrôles de statut de l’EBS attaché](#attached-ebs-status-checks)

### Contrôles de statut de système
<a name="system-status-checks"></a>

Les vérifications de l'état du système surveillent les AWS systèmes sur lesquels votre instance s'exécute. Ces contrôles détectent les problèmes sous-jacents liés à votre instance qui nécessitent une intervention de résolution d’ AWS . Lorsqu'une vérification de l'état du système échoue, vous pouvez choisir AWS d'attendre que le problème soit résolu ou de le résoudre vous-même. Pour les instances basées sur Amazon EBS, vous pouvez arrêter et démarrer l’instance vous-même, ce qui, dans la plupart des cas, entraîne la migration de l’instance vers un nouvel hôte. Pour les instances Linux basées sur le stockage d’instance, vous pouvez résilier l’instance et la remplacer. Notez que les volumes de stockage d’instance sont éphémères et que toutes les données sont perdues lorsque l’instance est arrêtée.

Voici des exemples de problèmes pouvant entraîner l’échec des contrôles de statut :
+ Perte de connectivité réseau
+ Perte d’alimentation système
+ Problèmes logiciels sur un hôte physique
+ Problèmes matériels sur un hôte physique ayant un impact sur l’accessibilité du réseau

Si la vérification de l'état du système échoue, nous incrémentons la métrique [StatusCheckFailed\$1System.](viewing_metrics_with_cloudwatch.md#status-check-metrics)

**Instances nues**  
Si vous effectuez un redémarrage à partir du système d’exploitation sur une instance nue (bare metal), la vérification de l’état du système peut renvoyer temporairement un état d’échec. Lorsque l’instance devient disponible, la vérification de l’état du système doit renvoyer un état de succès.

### Contrôles de statut des instances
<a name="instance-status-checks"></a>

Les contrôles de statut des instances surveillent le logiciel et la connectivité du réseau de votre instance individuelle. Amazon EC2 vérifie l’état de l’instance en envoyant une demande de protocole de résolution d’adresse (ARP) à l’interface réseau (NIC). Ces contrôles détectent les problèmes nécessitant votre intervention pour les résoudre. Lorsqu’un contrôle de statut d’instance échoue, vous devez généralement résoudre le problème vous-même (par exemple, en redémarrant l’instance ou en effectuant des changements de configuration sur l’instance).

**Note**  
Les distributions Linux récentes utilisant `systemd-networkd` la configuration du réseau peuvent rendre compte des contrôles de santé différemment des distributions antérieures. Au cours du processus de démarrage, ce type de réseau peut démarrer plus tôt et éventuellement se terminer avant d'autres tâches de démarrage qui peuvent également affecter l'état de l'instance. Les contrôles de statut qui dépendent de la disponibilité du réseau peuvent signaler un statut sain avant que d'autres tâches ne soient terminées.

Voici des exemples de problèmes pouvant entraîner l’échec des contrôles d’instance :
+ Échec de contrôles de statut de système
+ Configuration de mise en réseau ou de démarrage incorrecte
+ Mémoire épuisée
+ Système de fichiers corrompu
+ Noyau incompatible
+ Lors d’un redémarrage, un contrôle de statut des instances signale une défaillance jusqu’à ce que l’instance redevienne disponible.

Si la vérification de l'état d'une instance échoue, nous incrémentons la métrique [StatusCheckFailed\$1Instance](viewing_metrics_with_cloudwatch.md#status-check-metrics).

**Instances nues**  
Si vous effectuez un redémarrage à partir du système d’exploitation sur une instance nue (bare metal), la vérification de l’état de l’instance peut renvoyer temporairement un état d’échec. Lorsque l’instance devient disponible, la vérification de l’état de l’instance doit renvoyer un état de succès.

### Contrôles de statut de l’EBS attaché
<a name="attached-ebs-status-checks"></a>

Les contrôles de statut EBS attachés vérifient si les volumes Amazon EBS attachés à une instance sont accessibles et capables d'effectuer I/O des opérations. La `StatusCheckFailed_AttachedEBS` métrique est une valeur binaire qui indique une altération si un ou plusieurs volumes EBS attachés à l'instance ne sont pas en mesure de terminer les I/O opérations. Ces vérifications de statut détectent les problèmes sous-jacents liés au calcul ou à l’infrastructure Amazon EBS. Lorsque la métrique de vérification du statut EBS jointe échoue, vous pouvez soit attendre AWS que le problème soit résolu, soit prendre des mesures, telles que le remplacement des volumes concernés ou l'arrêt et le redémarrage de l'instance.

Vous trouverez ci-dessous des exemples de problèmes pouvant entraîner l’échec des contrôles de statut de l’EBS attaché :
+ Problèmes matériels ou logiciels sur les sous-systèmes de stockage sous-jacents aux volumes EBS
+ Problèmes matériels sur l’hôte physique ayant un impact sur l’accessibilité des volumes EBS
+ Problèmes de connectivité entre l’instance et les volumes EBS

Vous pouvez utiliser la métrique `StatusCheckFailed_AttachedEBS` pour améliorer la résilience de votre charge de travail. Vous pouvez utiliser cette métrique pour créer des CloudWatch alarmes Amazon déclenchées en fonction du résultat de la vérification de statut. Par exemple, vous pouvez basculer vers une instance secondaire ou une zone de disponibilité lorsque vous détectez un impact prolongé. Vous pouvez également surveiller tous les I/O performance of each attached volume using EBS CloudWatch metrics to detect and replace the impaired volume. If your workload is not driving I/O volumes EBS attachés à votre instance, et si la vérification de l'état EBS indique un dysfonctionnement, vous pouvez arrêter et démarrer l'instance pour la déplacer vers un nouvel hôte. Cela peut résoudre les problèmes d’hôte sous-jacents qui ont un impact sur l’accessibilité des volumes EBS. Pour plus d'informations, consultez les [ CloudWatch métriques Amazon pour Amazon EBS.](https://docs.aws.amazon.com/ebs/latest/userguide/using_cloudwatch_ebs.html)

Vous pouvez également configurer vos groupes Amazon EC2 Auto Scaling pour détecter les échecs de contrôle de statut EBS associés, puis remplacer l'instance affectée par une nouvelle instance. Pour de plus d'informations, veuillez consulter [ Surveiller et remplacer les instances AutoScaling par des volumes Amazon EBS altérés](https://docs.aws.amazon.com/autoscaling/ec2/userguide/monitor-and-replace-instances-with-impaired-ebs-volumes.html) dans le *Guide de l'utilisateur Amazon EC2 Auto Scaling*.

**Note**  
La métrique de contrôle de statut de l’EBS attaché n’est disponible que pour les instances Nitro.

# Affichez les contrôles de statut pour les instances Amazon EC2
<a name="viewing_status"></a>

Lorsqu’un contrôle de statut d’instance échoue, vous devez généralement résoudre le problème vous-même (par exemple, en redémarrant l’instance ou en effectuant des changements de configuration sur celle-ci). Pour résoudre vous-même des échecs de contrôle de statut de système ou d’instance, consultez [Résolution des problèmes liés aux instances Linux d'Amazon EC2 dont les vérifications du statut ont échoué](TroubleshootingInstances.md).

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

**Pour afficher les contrôles 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. Sur la page **instances**, la colonne **Status check (Vérification de statut)** répertorie le statut opérationnel de chaque instance.

1. Pour afficher le statut d’une instance spécifique, sélectionnez-la, puis choisissez l’onglet **Statuts et alarmes**.

1. Pour consulter les CloudWatch mesures relatives aux vérifications de statut, dans l'onglet **État et alarmes**, développez **Métriques** pour afficher les graphiques des mesures suivantes :
   + **Échec du contrôle de statut au niveau du système**
   + **Échec du contrôle de statut au niveau de l’instance**
   + **Échec du contrôle de statut pour l'EBS attaché**

   Pour de plus amples informations, veuillez consulter [Métriques de contrôle de statut](viewing_metrics_with_cloudwatch.md#status-check-metrics).

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

**Pour afficher les contrôles de statut**  
Utilisez la commande [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html).

**Exemple** : obtenir le statut de toutes les instances en cours d’exécution

```
aws ec2 describe-instance-status
```

**Exemple** : obtenir le statut de toutes les instances

```
aws ec2 describe-instance-status --include-all-instances
```

**Exemple** : obtenir le statut d’une seule instance en cours d’exécution

```
aws ec2 describe-instance-status --instance-ids i-1234567890abcdef0
```

**Exemple** : obtenir toutes les instances dont le statut est `impaired`

```
aws ec2 describe-instance-status \
--filters Name=instance-status.status,Values=impaired
```

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

**Pour afficher les contrôles de statut**  
Utilisez la commande [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html).

**Exemple** : obtenir le statut de toutes les instances en cours d’exécution

```
Get-EC2InstanceStatus
```

**Exemple** : obtenir le statut de toutes les instances

```
Get-EC2InstanceStatus -IncludeAllInstance $true
```

**Exemple** : obtenir le statut d’une seule instance en cours d’exécution

```
Get-EC2InstanceStatus -InstanceId i-1234567890abcdef0
```

**Exemple** : obtenir toutes les instances dont le statut est `impaired`

```
Get-EC2InstanceStatus \
-Filter @{Name="instance-status.status"; Values="impaired"}
```

------

# 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.

------

# Événements de changement de statut pour les instances Amazon EC2
<a name="monitoring-instance-state-changes"></a>

Amazon EC2 envoie un `EC2 Instance State-change Notification` événement à Amazon EventBridge lorsque l'état d'une instance change.

Voici un exemple de données pour cet événement. Dans cet exemple, l’instance est entrée dans l’état `pending`.

```
{
   "id":"7bf73129-1428-4cd3-a780-95db273d1602",
   "detail-type":"EC2 Instance State-change Notification",
   "source":"aws.ec2",
   "account":"123456789012",
   "time":"2021-11-11T21:29:54Z",
   "region":"us-east-1",
   "resources":[
      "arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0"
   ],
   "detail":{
      "instance-id":"i-1234567890abcdef0",
      "state":"pending"
   }
}
```

Les valeurs possibles pour `state` sont :
+ `pending`
+ `running`
+ `stopping`
+ `stopped`
+ `shutting-down`
+ `terminated`

Lorsque vous lancez ou démarrez une instance, elle entre dans l’état `pending`, puis dans l’état `running`. Lorsque vous arrêtez une instance, elle entre dans l’état `stopping`, puis dans l’état `stopped`. Lorsque vous résiliez une instance, elle entre dans l’état `shutting-down`, puis dans l’état `terminated`. Pour de plus amples informations, veuillez consulter [Modifications de l'état de l' EC2 instance Amazon](ec2-instance-lifecycle.md).

# Créez une alarme qui envoie un e-mail lorsqu'une instance Amazon EC2 change de statut
<a name="ec2-events-eventbridge-example"></a>

Pour recevoir des notifications par e-mail lorsque votre instance change d'état, créez une rubrique Amazon SNS, puis créez une EventBridge règle pour l'`EC2 Instance State-change Notification`événement.

**Pour créer une rubrique SNS**

1. [Ouvrez la console Amazon SNS à l'adresse v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home)

1. Dans le volet de navigation, choisissez **Rubriques**.

1. Choisissez **Créer une rubrique**.

1. Pour **Type**, choisissez **Standard**.

1. Pour **Nom**, saisissez un nom pour votre rubrique.

1. Choisissez **Créer une rubrique**.

1. Choisissez **Créer un abonnement**.

1. Pour **Protocole**, choisissez **E-mail**.

1. Pour **Point de terminaison**, saisissez l’adresse e-mail qui reçoit les notifications.

1. Choisissez **Créer un abonnement**.

1. Vous recevrez un e-mail avec l’objet suivant : AWS Notification - Subscription Confirmation. Suivez les instructions pour confirmer votre abonnement.

**Pour créer une EventBridge règle**

1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Choisissez **Créer une règle**.

1. Pour **Nom**, saisissez un nom pour votre règle.

1. Pour **Type de règle**, choisissez **Règle avec un modèle d’événement**.

1. Choisissez **Suivant**.

1. Pour **Event pattern** (Modèle d’événement), procédez comme suit :

   1. Pour **Event source (Source d’événement)**, choisissez **Services AWS**.

   1. Pour **Service AWS**, choisissez **EC2**.

   1. Pour **Event Type (Type d’événement)**, sélectionnez **EC2 Instance State-change Notification (Notification de changement d’état de l’instance EC2)**.

   1. Par défaut, nous envoyons des notifications pour tout changement d’état pour n’importe quelle instance. Si vous préférez, vous pouvez sélectionner des états ou des instances spécifiques.

1. Choisissez **Suivant**.

1. Spécifiez une cible comme suit :

   1. Pour **Target types** (Types de cibles), choisissez **Service AWS**.

   1. Pour **Select a target** (Sélectionnez une cible), choisissez **SNS Topic** (Rubrique SNS).

   1. Pour **Topic** (Rubrique), choisissez la rubrique SNS que vous avez créée au cours de la procédure précédente.

1. Choisissez **Suivant**.

1. (Facultatif) Ajoutez des identifications à votre règle.

1. Choisissez **Suivant**.

1. Choisissez **Créer une règle**.

1. Pour tester votre règle, déclenchez un changement d’état. Par exemple, démarrez une instance arrêtée, arrêtez une instance en cours d’exécution ou lancez une instance. Vous recevrez des e-mails avec l’objet suivant : AWS Notification Message. Le corps de l’e-mail contient les données de l’événement.

# Événements programmés pour les instances Amazon EC2
<a name="monitoring-instances-status-check_sched"></a>

Pour garantir la fiabilité et les performances de l'infrastructure, AWS vous pouvez planifier des événements pour redémarrer, arrêter et mettre hors service vos instances. Ces événements ne se produisent pas fréquemment.

Si l'une de vos instances est affectée par un événement programmé, vous en AWS informera à l'avance par e-mail, en utilisant l'adresse e-mail associée à votre AWS compte. Cet e-mail fournit des détails concernant l’événement, tels que les dates de début et de fin. Selon le type d'événement, vous pouvez peut-être prendre des mesures pour contrôler le calendrier de l'événement. AWS envoie également un AWS Health événement, que vous pouvez surveiller et gérer à l'aide d'Amazon EventBridge. Pour plus d'informations, consultez [la section Surveillance des événements AWS Health avec Amazon EventBridge](https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html). 

Les événements programmés sont gérés par AWS. Vous ne pouvez pas planifier d’événements pour vos instances. Toutefois, vous pouvez :
+ afficher les événements planifiés pour vos instances ;
+ personnaliser les notifications d’événements planifiés afin d’inclure ou de supprimer les balises de la notification par e-mail ;
+ reprogrammer certains événements planifiés ;
+ créer des fenêtres d’événements personnalisées pour les événements planifiés
+ prendre des mesures lorsque le redémarrage, l’arrêt ou la mise hors service d’une instance est planifié.

Pour vous assurer de recevoir des notifications concernant les événements planifiés, vérifiez vos coordonnées sur la page [Compte](https://console.aws.amazon.com/billing/home?#/account).

**Note**  
Lorsqu’une instance est affectée par un événement planifié et qu’elle fait partie d’un groupe Auto Scaling, Amazon EC2 Auto Scaling finit par la remplacer dans le cadre de ses surveillances de l’état, sans aucune autre action nécessaire de votre part. Pour plus d'informations sur les surveillances de l'état réalisés par Amazon EC2 Auto Scaling, consultez [Surveillance de l'état des instances d'un groupe Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-health-checks.html) dans le *Guide de l'utilisateur d'Amazon EC2 Auto Scaling*.

## Types d’événements planifiés
<a name="types-of-scheduled-events"></a>

Amazon EC2 peut créer les types d’événements planifiés suivants pour vos instances, où l’événement se produit à une heure planifiée :


| Type d’événement | Code de l'événement | Action d’événement | 
| --- | --- | --- | 
| Arrêt de l’instance | instance-stop | À l’heure planifiée, l’instance est arrêtée. Lorsque vous la redémarrez, elle est migrée vers un nouvel hôte. S’applique uniquement aux instances dotées d’un volume racine Amazon EBS. | 
| Mise hors service d’instance | instance-retirement | À l’heure planifiée, l’instance est arrêtée si elle possède un volume racine Amazon EBS, ou résiliée si elle possède un volume racine de stockage d’instance. | 
| Redémarrage d’instance | instance-reboot | À l’heure planifiée, l’instance est redémarrée. L’instance reste sur l’hôte, et pendant le redémarrage, l’hôte fait l’objet d’une maintenance. Cette opération est appelée redémarrage en place. | 
| Redémarrage du système | system-reboot | À l’heure planifiée, l’instance est redémarrée et transférée vers un nouvel hôte. Cette opération est appelée migration par redémarrage. | 
| Maintenance du système | system-maintenance | À l’heure planifiée, l’instance peut être temporairement affectée par une maintenance du réseau ou de l’alimentation électrique. | 

## Détermination du type d’événement
<a name="scheduled-event-type"></a>

Vous pouvez vérifier quel type d’événement est planifié pour votre instance.

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

**Pour déterminer le type d’événement**

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, sélectionnez **Events**.

1. Dans le tableau, le code d’événement apparaît dans la colonne **Type d’événement**.

1. Pour filtrer le tableau afin de n’afficher que les événements relatifs aux instances, dans le champ de recherche, choisissez **Type de ressource : instance** dans la liste des filtres.

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

**Pour déterminer le type d’événement pour une instance**  
Utilisez la commande [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html). Si un événement planifié est associé à l’instance, la sortie fournit des informations sur l’événement planifié.

```
aws ec2 describe-instance-status \
    --instance-id i-1234567890abcdef0 \
    --query InstanceStatuses[].Events
```

Voici un exemple de sortie. Le code de l’événement planifié est `system-reboot`.

```
[
    "Events": [
        {
            "InstanceEventId": "instance-event-0d59937288b749b32",
            "Code": "system-reboot",
            "Description": "The instance is scheduled for a reboot",
            "NotAfter": "2020-03-14T22:00:00.000Z",
            "NotBefore": "2020-03-14T20:00:00.000Z",
            "NotBeforeDeadline": "2020-04-05T11:00:00.000Z"
        }
    ]
]
```

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

**Pour déterminer le type d’événement pour une instance**  
Utilisez l’applet de commande [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html). Si un événement planifié est associé à l’instance, la sortie fournit des informations sur l’événement planifié.

```
(Get-EC2InstanceStatus `
    -InstanceId i-1234567890abcdef0).Events
```

Voici un exemple de sortie. Le code de l’événement planifié est `system-reboot`.

```
Code              : system-reboot
Description       : The instance is scheduled for a reboot
InstanceEventId   : instance-event-0d59937288b749b32
NotAfter          : 2020-03-14T22:00:00.000Z
NotBefore         : 2020-03-14T20:00:00.000Z
NotBeforeDeadline : 2020-04-05T11:00:00.000Z
```

------

**Topics**
+ [

## Types d’événements planifiés
](#types-of-scheduled-events)
+ [

## Détermination du type d’événement
](#scheduled-event-type)
+ [

# Gestion des instances Amazon EC2 dont l’arrêt ou la mise hors service est planifié
](schedevents_actions_retire.md)
+ [

# Gestion des instances Amazon EC2 dont le redémarrage est planifié
](schedevents_actions_reboot.md)
+ [

# Gestion des instances Amazon EC2 dont la maintenance est planifiée
](schedevents_actions_maintenance.md)
+ [

# Affichez les événements programmées qui affectent vos instances Amazon EC2
](viewing_scheduled_events.md)
+ [

# Personnalisation des notifications par e-mail pour les événements programmés qui affectent les instances Amazon EC2
](customizing_scheduled_event_notifications.md)
+ [

# Replanification d’un événement planifié pour une instance EC2
](reschedule-event.md)
+ [

# Créez des fenêtres d'événements personnalisées pour les événements programmés qui affectent vos instances Amazon EC2
](event-windows.md)

# Gestion des instances Amazon EC2 dont l’arrêt ou la mise hors service est planifié
<a name="schedevents_actions_retire"></a>

Lorsqu'il AWS détecte une défaillance irréparable de l'hôte sous-jacent de votre instance, il planifie l'arrêt ou la résiliation de l'instance, en fonction du type de volume racine de l'instance.
+ Si l’instance dispose d’un volume racine Amazon EBS, l’arrêt de l’instance est planifié.
+ Si l’instance dispose d’un volume de stockage d’instances, la résiliation de l’instance est planifiée.

Pour de plus amples informations, veuillez consulter [Mise hors service d’instance](instance-retirement.md).

**Important**  
Les données stockées sur des volumes de stockage d’instance sont perdues lorsque l’instance est arrêtée, mise en veille prolongée ou résiliée. Ceci inclut les volumes de stockage d’instances attachés à une instance ayant un volume racine EBS. Veillez à enregistrer les données de vos volumes de stockage d’instance dont vous aurez besoin ultérieurement avant que l’instance ne soit arrêtée, mise en veille prolongée ou résiliée.

## Actions que vous pouvez entreprendre
<a name="actions-you-can-take-for-scheduled-stop-or-retire-event"></a>

**Actions que vous pouvez effectuer pour les instances disposant d’un volume racine EBS**

Lorsque vous recevez une notification d’événement `instance-stop` planifié, vous pouvez effectuer une des actions suivantes :
+ **Attendre l’arrêt planifié :** vous pouvez attendre que l’instance s’arrête dans sa fenêtre de maintenance planifiée.
+ **Effectuer un arrêt et un démarrage manuels :** vous pouvez arrêter et démarrer l’instance vous-même à un moment qui vous convient, ce qui la transfert vers un nouvel hôte. Ce n’est pas la même chose que le redémarrage de l’instance. Pour de plus amples informations, veuillez consulter [Arrêtez et démarrez des instances Amazon EC2](Stop_Start.md).
+ **Automatiser l’arrêt et le démarrage :** vous pouvez automatiser un arrêt immédiat et un démarrage en réponse à un événement `instance-stop` planifié. Pour plus d'informations, consultez [Exécution automatique d'opérations sur les instances EC2 en réponse aux événements décrits AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) dans le *AWS Health Guide de l'utilisateur*.

**Actions que vous pouvez effectuer pour les instances disposant d’un volume racine de stockage d’instances**

Lorsque vous recevez une notification d’événement `system-retirement` planifié et que vous souhaitez conserver vos données, vous pouvez prendre les mesures suivantes :

1. Lancez une instance de remplacement à partir de votre AMI la plus récente.

1. Effectuez la migration de toutes les données nécessaires vers l’instance de remplacement avant que la résiliation de l’instance ne soit planifiée.

1. Résiliez l’instance d’origine ou attendez qu’elle soit résiliée comme prévu.

Pour plus d’informations sur les actions que vous pouvez entreprendre, consultez la section [Mise hors service d’instance](instance-retirement.md).

# Gestion des instances Amazon EC2 dont le redémarrage est planifié
<a name="schedevents_actions_reboot"></a>

Lorsqu'il AWS doit effectuer des tâches telles que l'installation de mises à jour ou la maintenance de l'hôte sous-jacent, il peut planifier le redémarrage de l'instance. Au cours du redémarrage planifié, l’instance reste sur le même hôte ou est transférée vers un autre hôte, selon l’événement, comme suit :
+ `instance-reboot` event
  + Pendant le redémarrage, l’instance reste sur l’hôte. Cette opération est appelée *redémarrage en place*.
  + L’hôte actuel fait l’objet d’une maintenance. 
  + Se termine généralement en quelques secondes.
+ `system-reboot` event
  + Lors du redémarrage, l’instance est transférée vers un nouvel hôte. Cette opération est appelée *migration par redémarrage*.
  + Se termine généralement en quelques minutes.

Pour vérifier quel type d’événement est planifié pour votre instance, consultez la section [Détermination du type d’événement](monitoring-instances-status-check_sched.md#scheduled-event-type).

## Actions que vous pouvez entreprendre
<a name="actions-you-can-take-for-scheduled-reboot-event"></a>

Lorsque vous recevez une notification d’événement planifié `instance-reboot` ou `system-reboot`, vous pouvez effectuer l’une des actions suivantes :
+ **Attendre le redémarrage planifié :** vous pouvez attendre que le redémarrage de l’instance ait lieu pendant la période de maintenance planifiée.
+ **Replanifier le redémarrage :** vous pouvez [replanifier](reschedule-event.md) le redémarrage de l’instance à une date et heure qui vous conviennent.
+ **Effectuer un redémarrage initié par l’utilisateur :** vous pouvez [redémarrer](ec2-instance-reboot.md) vous-même l’instance manuellement au moment qui vous convient. Toutefois, le résultat dépend de l’événement :
  + Événement `instance-reboot` : votre instance reste sur le matériel actuel (redémarrage en place), aucune maintenance de l’hôte n’a lieu et l’événement reste ouvert.
  + `system-reboot` event
    + Si la migration par redémarrage est activée sur votre instance, un redémarrage initié par l’utilisateur tente de transférer votre instance vers un nouveau matériel. En cas de succès, l’événement est annulé. En cas d’échec, un redémarrage en place a lieu et l’événement reste planifié.
    + Si la migration par redémarrage est désactivée sur votre instance, un redémarrage initié par l’utilisateur permet de maintenir l’instance sur le même matériel (redémarrage en place), aucune maintenance de l’hôte n’a lieu et l’événement reste planifié. Lorsque l'événement planifié aura finalement lieu, votre instance AWS sera déplacée vers un nouveau matériel (redémarrage de la migration).

**Après le AWS redémarrage de votre instance**

Ce qui suit s'applique après AWS le redémarrage de votre instance :
+ L’événement planifié est supprimé.
+ La description de l’événement est mise à jour.
+ Pour un événement `instance-reboot` :
  + La maintenance de l’hôte sous-jacent est terminée.
+ Pour un événement `system-reboot` :
  + L’instance est déplacée vers un nouvel hôte.
  + L’instance conserve son adresse IP et son nom DNS.
  + Toutes les données se trouvant sur les volumes locaux du stockage d’instances sont préservées.
+ Vous pouvez utiliser votre instance après son démarrage complet.

**Options alternatives**

Si vous ne parvenez pas à replanifier l’événement de redémarrage ou à activer la migration par redémarrage pour un redémarrage initié par l’utilisateur, mais que vous souhaitez maintenir un fonctionnement normal pendant la période de maintenance planifiée, vous pouvez effectuer les opérations suivantes :
+ **Pour une instance avec un volume racine EBS**
  + Arrêtez et démarrez manuellement l’instance pour la transférer vers un nouvel hôte. Ce n’est pas la même chose que le redémarrage manuel de l’instance, où celle-ci reste sur le même hôte.
  + Il est également possible d’automatiser l’arrêt et le démarrage immédiats de l’instance en réponse à l’événement de redémarrage planifié. Pour plus d'informations, consultez [Exécution automatique d'opérations sur les instances EC2 en réponse aux événements décrits AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) dans le *AWS Health Guide de l'utilisateur*.
**Important**  
Les données des volumes de stockage d’instances sont perdues lorsqu’une instance est arrêtée. Pour de plus amples informations, veuillez consulter [Arrêtez et démarrez des instances Amazon EC2](Stop_Start.md).
+ **Pour une instance disposant d’un volume racine de stockage d’instances**

  1. Lancez une instance de remplacement à partir de votre AMI la plus récente.

  1. Procédez à la migration de toutes les données nécessaires vers l’instance de remplacement avant la fenêtre de maintenance planifiée.

  1. Résiliez l’instance d’origine.

## Activation ou désactivation de la migration par redémarrage
<a name="reboot-migration"></a>

Lorsqu’un événement `system-reboot` est planifié pour une instance, vous pouvez la redémarrer avant l’événement. Le résultat d’un redémarrage initié par l’utilisateur dépend du paramètre de migration par redémarrage de l’instance :
+ Activé : un redémarrage initié par l’utilisateur tente de transférer votre instance vers un nouveau matériel (migration par redémarrage). En cas de succès, l’événement est annulé. En cas d’échec, un redémarrage en place a lieu et l’événement reste planifié. Notez que même lorsqu’elle est activée, la migration par redémarrage ne peut avoir lieu que si votre instance répond aux [exigences de migration par redémarrage](#requirements-for-reboot-migration).
+ Désactivé : un redémarrage initié par l’utilisateur maintient l’instance sur le même matériel (redémarrage en place), aucune maintenance de l’hôte n’a lieu et l’événement reste planifié. Lorsque l'événement planifié aura finalement lieu, votre instance AWS sera déplacée vers un nouveau matériel (redémarrage de la migration).

Un redémarrage avec migration prend plus de temps qu’un redémarrage en place :
+ Redémarrage en place : environ 30 secondes
+ Redémarrage avec migration : plusieurs minutes

**Note**  
La migration par redémarrage initiée par l’utilisateur est activée par défaut pour les instances qui reçoivent une notification d’événement `system-reboot`.

### Conditions relatives à l’activation de la migration par redémarrage
<a name="requirements-for-reboot-migration"></a>

La migration par redémarrage peut être activée sur les instances qui répondent aux critères suivants :

**Types d’instances**  
Tous les types d’instance ne prennent pas en charge l’activation de la migration par redémarrage. Vous pouvez afficher les types d’instance qui prennent en charge l’activation de la migration par redémarrage.  

**Pour afficher les types d’instance qui prennent en charge l’activation de la migration par redémarrage**

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 de gauche, choisissez **Instance Types** (Types d’instance).

1. Dans la barre de filtre, saisissez **Prise en charge de la migration par démarrage : prise en charge** Au fur et à mesure que vous saisissez les caractères et que le nom du filtre apparaît, vous pouvez le sélectionner.

   La table **Types d’instance** affiche tous les types d’instance prenant en charge l’activation de la migration par redémarrage.
**Pour afficher les types d’instance qui prennent en charge l’activation de la migration par redémarrage**  
Utilisez la commande [describe-instance-types](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-types.html) avec le filtre `reboot-migration-support`.

```
aws ec2 describe-instance-types \
    --filters Name=reboot-migration-support,Values=supported \
    --query "InstanceTypes[*].[InstanceType]" \
    --output text | sort
```
**Pour afficher les types d’instance qui prennent en charge l’activation de la migration par redémarrage**  
Utilisez l'[Get-EC2InstanceType](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceType.html)applet de commande avec le `reboot-migration-support` filtre.

```
Get-EC2InstanceType `
    -Filter @{Name="reboot-migration-support";Values="true"} | `
    Select InstanceType | Sort-Object InstanceType
```

**Tenancy**  
+ Partagé
+ Dedicated Instance
Pour de plus amples informations, veuillez consulter [Instances EC2 dédiées Amazon](dedicated-instance.md).

**Limites**

La migration par redémarrage **n’est pas** prise en charge pour les instances présentant les caractéristiques suivantes :
+ Plateforme : instances exécutées de manière native sur l’hyperviseur Xen
+ Taille de l’instance : instances `metal`
+ Location : hôte dédié. Pour les hôtes dédiés, utilisez plutôt la [récupération automatique de l’hôte dédié](dedicated-hosts-recovery.md).
+ Stockage : instances avec volumes de stockage d’instance
+ Mise en réseau : instances utilisant un adaptateur Elastic Fabric Adapter
+ Auto Scaling : instances qui font partie d’un groupe Auto Scaling

### Étapes pour activer ou désactiver la migration par redémarrage
<a name="configure-reboot-migration-behavior"></a>

La migration par redémarrage est activée par défaut lorsqu’une instance reçoit un événement `system-reboot`. Vous pouvez désactiver la migration par redémarrage afin que, lors d’un redémarrage initié par l’utilisateur, l’instance reste sur le même matériel (redémarrage en place).

La configuration `default` ne permet pas la migration par redémarrage pour une instance non prise en charge. Pour de plus amples informations, veuillez consulter [Conditions relatives à l’activation de la migration par redémarrage](#requirements-for-reboot-migration).

Vous pouvez désactiver ou activer la migration par redémarrage sur une instance en cours d’exécution ou arrêtée.

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

**Pour désactiver la migration par redémarrage**  
Utilisez la [modify-instance-maintenance-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-maintenance-options.html)commande et définissez le `--reboot-migration` paramètre sur`disabled`.

```
aws ec2 modify-instance-maintenance-options \ 
    --instance-id i-0abcdef1234567890 \ 
    --reboot-migration disabled
```

**Pour activer la migration par redémarrage**  
Utilisez la [modify-instance-maintenance-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-maintenance-options.html)commande et définissez le `--reboot-migration` paramètre sur`default`.

```
aws ec2 modify-instance-maintenance-options \ 
    --instance-id i-0abcdef1234567890 \ 
    --reboot-migration default
```

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

**Pour désactiver la migration par redémarrage**  
Utilisez l’applet de commande [Edit-EC2InstanceMaintenanceOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceMaintenanceOption.html).

```
Edit-EC2InstanceMaintenanceOption `
    -InstanceId  `
    -RebootMigration Disabled
```

**Pour activer la migration par redémarrage**  
Utilisez l’applet de commande [Edit-EC2InstanceMaintenanceOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceMaintenanceOption.html).

```
Edit-EC2InstanceMaintenanceOption `
    -InstanceId i-1234567890abcdef0 `
    -RebootMigration Enabled
```

------

# Gestion des instances Amazon EC2 dont la maintenance est planifiée
<a name="schedevents_actions_maintenance"></a>

Lorsqu' AWS il doit gérer l'hôte sous-jacent d'une instance, il planifie la maintenance de l'instance. Il existe deux types d’événements de maintenance : maintenance du réseau et maintenance de l’alimentation.
+ Lors d’une maintenance du réseau, les instances planifiées perdent leur connectivité réseau pendant une courte période. La connectivité réseau normale vers votre instance est restaurée une fois la maintenance terminée.
+ Lors d’une maintenance de l’alimentation, les instances planifiées sont mises hors ligne pendant une courte période, puis redémarrées. Lorsqu’un redémarrage est effectué, les paramètres de configuration de votre instance sont conservés.

Une fois que votre instance a redémarré (cela prend normalement quelques minutes), vérifiez que votre application fonctionne comme prévu. À ce stade, votre instance ne devrait plus avoir d’événement planifié associé. Dans le cas contraire, la description de l’événement planifié commence par **[Terminé]**. Cela peut parfois prendre jusqu’à 1 heure pour que la description de statut de cette instance soit actualisée. Les événements de maintenance terminés restent affichés sur le tableau de bord de la console Amazon EC2 pendant une semaine maximum.

## Actions que vous pouvez entreprendre
<a name="actions-you-can-take-for-scheduled-maintenance-event"></a>

**Actions que vous pouvez effectuer pour les instances disposant d’un volume racine EBS**

Lorsque vous recevez une notification d’événement `system-maintenance`, vous pouvez effectuer une des actions suivantes :
+ **Attendre la maintenance planifiée :** vous pouvez attendre que la maintenance ait lieu comme prévu.
+ **Effectuer un arrêt et un démarrage manuels :** vous pouvez arrêter et démarrer l’instance, ce qui a pour effet de la transférer vers un nouvel hôte. Ce n’est pas la même chose que le redémarrage de l’instance. Pour de plus amples informations, veuillez consulter [Arrêtez et démarrez des instances Amazon EC2](Stop_Start.md).
+ **Automatiser l’arrêt et le démarrage :** vous pouvez automatiser un arrêt immédiat et un démarrage en réponse à un événement de maintenance planifié. Pour plus d'informations, consultez [Exécution automatique d'opérations sur les instances EC2 en réponse aux événements décrits AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) dans le *AWS Health Guide de l'utilisateur*.

**Actions que vous pouvez effectuer pour les instances disposant d’un volume racine de stockage d’instances**

Lorsque vous recevez une notification d’événement `system-maintenance`, vous pouvez effectuer une des actions suivantes :
+ **Attendre la maintenance planifiée :** vous pouvez attendre que la maintenance ait lieu comme prévu.
+ **Lancer une instance de remplacement :** si vous souhaitez maintenir un fonctionnement normal pendant la période de maintenance planifiée :

  1. Lancez une instance de remplacement à partir de votre AMI la plus récente.

  1. Procédez à la migration de toutes les données nécessaires vers l’instance de remplacement avant la fenêtre de maintenance planifiée.

  1. Résiliez l’instance d’origine.

# Affichez les événements programmées qui affectent vos instances Amazon EC2
<a name="viewing_scheduled_events"></a>

En plus de recevoir une notification des événements planifiés par e-mail, vous pouvez vérifier la présence d’événements planifiés.

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

**Pour afficher les événements planifiés pour vos instances**

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

1. Le tableau de bord affiche toutes les ressources avec un événement associé sous **Événements planifiés**.  
![\[Affichage d’événements à l’aide du tableau de bord.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/dashboard-scheduled-events.png)

1. Pour obtenir plus de détails, sélectionnez **Événements** dans le volet de navigation. Toutes les ressources avec un événement associé sont affichées. Vous pouvez filtrer par caractéristiques telles que le type d’événement, le type de ressource et la zone de disponibilité.  
![\[Affichage d’événements à l’aide de la page Événements.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/events-instance-scheduled-stop.png)

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

**Pour afficher les événements planifiés pour vos instances**  
Utilisez la commande [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html).

```
aws ec2 describe-instance-status \
    --instance-id i-1234567890abcdef0 \
    --query "InstanceStatuses[].Events"
```

L’exemple de sortie suivant montre un événement de redémarrage :

```
[
    "Events": [
        {
            "InstanceEventId": "instance-event-0d59937288b749b32",
            "Code": "system-reboot",
            "Description": "The instance is scheduled for a reboot",
            "NotAfter": "2019-03-15T22:00:00.000Z",
            "NotBefore": "2019-03-14T20:00:00.000Z",
            "NotBeforeDeadline": "2019-04-05T11:00:00.000Z"
         }

    ]
]
```

Voici un exemple de sortie montrant un événement de mise hors service d’instance.

```
[
    "Events": [
        {
            "InstanceEventId": "instance-event-0e439355b779n26",                        
            "Code": "instance-stop",
            "Description": "The instance is running on degraded hardware",
            "NotBefore": "2015-05-23T00:00:00.000Z"
        }
    ]
]
```

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

**Pour afficher les événements planifiés pour vos instances**  
Utilisez la commande [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html) suivante.

```
(Get-EC2InstanceStatus -InstanceId i-1234567890abcdef0).Events
```

Voici un exemple de sortie montrant un événement de mise hors service d’instance.

```
Code         : instance-stop
Description  : The instance is running on degraded hardware
NotBefore    : 5/23/2015 12:00:00 AM
```

------
#### [ Instance metadata ]

**Pour afficher les événements planifiés pour vos instances à l’aide des métadonnées de l’instance**  
Vous pouvez récupérer des informations sur les événements de maintenance actifs pour vos instances à partir des [métadonnées de l’instance](ec2-instance-metadata.md) à l’aide de Service des métadonnées d’instance Version 2 ou Service des métadonnées d’instance Version 1.

**IMDSv2**

```
[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/events/maintenance/scheduled
```

**IMDSv1**

```
[ec2-user ~]$ curl http://169.254.169.254/latest/meta-data/events/maintenance/scheduled
```

Voici un exemple de sortie avec des informations sur un événement de redémarrage système planifié, au format JSON.

```
[ 
  {
    "NotBefore" : "21 Jan 2019 09:00:43 GMT",
    "Code" : "system-reboot",
    "Description" : "scheduled reboot",
    "EventId" : "instance-event-0d59937288b749b32",
    "NotAfter" : "21 Jan 2019 09:17:23 GMT",
    "State" : "active"
  } 
]
```

**Pour afficher l’historique des événements terminés ou annulés pour vos instances à l’aide des métadonnées de l’instance**  
Vous pouvez récupérer des informations sur les événements terminés ou annulés pour vos instances à partir des [métadonnées de l’instance](ec2-instance-metadata.md) à l’aide de Service des métadonnées d’instance Version 2 ou Service des métadonnées d’instance Version 1.

**IMDSv2**

```
[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/events/maintenance/history
```

**IMDSv1**

```
[ec2-user ~]$ curl http://169.254.169.254/latest/meta-data/events/maintenance/history
```

Voici un exemple de sortie avec des informations sur un événement de redémarrage du système qui a été annulé et un événement de redémarrage du système qui a été terminé, au format JSON.

```
[ 
  {
    "NotBefore" : "21 Jan 2019 09:00:43 GMT",
    "Code" : "system-reboot",
    "Description" : "[Canceled] scheduled reboot",
    "EventId" : "instance-event-0d59937288b749b32",
    "NotAfter" : "21 Jan 2019 09:17:23 GMT",
    "State" : "canceled"
  }, 
  {
    "NotBefore" : "29 Jan 2019 09:00:43 GMT",
    "Code" : "system-reboot",
    "Description" : "[Completed] scheduled reboot",
    "EventId" : "instance-event-0d59937288b749b32",
    "NotAfter" : "29 Jan 2019 09:17:23 GMT",
    "State" : "completed"
  }
]
```

------
#### [ AWS Health ]

Vous pouvez utiliser le Tableau de bord AWS Health pour en savoir plus sur les événements susceptibles d'affecter votre instance. Il Tableau de bord Health organise les problèmes en trois groupes : les problèmes ouverts, les modifications planifiées et les autres notifications. Le groupe des modifications planifiées contient des éléments qui sont en cours ou à venir.

Pour plus d’informations, consultez [Premiers pas avec le Tableau de bord AWS Health](https://docs.aws.amazon.com/health/latest/ug/getting-started-health-dashboard.html) dans le *Guide de l’utilisateur AWS Health *.

------

# Personnalisation des notifications par e-mail pour les événements programmés qui affectent les instances Amazon EC2
<a name="customizing_scheduled_event_notifications"></a>

Vous pouvez personnaliser les notifications d’événements planifiés pour inclure des balises dans la notification par e-mail. Cela facilite l’identification de la ressource affectée (instances ou Hôtes dédiés) et la hiérarchisation des actions pour l’événement à venir.

Lorsque vous personnalisez les notifications d’événements pour inclure des balises, vous pouvez choisir d’inclure :
+ Toutes les balises associées à la ressource affectée
+ Seules les balises spécifiques associées à la ressource affectée

Par exemple, supposons que vous assignez les balises `application`, `costcenter`, `project` et `owner` à toutes vos instances. Vous pouvez choisir d’inclure toutes les balises dans les notifications d’événements. Sinon, si vous souhaitez afficher uniquement les balises `owner` et `project` dans les notifications d’événements, vous pouvez choisir d’inclure uniquement ces balises.

Après avoir sélectionné les balises à inclure, les notifications d’événement incluront l’ID de ressource (ID d’instance ou Hôte dédié) et les paires clé de balise et valeur associées à la ressource affectée.

**Topics**
+ [

## Inclure des balises dans les notifications d’événements
](#register-tags)
+ [

## Supprimer les balises des notifications d’événements
](#deregister-tags)
+ [

## Afficher les balises à inclure dans les notifications d’événements
](#view-tags)

## Inclure des balises dans les notifications d’événements
<a name="register-tags"></a>

Les balises que vous choisissez d’inclure s’appliquent à toutes les ressources (instances et Hôtes dédiés) de la région sélectionnée. Pour personnaliser les notifications d’événements dans d’autres régions, sélectionnez d’abord la région requise, puis effectuez les étapes suivantes.

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

**Pour inclure des balises dans les notifications d’événements**

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

1. Dans le volet de navigation, sélectionnez **Événements**.

1. Choisissez **Actions**, **Manage event notifications (Gérer les notifications d’événements)**.

1. Activez **Inclure des balises dans les notifications d’événements**.

1. Faites l’une des opérations suivantes, en fonction des balises que vous souhaitez inclure dans les notifications d’événement :
   + Pour inclure toutes les balises associées à l’instance affectée ou Hôte dédié, sélectionnez **Inclure toutes les balises de ressource**.
   + Pour sélectionner les balises à inclure, sélectionnez **Choisir les balises à inclure**, puis sélectionnez ou saisissez les clés de balise.

1. Choisissez **Enregistrer**.

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

**Pour inclure toutes les balises dans les notifications d’événements**  
Utilisez la commande [register-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-instance-event-notification-attributes.html) et définissez le `IncludeAllTagsOfInstance` paramètre sur. `true`

```
aws ec2 register-instance-event-notification-attributes \
    --instance-tag-attribute "IncludeAllTagsOfInstance=true"
```

**Pour inclure des balises spécifiques dans les notifications d’événements**  
Utilisez la commande [register-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-instance-event-notification-attributes.html) et spécifiez les balises à inclure à l'aide du `InstanceTagKeys` paramètre.

```
aws ec2 register-instance-event-notification-attributes \
    --instance-tag-attribute 'InstanceTagKeys=["tag_key_1", "tag_key_2", "tag_key_3"]'
```

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

**Pour inclure toutes les balises dans les notifications d’événements**  
Utilisez l’applet de commande [Register-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventNotificationAttribute.html).

```
Register-EC2InstanceEventNotificationAttribute `
    -InstanceTagAttribute_IncludeAllTagsOfInstance $true
```

**Pour inclure des balises spécifiques dans les notifications d’événements**  
Utilisez l’applet de commande [Register-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventNotificationAttribute.html).

```
Register-EC2InstanceEventNotificationAttribute `
    -InstanceTagAttribute_InstanceTagKey tag_key_1, tag_key_2, tag_key_3
```

------

## Supprimer les balises des notifications d’événements
<a name="deregister-tags"></a>

Vous pouvez supprimer les balises des notifications d’événements.

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

**Pour supprimer les balises des notifications d’événements**

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

1. Dans le volet de navigation, sélectionnez **Événements**.

1. Choisissez **Actions**, **Manage event notifications (Gérer les notifications d’événements)**.

1. Pour supprimer toutes les balises des notifications d’événement, désactivez **Inclure des balises dans les notifications d’événement**.

1. Pour supprimer des balises spécifiques des notifications d’événements, sélectionnez le **X**) pour les clés de balise correspondantes.

1. Choisissez **Enregistrer**.

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

**Pour supprimer toutes les balises des notifications d’événements**  
Utilisez la commande [deregister-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/deregister-instance-event-notification-attributes.html) et définissez le `IncludeAllTagsOfInstance` paramètre sur. `false`

```
aws ec2 deregister-instance-event-notification-attributes \
    --instance-tag-attribute "IncludeAllTagsOfInstance=false"
```

**Pour supprimer une balise des notifications d’événements**  
Utilisez la commande [deregister-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/deregister-instance-event-notification-attributes.html) et spécifiez les balises à supprimer à l'aide du `InstanceTagKeys` paramètre.

```
aws ec2 deregister-instance-event-notification-attributes \
    --instance-tag-attribute 'InstanceTagKeys=["tag_key_3"]'
```

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

**Pour supprimer toutes les balises des notifications d’événements**  
Utilisez l’applet de commande [Unregister-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventNotificationAttribute.html).

```
Unregister-EC2InstanceEventNotificationAttribute `
    -InstanceTagAttribute_IncludeAllTagsOfInstance $false
```

**Pour supprimer une balise des notifications d’événements**  
Utilisez l’applet de commande [Unregister-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventNotificationAttribute.html).

```
Unregister-EC2InstanceEventNotificationAttribute `
    -InstanceTagAttribute_InstanceTagKey tag_key_3
```

------

## Afficher les balises à inclure dans les notifications d’événements
<a name="view-tags"></a>

Vous pouvez afficher les balises qui doivent être incluses dans les notifications d’événements.

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

**Pour afficher les balises à inclure dans les notifications d’événements**

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

1. Dans le volet de navigation, sélectionnez **Événements**.

1. Choisissez **Actions**, **Manage event notifications (Gérer les notifications d’événements)**.

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

**Pour afficher les balises à inclure dans les notifications d’événements**  
Utilisez la commande [describe-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-event-notification-attributes.html).

```
aws ec2 describe-instance-event-notification-attributes
```

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

**Pour afficher les balises à inclure dans les notifications d’événements**  
Utilisez l’applet de commande [Get-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceEventNotificationAttribute.html).

```
Get-EC2InstanceEventNotificationAttribute
```

------

# Replanification d’un événement planifié pour une instance EC2
<a name="reschedule-event"></a>

Vous pouvez replanifier un événement de sorte qu’il se produise à une date et une heure spécifiques qui vous conviennent. Une fois que vous avez reprogrammé un événement, l’affichage de la date actualisée peut prendre une minute ou deux.

**Limitations**
+ Seuls les événements dotés d’une date d’échéance d’événement peuvent être reprogrammés. L’événement peut être reprogrammé jusqu’à la date d’échéance de celui-ci. La date limite de l’événement est indiquée dans la colonne **Échéance** (console) et dans le champ `NotBeforeDeadline` (AWS CLI).
+ Seuls les événements n’ayant pas encore démarré peuvent être reprogrammés. L’heure de début est indiquée dans la colonne **Heure de début** (console) et dans le champ `NotBefore` (AWS CLI). Les événements planifiés pour un lancement dans les 5 prochaines minutes ne peuvent pas être replanifiés.
+ La nouvelle heure de début doit être au moins 60 minutes après l’heure actuelle.
+ Si vous reprogrammez plusieurs événements à l’aide de la console, la date d’échéance de l’événement est déterminée par l’événement avec la date d’échéance d’événement la plus proche. 

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

**Pour replanifier un événement**

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

1. Dans le volet de navigation, sélectionnez **Événements**.

1. Choisissez **Type de ressource : instance** dans la liste des filtres.

1. Sélectionnez une ou plusieurs instances, puis sélectionnez **Actions**, **Schedule Event (Programmer un événement)**.

   Seuls les événements ayant une date d’échéance, indiquée par la valeur **Event Deadline (Échéance de l’événement)**, peuvent être reprogrammés. Si l’un des événements sélectionnés n’a pas de date d’échéance, **Actions**, **Schedule Event (Programmer un événement)** est désactivé.

1. Dans **New start time (Nouvelle heure de début)**, saisissez une nouvelle date et une nouvelle heure pour l’événement. La nouvelle date et la nouvelle heure doivent être antérieures à la valeur de **Event Deadline (Échéance de l’événement)**.

1. Choisissez **Enregistrer**.

   L'heure de démarrage mise à jour peut prendre une à deux minutes pour s'afficher dans la console.

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

**Pour replanifier un événement**  
Utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-start-time.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-start-time.html).

```
aws ec2 modify-instance-event-start-time \
    --instance-id i-1234567890abcdef0 \
    --instance-event-id instance-event-0d59937288b749b32 \
    --not-before 2020-03-25T10:00:00.000
```

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

**Pour replanifier un événement**  
Utilisez l’applet de commande [Edit-EC2InstanceEventStartTime](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventStartTime.html).

```
Edit-EC2InstanceEventStartTime `
    -InstanceId i-1234567890abcdef0 `
    -InstanceEventId instance-event-0d59937288b749b32 `
    -NotBefore 2020-03-25T10:00:00.000
```

------

# Créez des fenêtres d'événements personnalisées pour les événements programmés qui affectent vos instances Amazon EC2
<a name="event-windows"></a>

Vous pouvez définir des fenêtres d’événements hebdomadaires personnalisées récurrentes pour des événements planifiés qui redémarrent, arrêtent ou résilient vos instances Amazon EC2. Vous pouvez associer une ou plusieurs instances à une fenêtre d’événements. Si un événement est planifié pour ces instances, AWS planifiera les événements dans la fenêtre d’événements associée.

Vous pouvez utiliser des fenêtres d’événements afin d’optimiser la disponibilité de la charge de travail globale en spécifiant des fenêtres d’événements pendant des périodes creuses pour cette charge de travail. Vous pouvez également aligner les fenêtres d’événements avec vos planifications de maintenance internes.

Vous définissez une fenêtre d’événements en spécifiant un ensemble de plages de temps. La plage de temps minimale est de 2 heures. Les plages de temps combinées doivent totaliser au moins 4 heures.

Vous pouvez associer une ou plusieurs instances à une fenêtre d'événements à l'aide d'instances IDs ou de balises d'instance. Vous pouvez également associer des hôtes dédiés à une fenêtre d’événements en utilisant l’ID d’hôte.

**Avertissement**  
Les fenêtres d’événements s’appliquent uniquement à des événements planifiés qui arrêtent, redémarrent ou résilient des instances.  
Les fenêtres d’événements ne sont pas applicables aux événements suivants :  
Événements planifiés accélérés et événements de maintenance du réseau. 
Maintenance non programmée, telle que la [récupération automatique des instances](ec2-instance-recover.md) et les redémarrages non planifiés.

**Topics**
+ [

## Considérations
](#event-windows-considerations)
+ [

## Créer une fenêtre d’événements
](#create-event-windows)
+ [

## Associer une cible à une fenêtre d’événements
](#associate-target-event-window)
+ [

## Dissociation d’une cible d’une fenêtre d’événements
](#disassociate-target-event-window)
+ [

## Modification d’une fenêtre d’événements
](#modify-event-windows)
+ [

## Suppression d’une fenêtre d’événements
](#delete-event-windows)

## Considérations
<a name="event-windows-considerations"></a>
+ Toutes les heures de fenêtre d’événements sont au format UTC.
+ Une fenêtre d’événements peut contenir plusieurs plages temporelles. Bien que chaque plage individuelle doive durer au moins 2 heures, la durée totale de toutes les plages doit être d’au moins 4 heures.
+ Un seul type de cible (ID d’instance, ID d’hôte dédié ou étiquette d’instance) peut être associé à une fenêtre d’événements.
+ Une cible (ID d’instance, ID d’hôte dédié ou étiquette d’instance) ne peut être associée qu’à à une fenêtre d’événements.
+ Un maximum de 100 instances IDs, 50 hôtes IDs dédiés ou 50 balises d'instance peuvent être associées à une fenêtre d'événements. Les étiquettes d’instance peuvent être associées à un nombre quelconque d’instances.
+ Un maximum de 200 fenêtres d'événements peuvent être créées par AWS région.
+ Plusieurs instances associées à des fenêtres d’événements peuvent avoir des événements planifiés se produisant en même temps.
+ Si vous avez AWS déjà planifié un événement, la modification d'une fenêtre d'événements ne changera pas l'heure de l'événement planifié. Si l’événement a une date d’échéance, vous pouvez [replanifier l’événement](reschedule-event.md).
+ Vous pouvez arrêter et démarrer une instance avant l’événement planifié. Cette opération a pour effet de transférer l’instance vers un nouvel hôte et de supprimer l’événement.

## Créer une fenêtre d’événements
<a name="create-event-windows"></a>

Vous pouvez créer une ou plusieurs fenêtres d’événements. Pour chaque fenêtre d’événements, vous spécifiez un ou plusieurs blocs de temps. Par exemple, vous pouvez créer une fenêtre d’événements avec des blocs de temps qui se produisent tous les jours à 4 heures du matin pendant 2 heures. Ou vous pouvez créer une fenêtre d’événements avec des blocs de temps qui se produisent les dimanches de 2 à 4 heures et les mercredis de 3 à 5 heures.

Les fenêtres d’événements se reproduisent à une fréquence hebdomadaire jusqu’à ce que vous les supprimiez.

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

**Pour créer une fenêtre d'événements**

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, sélectionnez **Events**.

1. Choisissez **Actions**, **Gérer les fenêtres d’événements**.

1. Choisissez **Créer une fenêtre d’événements d’instance**.

1. Pour **Nom de la fenêtre d’événements**, saisissez un nom descriptif.

1. Pour **Planification de la fenêtre d’événements**, choisissez de spécifier les blocs de temps dans la fenêtre d’événements à l’aide du générateur de planification cron ou en spécifiant des plages de temps.
   + Si vous choisissez **Générateur de planification Cron**, spécifiez les paramètres suivants :

     1. Pour **Jours (UTC)**, spécifiez les jours de la semaine où la fenêtre d’événements se produit.

     1. Pour **Heure de début (UTC)**, spécifiez l’heure à laquelle la fenêtre d’événements commence.

     1. Pour **Durée**, spécifiez la durée des blocs de temps dans la fenêtre d’événements. La durée minimale par bloc de temps est de 2 heures. La durée minimale de la fenêtre d’événements doit être égale ou supérieure à 4 heures au total. Toutes les heures sont indiquées en heure universelle coordonnée (UTC).
   + Si vous choisissez **Plages de temps**, choisissez **Ajouter une nouvelle plage de temps**, puis spécifiez le jour et l’heure de début, ainsi que le jour et l’heure de fin. Répétez l’opération pour chaque plage de temps. La durée minimale par plage de temps est de 2 heures. La durée minimale pour toutes les plages de temps combinées doit être égale ou supérieure à 4 heures au total.

1. (Facultatif) Pour **Informations sur la cible**, associez une ou plusieurs instances à la fenêtre d’événements. Utilisez des instances IDs ou des balises d'instance pour associer des instances. Utilisez host IDs pour associer des hôtes dédiés. Lorsque la maintenance de ces cibles est planifiée, l’événement se produit au cours de cette fenêtre d’événements. 

   Notez que vous pouvez créer la fenêtre d’événements sans y associer de cible. Plus tard, vous pourrez modifier la fenêtre pour associer une ou plusieurs cibles.

1. (Facultatif) Pour **Etiquettes de la fenêtre d’événements**, choisissez **Ajouter une étiquette**, puis saisissez la clé et la valeur de l’étiquette. Répétez l’opération pour chaque étiquette.

1. Choisissez **Créer une fenêtre d’événements**.

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

**Pour créer une fenêtre d'événements avec une plage de temps**  
Utilisez la commande [create-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-instance-event-window.html).

```
aws ec2 create-instance-event-window \
    --time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 \
    --tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \
    --name myEventWindowName
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "TimeRanges": [
            {
                "StartWeekDay": "monday",
                "StartHour": 2,
                "EndWeekDay": "wednesday",
                "EndHour": 8
            }
        ],
        "Name": "myEventWindowName",
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}
```

**Pour créer une fenêtre d'événements avec une expression cron à**  
Utilisez la commande [create-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-instance-event-window.html).

```
aws ec2 create-instance-event-window \
    --cron-expression "* 21-23 * * 2,3" \
    --tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \
    --name myEventWindowName
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}
```

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

**Pour créer une fenêtre d'événements avec une plage de temps**  
Utilisez l’applet de commande [New-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2InstanceEventWindow.html).

```
$timeRange = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest
$timeRange.StartWeekDay = "monday"
$timeRange.EndWeekDay = "wednesday"
$timeRange.StartHour = 2
$timeRange.EndHour = 8
$tag = @{Key="key1"; Value="value1"}
$tagspec = New-Object Amazon.EC2.Model.TagSpecification
$tagspec.ResourceType = "instance-event-window"
$tagspec.Tags.Add($tag)
New-EC2InstanceEventWindow `
    -Name my-event-window `
    -TagSpecification $tagspec `
    -TimeRange @($timeRange)
```

Voici un exemple de sortie.

```
AssociationTarget     : 
CronExpression        : 
InstanceEventWindowId : iew-0abcdef1234567890
Name                  : my-event-window
State                 : creating
Tags                  : {key1}
TimeRanges            : {Amazon.EC2.Model.InstanceEventWindowTimeRange}
```

**Pour créer une fenêtre d'événements avec une expression cron à**  
Utilisez l’applet de commande [New-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2InstanceEventWindow.html).

```
$tag = @{Key="key1"; Value="value1"}
$tagspec = New-Object Amazon.EC2.Model.TagSpecification
$tagspec.ResourceType = "instance-event-window"
$tagspec.Tags.Add($tag)
New-EC2InstanceEventWindow `
    -Name my-event-window `
    -TagSpecification $tagspec`
    -CronExpression "* 21-23 * * 2,3"
```

Voici un exemple de sortie.

```
AssociationTarget     : 
CronExpression        : * 21-23 * * 2,3
InstanceEventWindowId : iew-0abcdef1234567890
Name                  : my-event-window
State                 : creating
Tags                  : {key1}
TimeRanges            : {}
```

------

## Associer une cible à une fenêtre d’événements
<a name="associate-target-event-window"></a>

Après avoir créé une fenêtre d’événements, vous pouvez associer des cibles à la fenêtre d’événements. Vous ne pouvez associer qu’un seul type de cible à une fenêtre d’événements. Vous pouvez spécifier une instance IDs, un hôte IDs dédié ou des balises d'instance.

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

**Pour associer des cibles à une fenêtre d’événements**

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, sélectionnez **Events**.

1. Sélectionnez la fenêtre d’événements à modifier.

1. Choisissez **Actions**, puis **Modifier la fenêtre d’événements de l’instance**.

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

**Pour associer des étiquettes d'instance à une fenêtre d'événements**  
Utilisez la commande [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html).

```
aws ec2 associate-instance-event-window \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]"
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [
                {
                    "Key": "k2",
                    "Value": "v2"
                },
                {
                    "Key": "k1",
                    "Value": "v1"
                }
            ],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}
```

**Pour associer une instance IDs à une fenêtre d'événements**  
Utilisez la commande [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html).

```
aws ec2 associate-instance-event-window \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7"
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [
                "i-1234567890abcdef0",
                "i-0598c7d356eba48d7"
            ],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}
```

**Pour associer un hôte dédié à une fenêtre d'événements**  
Utilisez la commande [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html).

```
aws ec2 associate-instance-event-window \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "DedicatedHostIds=h-029fa35a02b99801d"
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": [
                "h-029fa35a02b99801d"
            ]
        },
        "State": "creating"
    }
}
```

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

**Pour associer des étiquettes d'instance à une fenêtre d'événements**  
Utilisez l’applet de commande [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html).

```
$tag1 = @{Key="key1"; Value="value1"}
$tag2 = @{Key="key2"; Value="value2"}
Register-EC2InstanceEventWindow `
    -InstanceEventWindowId iew-0abcdef1234567890 `
    -AssociationTarget_InstanceTag @($tag1,$tag2)
```

**Pour associer une instance IDs à une fenêtre d'événements**  
Utilisez l’applet de commande [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html).

```
Register-EC2InstanceEventWindow `
    -InstanceEventWindowId iew-0abcdef1234567890 `
    -AssociationTarget_InstanceId i-1234567890abcdef0, i-0598c7d356eba48d7
```

**Pour associer un hôte dédié à une fenêtre d'événements**  
Utilisez l’applet de commande [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html).

```
Register-EC2InstanceEventWindow `
    -InstanceEventWindowId iew-0abcdef1234567890 `
    -AssociationTarget_DedicatedHostId h-029fa35a02b99801d
```

------

## Dissociation d’une cible d’une fenêtre d’événements
<a name="disassociate-target-event-window"></a>

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

**Pour dissocier des cibles d’une fenêtre d’événements**

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, sélectionnez **Events**.

1. Sélectionnez la fenêtre d’événements à modifier.

1. Choisissez **Actions**, puis **Modifier la fenêtre d’événements de l’instance**.

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

**Pour dissocier des étiquettes d'instance d'une fenêtre d'événements**  
Utilisez la commande [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference//ec2/disassociate-instance-event-window.html).

```
aws ec2 disassociate-instance-event-window \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]"
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}
```

**Pour dissocier une instance IDs d'une fenêtre d'événements**  
Utilisez la commande [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/disassociate-instance-event-window.html).

```
aws ec2 disassociate-instance-event-window \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7"
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}
```

**Pour dissocier un hôte dédié d'une fenêtre d'événements**  
Utilisez la commande [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/disassociate-instance-event-window.html).

```
aws ec2 disassociate-instance-event-window \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target DedicatedHostIds=h-029fa35a02b99801d
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}
```

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

**Pour dissocier des étiquettes d'instance d'une fenêtre d'événements**  
Utilisez l’applet de commande [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html).

```
$tag1 = @{Key="key1"; Value="value1"}
$tag2 = @{Key="key2"; Value="value2"}
Unregister-EC2InstanceEventWindow `
    -InstanceEventWindowId iew-0abcdef1234567890 `
    -AssociationTarget_InstanceTag @($tag1, $tag2)
```

**Pour dissocier une instance IDs d'une fenêtre d'événements**  
Utilisez l’applet de commande [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html).

```
Unregister-EC2InstanceEventWindow `
    -InstanceEventWindowId iew-0abcdef1234567890 `
    -AssociationTarget_InstanceId i-1234567890abcdef0, i-0598c7d356eba48d7
```

**Pour dissocier un hôte dédié d'une fenêtre d'événements**  
Utilisez l’applet de commande [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html).

```
Unregister-EC2InstanceEventWindow `
    -InstanceEventWindowId iew-0abcdef1234567890 `
    -AssociationTarget_DedicatedHostId h-029fa35a02b99801d
```

------

## Modification d’une fenêtre d’événements
<a name="modify-event-windows"></a>

Vous pouvez modifier tous les champs d’une fenêtre d’événements à l’exception de son ID. Par exemple, quand l’heure d’été commence, vous pouvez modifier la planification de la fenêtre d’événements. Pour des fenêtres d’événements existantes, vous pouvez ajouter ou supprimer des cibles.

Lors de la modification de la fenêtre d’événements, vous pouvez modifier une plage de temps ou une expression cron, mais pas les deux.

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

**Pour modifier une fenêtre d'événements**

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, sélectionnez **Events**.

1. Choisissez **Actions**, **Gérer les fenêtres d’événements**.

1. Sélectionnez la fenêtre d’événements à modifier, puis choisissez **Actions**, **Modifier la fenêtre d’événements d’instance**.

1. Modifiez les champs de la fenêtre d’événements, puis choisissez **Modifier la fenêtre d’événements**.

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

**Pour modifier la plage de temps d'une fenêtre d'événements**  
Utilisez la commande [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html).

```
aws ec2 modify-instance-event-window 
    --instance-event-window-id iew-0abcdef1234567890 \
    --time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "TimeRanges": [
            {
                "StartWeekDay": "monday",
                "StartHour": 2,
                "EndWeekDay": "wednesday",
                "EndHour": 8
            }
        ],
        "Name": "myEventWindowName",
        "AssociationTarget": {
            "InstanceIds": [
                "i-0abcdef1234567890",
                "i-0be35f9acb8ba01f0"
            ],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}
```

**Pour modifier une ensemble de plages de temps pour une fenêtre d'événements**  
Utilisez la commande [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html).

```
aws ec2 modify-instance-event-window 
    --instance-event-window-id iew-0abcdef1234567890 \
    --time-range '[{"StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8},
	  {"StartWeekDay": "thursday", "StartHour": 2, "EndWeekDay": "friday", "EndHour": 8}]'
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "TimeRanges": [
            {
                "StartWeekDay": "monday",
                "StartHour": 2,
                "EndWeekDay": "wednesday",
                "EndHour": 8
            },
            {
                "StartWeekDay": "thursday",
                "StartHour": 2,
                "EndWeekDay": "friday",
                "EndHour": 8
            }
        ],
        "Name": "myEventWindowName",
        "AssociationTarget": {
            "InstanceIds": [
                "i-0abcdef1234567890",
                "i-0be35f9acb8ba01f0"
            ],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}
```

**Pour modifier l'expression cron d'une fenêtre d'événements**  
Utilisez la commande [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html).

```
aws ec2 modify-instance-event-window 
    --instance-event-window-id iew-0abcdef1234567890 \
    --cron-expression "* 21-23 * * 2,3"
```

Voici un exemple de sortie.

```
{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [
                "i-0abcdef1234567890",
                "i-0be35f9acb8ba01f0"
            ],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}
```

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

**Pour modifier la plage de temps d'une fenêtre d'événements**  
Utilisez l’applet de commande [Edit-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventWindow.html).

```
$timeRange1 = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest
$timeRange1.StartWeekDay = "monday"
$timeRange1.EndWeekDay = "wednesday"
$timeRange1.StartHour = 2
$timeRange1.EndHour = 8
$timeRange2 = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest
$timeRange2.StartWeekDay = "thursday"
$timeRange2.EndWeekDay = "friday"
$timeRange2.StartHour = 1
$timeRange2.EndHour = 6
Edit-EC2InstanceEventWindow `
    -InstanceEventWindowId iew-0abcdef1234567890 `
    -TimeRange @($timeRange1, $timeRange2)
```

**Pour modifier l'expression cron d'une fenêtre d'événements**  
Utilisez l’applet de commande [Edit-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventWindow.html).

```
Edit-EC2InstanceEventWindow `
    -InstanceEventWindowId iew-0abcdef1234567890 `
    -CronExpression "* 21-23 * * 2,3"
```

------

## Suppression d’une fenêtre d’événements
<a name="delete-event-windows"></a>

Vous pouvez supprimer une fenêtre d’événements à la fois.

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

**Pour supprimer une fenêtre d'événements**

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, sélectionnez **Events**.

1. Choisissez **Actions**, **Gérer les fenêtres d’événements**.

1. Sélectionnez la fenêtre d’événements à supprimer, puis choisissez **Actions**, **Supprimer la fenêtre d’événements d’instance**.

1. Lorsque vous y êtes invité, tapez **delete**, puis choisissez **Supprimer**.

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

**Pour supprimer une fenêtre d'événements**  
Utilisez la [delete-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-instance-event-window.html)commande et spécifiez la fenêtre d'événements à supprimer.

```
aws ec2 delete-instance-event-window \
    --instance-event-window-id iew-0abcdef1234567890
```

**Pour supprimer de force une fenêtre d’événements**  
Utilisez le paramètre `--force-delete` si la fenêtre d’événements est actuellement associée à des cibles.

```
aws ec2 delete-instance-event-window \
    --instance-event-window-id iew-0abcdef1234567890 \
    --force-delete
```

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

**Pour supprimer une fenêtre d'événements**  
Utilisez l’applet de commande [Remove-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2InstanceEventWindow.html).

```
Remove-EC2InstanceEventWindow `
    -InstanceEventWindowId iew-0abcdef1234567890
```

**Pour supprimer de force une fenêtre d’événements**  
Utilisez l’applet de commande [Remove-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2InstanceEventWindow.html).

```
Remove-EC2InstanceEventWindow `
    -InstanceEventWindowId iew-0abcdef1234567890 `
    -ForceDelete $true
```

------

# Surveillez vos instances à l'aide de CloudWatch
<a name="using-cloudwatch"></a>

Vous pouvez surveiller vos instances à l'aide d'Amazon CloudWatch, qui collecte et traite les données brutes d'Amazon EC2 pour en faire des métriques lisibles en temps quasi réel. Ces statistiques sont enregistrées pour une durée de 15 mois et, par conséquent, vous pouvez accéder aux informations historiques et acquérir un meilleur point de vue de la façon dont votre service ou application web s’exécute.

Par défaut, Amazon EC2 envoie des données métriques par intervalles de CloudWatch 5 minutes. Pour envoyer les données métriques de votre instance par périodes CloudWatch d'une minute, vous pouvez activer la surveillance détaillée de l'instance. Pour de plus amples informations, veuillez consulter [Gérez la surveillance détaillée de vos instances EC2](manage-detailed-monitoring.md).

La console Amazon EC2 affiche une série de graphiques basés sur les données brutes d'Amazon. CloudWatch Selon vos besoins, vous préférerez peut-être obtenir les données de vos instances auprès d'Amazon CloudWatch plutôt que de consulter les graphiques de la console.

Pour obtenir des informations sur la CloudWatch facturation et les coûts d'Amazon, consultez la section [ CloudWatch facturation et coûts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_billing.html) dans le *guide de CloudWatch l'utilisateur Amazon*.

**Topics**
+ [

# Gérez les CloudWatch alarmes pour vos instances EC2 dans la console Amazon EC2
](ec2-instance-alarms.md)
+ [

# Gérez la surveillance détaillée de vos instances EC2
](manage-detailed-monitoring.md)
+ [

# CloudWatch métriques disponibles pour vos instances
](viewing_metrics_with_cloudwatch.md)
+ [

# Installez et configurez l' CloudWatch agent à l'aide de la console Amazon EC2 pour ajouter des métriques supplémentaires
](install-and-configure-cloudwatch-agent-using-ec2-console.md)
+ [

# Statistiques pour les CloudWatch métriques relatives à vos instances
](monitoring_get_statistics.md)
+ [

# Affichez les graphiques de surveillance de vos instances
](graphs-in-the-aws-management-console.md)
+ [

# Création d'une CloudWatch alarme pour une instance
](using-cloudwatch-createalarm.md)
+ [

# Créer des alarmes qui arrêtent, finissent, redémarrent ou récupèrent une instance
](UsingAlarmActions.md)

# Gérez les CloudWatch alarmes pour vos instances EC2 dans la console Amazon EC2
<a name="ec2-instance-alarms"></a>

Depuis l'écran **Instances** de la console Amazon EC2, vous pouvez gérer les CloudWatch alarmes Amazon pour vos instances. Dans le tableau **Instances**, la colonne **État de l'alarme** donne deux commandes de console : une commande pour afficher les alarmes et une autre pour les créer ou les modifier. La capture d’écran suivante indique ces commandes de console, numérotées **1** (**Afficher les alarmes**) et **2** (un signe **\$1** pour créer ou modifier une alarme).

![\[Les commandes dans le tableau Instances de la console EC2 pour la visualisation et la création d'alarmes. 1. Afficher les alarmes 2. Symbole du signe plus.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/instance-alarms.png)


## Affichez les alarmes depuis l'écran Instances
<a name="view-ec2-instance-alarms"></a>

Vous pouvez afficher les alarmes de chaque instance depuis l'écran **Instances**.

**Pour afficher l'alarme d'une instance depuis l'écran Instances**

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. Dans le tableau **Instances**, pour l'instance choisie, sélectionnez **Afficher les alarmes** (numérotée **1** dans la capture d'écran précédente).

1. Dans la *i-1234567890abcdef0* fenêtre **Détails de l'alarme**, choisissez le nom de l'alarme pour afficher l'alarme dans la CloudWatch console.

## Créez des alarmes depuis l'écran Instances
<a name="create-ec2-instance-alarms"></a>

Vous pouvez créer une alarme pour chaque instance depuis l'écran **Instances**.

**Pour créer une alarme pour une instance depuis l'écran Instances**

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. Dans le tableau **Instances**, pour l'instance choisie, sélectionnez le signe plus (numéroté **2** dans la capture d'écran précédente).

1. Dans l'écran **Gérer les CloudWatch alarmes**, créez votre alarme. Pour de plus amples informations, veuillez consulter [Création d'une CloudWatch alarme pour une instance](using-cloudwatch-createalarm.md).

## Modifiez les alarmes depuis l'écran Instances
<a name="edit-ec2-instance-alarms"></a>

Vous pouvez modifier l'alarme d'une instance depuis l'écran **Instances**.

**Pour modifier une alarme pour une instance depuis l'écran Instances**

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. Dans le tableau **Instances**, pour l'instance choisie, sélectionnez le signe plus (numéroté **2** dans la capture d'écran précédente).

1. Dans l'écran **Gérer les CloudWatch alarmes**, modifiez votre alarme. Pour plus d'informations, consultez [Modifier ou supprimer une CloudWatch alarme](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Manage-CloudWatch-Alarm.html#Edit-CloudWatch-Alarm) dans le *guide de CloudWatch l'utilisateur Amazon*.

# Gérez la surveillance détaillée de vos instances EC2
<a name="manage-detailed-monitoring"></a>

Amazon CloudWatch propose deux catégories de surveillance : la *surveillance de base* et la *surveillance détaillée*. Par défaut, la surveillance basique est configurée pour votre instance. Vous pouvez éventuellement activer une surveillance détaillée pour vous aider à identifier plus rapidement les problèmes opérationnels et à y remédier. Vous pouvez activer ou désactiver la surveillance détaillée au lancement ou lors de l'exécution ou de l'arrêt de l'instance.

L'activation de la surveillance détaillée d'une instance n'affecte pas la surveillance des volumes EBS qui lui sont attachés. Pour plus d'informations, consultez les [ CloudWatch métriques Amazon pour Amazon EBS.](https://docs.aws.amazon.com/ebs/latest/userguide/using_cloudwatch_ebs.html)

Le tableau suivant met en évidence les différences entre la surveillance de base et la surveillance détaillée de vos instances.


| Type de surveillance | Description | Frais | 
| --- | --- | --- | 
| Surveillance de base |  Les métriques de contrôle de statut sont disponibles par périodes d’une minute. Toutes les autres métriques sont disponibles par périodes de cinq minutes.  | Aucuns frais. | 
| Surveillance détaillée | Vous pouvez obtenir les métriques toutes les minutes, à condition d’activer la surveillance détaillée sur l’instance. Une fois que vous avez activé la surveillance détaillée, vous pouvez regrouper les données dans des groupes d’instances similaires. | Vous êtes facturé par métrique envoyée par Amazon EC2. CloudWatch Vous n’êtes pas facturé pour le stockage des données. Pour plus d'informations, consultez la section Niveau payant sur la [page de CloudWatch tarification d'Amazon](https://aws.amazon.com/cloudwatch/pricing/#Paid_tier). | 

**Topics**
+ [

## Autorisations requises
](#iam-detailed-monitoring)
+ [

## Activez la surveillance détaillée au lancement
](#enable-detailed-monitoring)
+ [

## Gérez la surveillance détaillée
](#disable-detailed-monitoring)

## Autorisations requises
<a name="iam-detailed-monitoring"></a>

Pour activer la surveillance détaillée d’une instance, votre utilisateur doit être autorisé à utiliser l’action d’API [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_MonitorInstances.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_MonitorInstances.html). Pour désactiver la surveillance détaillée d’une instance, votre utilisateur doit être autorisé à utiliser l’action d’API [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_UnmonitorInstances.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_UnmonitorInstances.html). 

## Activez la surveillance détaillée au lancement
<a name="enable-detailed-monitoring"></a>

Utilisez les procédures suivantes pour activer la surveillance détaillée au lancement. Par défaut, votre instance utilise une surveillance basique.

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

**Pour activer la surveillance détaillée lors du lancement d’une instance**  
Lorsque vous lancez une instance à l'aide de la console Amazon EC2, sous **Détails avancés**, cochez la case ** CloudWatch Surveillance détaillée**.

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

**Pour activer la surveillance détaillée lors du lancement d’une instance**  
Utilisez la commande [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) avec l’option `--monitoring`.

```
--monitoring Enabled=true
```

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

**Pour activer la surveillance détaillée lors du lancement d’une instance**  
Utilisez l'[New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html)applet de commande avec le `-Monitoring` paramètre.

```
-Monitoring $true
```

------

## Gérez la surveillance détaillée
<a name="disable-detailed-monitoring"></a>

Utilisez les procédures suivantes pour gérer la surveillance détaillée d'une instance en cours d'exécution ou arrêtée.

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

**Pour gérer la surveillance détaillée**

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.

1. Choisissez **Actions**, **Surveiller et résoudre les problèmes**, **Gérer la surveillance détaillée**.

1. Sur la page **Surveillance détaillée**, pour **Surveillance détaillée**, effectuez l'une des opérations suivantes :
   + surveillance détaillée : sélectionnez **Activer**.
   + Surveillance basique : clair **Activer**.

1. Choisissez **Confirmer**.

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

**Pour activer la surveillance détaillée**  
Utilisez la commande [monitor-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/monitor-instances.html) suivante.

```
aws ec2 monitor-instances --instance-ids i-1234567890abcdef0
```

**Pour désactiver la surveillance détaillée**  
Utilisez la commande [unmonitor-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/unmonitor-instances.html).

```
aws ec2 unmonitor-instances --instance-ids i-1234567890abcdef0
```

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

**Pour activer la surveillance détaillée**  
Utilisez l’applet de commande [Start-EC2InstanceMonitoring](https://docs.aws.amazon.com/powershell/latest/reference/items/Start-EC2InstanceMonitoring.html).

```
Start-EC2InstanceMonitoring -InstanceId i-1234567890abcdef0
```

**Pour désactiver la surveillance détaillée**  
Utilisez l’applet de commande [Stop-EC2InstanceMonitoring](https://docs.aws.amazon.com/powershell/latest/reference/items/Stop-EC2InstanceMonitoring.html).

```
Stop-EC2InstanceMonitoring -InstanceId i-1234567890abcdef0
```

------

# CloudWatch métriques disponibles pour vos instances
<a name="viewing_metrics_with_cloudwatch"></a>

Amazon EC2 envoie des métriques à Amazon. CloudWatch Vous pouvez utiliser l'API AWS Management Console AWS CLI, le ou une API pour répertorier les métriques auxquelles Amazon EC2 envoie. CloudWatch Par défaut, chaque point de données couvre les 5 minutes suivant l’heure de début d’activité de l’instance. Si vous avez activé la surveillance détaillée, chaque point de données couvre la minute suivant l’activité à compte de l’heure de début. Notez que pour les statistiques Minimum, Maximum et Moyenne, la granularité minimale des métriques fournies par EC2 est de 1 minute.

Pour plus d'informations sur la façon de consulter les statistiques disponibles à l'aide du AWS Management Console ou du AWS CLI, consultez la section [Afficher les mesures disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) dans le *guide de CloudWatch l'utilisateur Amazon*.

Pour plus d’informations sur la façon d’obtenir les statistiques pour ces métriques, consultez [Statistiques pour les CloudWatch métriques relatives à vos instances](monitoring_get_statistics.md).

**Topics**
+ [

## Métriques des instances
](#ec2-cloudwatch-metrics)
+ [

## Métriques d’accélérateurs
](#accelerator-metrics)
+ [

## Métriques des crédits UC
](#cpu-credit-metrics)
+ [

## Métriques d’hôte dédié
](#dh-metrics)
+ [

## Métriques Amazon EBS pour des instances basées sur Nitro
](#ebs-metrics-nitro)
+ [

## Métriques de contrôle de statut
](#status-check-metrics)
+ [

## Métriques de mise en miroir du trafic
](#traffic-mirroring-metrics)
+ [

## Métriques du groupe Auto Scaling
](#autoscaling-metrics)
+ [

## Dimensions de métriques Amazon EC2
](#ec2-cloudwatch-dimensions)
+ [

## Métriques d’utilisation Amazon EC2
](#service-quota-metrics)

## Métriques des instances
<a name="ec2-cloudwatch-metrics"></a>

L’espace de nom `AWS/EC2` inclut les métriques d’instance suivantes.


| Métrique | Description | Unit | Statistiques significatives | 
| --- | --- | --- | --- | 
| CPUUtilization |  Le pourcentage de temps de CPU physique qu’Amazon EC2 utilise pour exécuter l’instance EC2, qui comprend le temps passé à exécuter à la fois le code utilisateur et le code Amazon EC2. À un niveau très élevé, `CPUUtilization` est la somme de l’invité `CPUUtilization` et de l’hyperviseur `CPUUtilization`. Les outils de votre système d'exploitation peuvent afficher un pourcentage différent de celui CloudWatch dû à des facteurs tels que la simulation d'appareils existants, la configuration d'appareils non existants, les charges de travail nécessitant de nombreuses interruptions, la migration en direct et la mise à jour en direct.  |  Percent  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| DiskReadOps |  Opérations de lecture terminées de tous les volumes de stockage d’instance disponibles pour l’instance, au cours de la période spécifiée. Pour calculer la moyenne I/O des opérations par seconde (IOPS) pour la période, divisez le total des opérations de la période par le nombre de secondes de cette période. S’il n’y a pas de volumes de stockage d’instance, la valeur est 0 ou la métrique n’est pas prise en charge.  |  Count  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| DiskWriteOps |  Opérations d’écriture terminées dans tous les volumes de stockage d’instance disponibles pour l’instance, au cours de la période spécifiée. Pour calculer la moyenne I/O des opérations par seconde (IOPS) pour la période, divisez le total des opérations de la période par le nombre de secondes de cette période. S’il n’y a pas de volumes de stockage d’instance, la valeur est 0 ou la métrique n’est pas prise en charge.  |  Count  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| DiskReadBytes |  Octets lus à partir de tous les volumes de stockage d’instance disponibles pour l’instance. Cette métrique permet de déterminer le volume de données que l’application lit à partir du disque dur de l’instance. Il est ainsi possible de déterminer la vitesse de l’application. Le nombre mentionné correspond au nombre d’octets reçus pendant la période. Si vous utilisez une surveillance de base (cinq minutes), vous pouvez diviser ce nombre par 300 pour trouver le nombre d’octets/seconde. Si vous avez recours à une surveillance détaillée (une minute), divisez-le par 60. Vous pouvez également utiliser la fonction mathématique CloudWatch métrique `DIFF_TIME` pour déterminer les octets par seconde. Par exemple, si vous avez représenté graphiquement `DiskReadBytes` CloudWatch comme`m1`, la formule mathématique de la métrique `m1/(DIFF_TIME(m1))` renvoie la métrique en octets/seconde. Pour plus d'informations sur les autres fonctions mathématiques métriques `DIFF_TIME` et sur d'autres, consultez la section [Utiliser les mathématiques métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) dans le *guide de CloudWatch l'utilisateur Amazon*. S’il n’y a pas de volumes de stockage d’instance, la valeur est 0 ou la métrique n’est pas prise en charge.  |  Bytes  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| DiskWriteBytes |  Octets écrits dans tous les volumes de stockage d’instance disponibles pour l’instance. Cette métrique permet de déterminer le volume de données que l’application écrit sur le disque dur de l’instance. Il est ainsi possible de déterminer la vitesse de l’application. Le nombre mentionné correspond au nombre d’octets reçus pendant la période. Si vous utilisez une surveillance de base (cinq minutes), vous pouvez diviser ce nombre par 300 pour trouver le nombre d’octets/seconde. Si vous avez recours à une surveillance détaillée (une minute), divisez-le par 60. Vous pouvez également utiliser la fonction mathématique CloudWatch métrique `DIFF_TIME` pour déterminer les octets par seconde. Par exemple, si vous avez représenté graphiquement `DiskWriteBytes` CloudWatch comme`m1`, la formule mathématique de la métrique `m1/(DIFF_TIME(m1))` renvoie la métrique en octets/seconde. Pour plus d'informations sur les autres fonctions mathématiques métriques `DIFF_TIME` et sur d'autres, consultez la section [Utiliser les mathématiques métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) dans le *guide de CloudWatch l'utilisateur Amazon*. S’il n’y a pas de volumes de stockage d’instance, la valeur est 0 ou la métrique n’est pas prise en charge.  |  Bytes  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| MetadataNoToken |  Nombre d'accès réussis au service de métadonnées d'instance (IMDS) à l'aide d'une méthode n'utilisant pas de jeton. Cette métrique est utilisée pour déterminer s'il existe des processus accédant aux métadonnées d'instance qui utilisent le service de métadonnées d'instance version 1 (IMDSv1), qui n'utilise pas de jeton. Si toutes les demandes utilisent des sessions basées sur des jetons, c'est-à-dire le service de métadonnées d'instance version 2 (IMDSv2), la valeur est 0. Pour de plus amples informations, veuillez consulter [Passer à l’utilisation de Service des métadonnées d’instance Version 2](instance-metadata-transition-to-version-2.md).  |  Count  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| MetadataNoTokenRejected |  Le nombre de tentatives d' IMDSv1 appel après avoir IMDSv1 été désactivé. Si cette métrique apparaît, elle indique qu'un IMDSv1 appel a été tenté et rejeté. Vous pouvez soit réactiver, IMDSv1 soit vous assurer que tous vos appels sont utilisés IMDSv2. Pour de plus amples informations, veuillez consulter [Passer à l’utilisation de Service des métadonnées d’instance Version 2](instance-metadata-transition-to-version-2.md).  |  Count  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| NetworkIn |  Nombre d’octets reçus par l’instance sur toutes les interfaces réseau. Cette métrique identifie le volume du trafic réseau entrant d’une seule instance. Le nombre mentionné correspond au nombre d’octets reçus pendant la période. Si vous utilisez une surveillance de base (cinq minutes) et que la statistique est Somme, vous pouvez diviser ce nombre par 300 pour trouver le nombre d’octets/seconde. Si vous utilisez une surveillance détaillée (une minute) et que la statistique est Somme, divisez-la par 60.  |  Bytes  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| NetworkOut |  Nombre d’octets envoyés par l’instance sur toutes les interfaces réseau. Cette métrique identifie le volume du trafic réseau sortant d’une seule instance. Le nombre mentionné correspond au nombre d’octets envoyés pendant la période. Si vous utilisez une surveillance de base (cinq minutes) et que la statistique est Somme, vous pouvez diviser ce nombre par 300 pour trouver le nombre d’octets/seconde. Si vous utilisez une surveillance détaillée (une minute) et que la statistique est Somme, divisez-la par 60.  |  Bytes  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| NetworkPacketsIn |  Nombre de paquets reçus par l’instance sur toutes les interfaces réseau. Cette métrique identifie le volume du trafic entrant en ce qui concerne le nombre de paquets sur une seule instance. Cette métrique est disponible uniquement pour la surveillance basique (périodes de cinq minutes). Pour calculer le nombre de paquets par seconde (PPS) reçu par votre instance en 5 minutes, divisez la valeur statistique Sum par 300.  |  Count  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| NetworkPacketsOut |  Nombre de paquets envoyés par l’instance sur toutes les interfaces réseau. Cette métrique identifie le volume du trafic sortant en ce qui concerne le nombre de paquets sur une seule instance. Cette métrique est disponible uniquement pour la surveillance basique (périodes de cinq minutes). Pour calculer le nombre de paquets par seconde (PPS) envoyé par votre instance en 5 minutes, divisez la valeur statistique Somme par 300.  |  Count  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 

## Métriques d’accélérateurs
<a name="accelerator-metrics"></a>

L’espace de noms `AWS/EC2` inclut la métrique d’accélérateur suivante pour vos [instances de calcul accéléré](https://docs.aws.amazon.com/ec2/latest/instancetypes/ac.html). Prise en charge uniquement sur un sous-ensemble de types d’instances de calcul accéléré.


| Métrique | Description | Unit | Statistiques significatives | 
| --- | --- | --- | --- | 
| GPUPowerUtilization | Consommation d’énergie active en pourcentage de la puissance active maximale. | Pourcentage |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 

## Métriques des crédits UC
<a name="cpu-credit-metrics"></a>

L’espace de noms `AWS/EC2` inclut les métriques de crédit UC suivantes pour vos [instances à capacité extensible](burstable-performance-instances.md).


| Métrique | Description | Unit | Statistiques significatives | 
| --- | --- | --- | --- | 
| CPUCreditUsage |  Nombre de crédits UC dépensés par l’instance pour l’utilisation de l’UC. Un crédit de processeur équivaut à un vCPU fonctionnant à 100 % d'utilisation pendant une minute ou une combinaison équivalente de vCPUs, d'utilisation et de temps (par exemple, un vCPU fonctionnant à 50 % d'utilisation pendant deux minutes ou deux vCPU CPUs fonctionnant à 25 % d'utilisation pendant deux minutes). Les métriques de crédits CPU sont disponibles toutes les 5 minutes uniquement. Si vous spécifiez une période supérieure à cinq minutes, utilisez la statistique `Sum` au lieu de la statistique `Average`.  |  Crédits (minutes vCPU)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| CPUCreditBalance |  Nombre de crédits UC gagnés qu’une instance a accumulés depuis son lancement ou son démarrage. Pour les instances T2 Standard, le `CPUCreditBalance` inclut également le nombre de crédits de lancement qui ont été accumulés. Les crédits sont accumulés dans le solde de crédits quand ils sont gagnés et supprimés du solde de crédits lorsqu’ils sont dépensés. Le solde de crédits présente une limite maximum qui est déterminée par la taille de l’instance. Une fois que la limite est atteinte, tous les nouveaux crédits gagnés sont rejetés. Pour les instances T2 Standard, les crédits de lancement ne sont pas comptés dans la limite. L’instance peut dépenser les crédits figurant dans le `CPUCreditBalance` pour dépasser le niveau de base de l’utilisation de l’UC. Les crédits figurant dans le `CPUCreditBalance` d’une instance en cours d’exécution n’expirent pas. Lorsqu’une instance T3 ou T3a s’arrête, la valeur `CPUCreditBalance` est conservée pendant sept jours. Au-delà, tous les crédits accumulés sont perdus. Lorsqu’une instance T2 s’arrête, la valeur de `CPUCreditBalance` n’est pas conservée, et tous les crédits accumulés sont perdus. Les métriques de crédits CPU sont disponibles toutes les 5 minutes uniquement.  |  Crédits (minutes vCPU)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| CPUSurplusCreditBalance  |  Nombre de crédits excédentaires ayant été dépensés par une instance `unlimited` lorsque la valeur `CPUCreditBalance` est nulle. La valeur de `CPUSurplusCreditBalance` est remboursée progressivement par les crédits UC gagnés. Si le nombre de crédits excédentaires dépasse le nombre maximum de crédits que l’instance peut gagner en 24 heures, les crédits excédentaires dépensés au-dessus du maximum génèrent des frais supplémentaires. Les métriques de crédits CPU sont disponibles toutes les 5 minutes uniquement.  |  Crédits (minutes vCPU)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| CPUSurplusCreditsCharged |  Nombre de crédits excédentaires dépensés qui ne sont pas remboursés progressivement par les crédits UC gagnés et qui génèrent donc des frais supplémentaires. Les crédits excédentaires dépensés sont facturés lorsque l’une des situations suivantes se produit :  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html) Les métriques de crédits CPU sont disponibles toutes les 5 minutes uniquement.  |  Crédits (minutes vCPU)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 

## Métriques d’hôte dédié
<a name="dh-metrics"></a>

L’espace de noms `AWS/EC2` inclut les métriques suivantes pour les hôtes dédiés T3.


| Métrique | Description | Unit | Statistiques significatives | 
| --- | --- | --- | --- | 
|  DedicatedHostCPUUtilization |  Pourcentage de capacité de calcul allouée actuellement utilisée par les instances exécutées sur l’hôte dédié.  |  Percent  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 

## Métriques Amazon EBS pour des instances basées sur Nitro
<a name="ebs-metrics-nitro"></a>

L’espace de noms `AWS/EC2` inclut des métriques Amazon EBS supplémentaires pour les volumes attachés aux instances basées sur Nitro qui ne sont pas des instances de type matériel nu.


| Métrique | Description | Unit | Statistiques significatives | 
| --- | --- | --- | --- | 
|  InstanceEBSIOPSExceededCheck  |  Indique si une application a tenté de générer des IOPS dépassant les limites maximales d’IOPS EBS pour l’instance au cours de la dernière minute. Cette métrique peut être `0` (IOPS non dépassées) ou `1` (IOPS dépassées).  |  Aucune  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
|  InstanceEBSThroughputExceededCheck  |  Indique si une application a tenté de générer un débit dépassant les limites maximales de débit EBS pour l’instance au cours de la dernière minute. Cette métrique peut être `0` (débit non dépassé) ou `1` (débit dépassé).  |  Aucune  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
|  EBSReadOps |  Opérations de lecture terminées de tous les volumes Amazon EBS attachés à l’instance au cours de la période spécifiée. Pour calculer la moyenne I/O des opérations de lecture par seconde (IOPS de lecture) pour la période, divisez le nombre total d'opérations de la période par le nombre de secondes de cette période. Si vous utilisez une surveillance de base (cinq minutes), vous pouvez diviser ce nombre par 300 pour calculer les IOPS en lecture. Si vous avez recours à une surveillance détaillée (une minute), divisez-le par 60. Vous pouvez également utiliser la fonction mathématique CloudWatch métrique `DIFF_TIME` pour déterminer les opérations par seconde. Par exemple, si vous avez représenté graphiquement `EBSReadOps` CloudWatch comme`m1`, la formule mathématique de la métrique `m1/(DIFF_TIME(m1))` renvoie la métrique en opérations/seconde. Pour plus d'informations sur les autres fonctions mathématiques métriques `DIFF_TIME` et sur d'autres, consultez la section [Utiliser les mathématiques métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) dans le *guide de CloudWatch l'utilisateur Amazon*.  |  Nombre  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
|  EBSWriteOps  |  Opérations d’écriture terminées de tous les volumes EBS attachés à l’instance au cours de la période spécifiée. Pour calculer la moyenne I/O des opérations d'écriture par seconde (IOPS d'écriture) pour la période, divisez le nombre total d'opérations de la période par le nombre de secondes pendant cette période. Si vous utilisez une surveillance de base (cinq minutes), vous pouvez diviser ce nombre par 300 pour calculer les IOPS en écriture. Si vous avez recours à une surveillance détaillée (une minute), divisez-le par 60. Vous pouvez également utiliser la fonction mathématique CloudWatch métrique `DIFF_TIME` pour déterminer les opérations par seconde. Par exemple, si vous avez représenté graphiquement `EBSWriteOps` CloudWatch comme`m1`, la formule mathématique de la métrique `m1/(DIFF_TIME(m1))` renvoie la métrique en opérations/seconde. Pour plus d'informations sur les autres fonctions mathématiques métriques `DIFF_TIME` et sur d'autres, consultez la section [Utiliser les mathématiques métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) dans le *guide de CloudWatch l'utilisateur Amazon*.  |  Nombre  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
|  EBSReadBytes  |  Octets lus de tous les volumes EBS attachés à l’instance au cours de la période spécifiée. Le nombre mentionné correspond au nombre d’octets lus pendant la période. Si vous utilisez une surveillance de base (cinq minutes), vous pouvez diviser ce nombre par 300 pour trouver le nombre d’octets/seconde en lecture. Si vous avez recours à une surveillance détaillée (une minute), divisez-le par 60. Vous pouvez également utiliser la fonction mathématique CloudWatch métrique `DIFF_TIME` pour déterminer les octets par seconde. Par exemple, si vous avez représenté graphiquement `EBSReadBytes` CloudWatch comme`m1`, la formule mathématique de la métrique `m1/(DIFF_TIME(m1))` renvoie la métrique en octets/seconde. Pour plus d'informations sur les autres fonctions mathématiques métriques `DIFF_TIME` et sur d'autres, consultez la section [Utiliser les mathématiques métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) dans le *guide de CloudWatch l'utilisateur Amazon*.  |  Octets  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
|  EBSWriteBytes  |  Octets écrits dans tous les volumes EBS attachés à l’instance au cours de la période spécifiée. Le nombre mentionné correspond au nombre d’octets écrits pendant la période. Si vous utilisez une surveillance de base (cinq minutes), vous pouvez diviser ce nombre par 300 pour trouver le nombre d’octets/seconde en écriture. Si vous avez recours à une surveillance détaillée (une minute), divisez-le par 60. Vous pouvez également utiliser la fonction mathématique CloudWatch métrique `DIFF_TIME` pour déterminer les octets par seconde. Par exemple, si vous avez représenté graphiquement `EBSWriteBytes` CloudWatch comme`m1`, la formule mathématique de la métrique `m1/(DIFF_TIME(m1))` renvoie la métrique en octets/seconde. Pour plus d'informations sur les autres fonctions mathématiques métriques `DIFF_TIME` et sur d'autres, consultez la section [Utiliser les mathématiques métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) dans le *guide de CloudWatch l'utilisateur Amazon*.  |  Octets  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
|  EBSIOBalance%  |  Fournit des informations sur le pourcentage de I/O crédits restant dans le bucket burst. Cette métrique est disponible uniquement pour la surveillance basique. Cette métrique n’est disponible que pour certaines tailles d’instance `*.4xlarge` et plus petites qui atteignent leur performance maximale pendant 30 minutes au moins une fois par 24 heures. La statistique `Sum` n'est pas applicable pour cette métrique.  |  Pourcentage  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
|  EBSByteBalance%  |  Fournit des informations sur le pourcentage de crédits de débit restant dans le compartiment en rafales. Cette métrique est disponible uniquement pour la surveillance basique. Cette métrique n’est disponible que pour certaines tailles d’instance `*.4xlarge` et plus petites qui atteignent leur performance maximale pendant 30 minutes au moins une fois par 24 heures. La statistique `Sum` n'est pas applicable pour cette métrique.  |  Pourcentage  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 

Pour plus d'informations sur les métriques fournies pour vos volumes EBS, consultez [Métriques pour les volumes Amazon EBS](https://docs.aws.amazon.com/ebs/latest/userguide/using_cloudwatch_ebs.html#ebs-volume-metrics) dans le *Guide de l'utilisateur Amazon EBS*. Pour plus d'informations sur les métriques fournies pour vos flottes EC2 et vos flottes Spot, consultez [Surveillez votre flotte EC2 ou votre flotte Spot à l'aide de CloudWatch](ec2-fleet-cloudwatch-metrics.md).

## Métriques de contrôle de statut
<a name="status-check-metrics"></a>

Par défaut, les métriques de contrôle de statut sont disponibles à la fréquence d’1 minute sans frais supplémentaires. Pour une instance nouvellement lancée, les données de métriques de contrôle de statut sont disponibles uniquement une fois que l’état d’initialisation de l’instance a pris fin (dans les quelques minutes qui suivent l’entrée de l’instance dans l’état `running`). Pour plus d’informations sur les vérifications de statut EC2, veuillez consulter [Contrôles du statut des instances Amazon EC2](monitoring-system-instance-status-check.md).

L’espace de nom `AWS/EC2` inclut les métriques de contrôle de statut suivantes.


| Métrique | Description | Unit | Statistiques significatives | 
| --- | --- | --- | --- | 
| StatusCheckFailed |  Indique si l'instance a passé avec succès toutes les vérifications de statut au cours de la dernière minute. Cette métrique peut avoir la valeur `0` (succès) ou `1` (échec). Par défaut, cette métrique est disponible à la fréquence d’1 minute sans frais supplémentaires.  |  Count  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| StatusCheckFailed\$1Instance |  Indique si l’instance a passé avec succès le contrôle de statut de l’instance de la dernière minute. Cette métrique peut avoir la valeur `0` (succès) ou `1` (échec). Par défaut, cette métrique est disponible à la fréquence d’1 minute sans frais supplémentaires.  |  Count  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| StatusCheckFailed\$1System |  Indique si l’instance a passé avec succès le contrôle de statut du système de la dernière minute. Cette métrique peut avoir la valeur `0` (succès) ou `1` (échec). Par défaut, cette métrique est disponible à la fréquence d’1 minute sans frais supplémentaires.  |  Count  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 
| StatusCheckFailed\$1AttachedEBS |  Indique si l’instance a passé avec succès le contrôle de statut de l’EBS attaché de la dernière minute. Cette métrique peut avoir la valeur `0` (succès) ou `1` (échec). Par défaut, cette métrique est disponible à la fréquence d’1 minute sans frais supplémentaires.  |  Count  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 

L’`AWS/EBS`espace de noms inclut la métrique de contrôle de statut suivantes.


| Métrique | Description | Unit | Statistiques significatives | 
| --- | --- | --- | --- | 
| VolumeStalledIOCheck |  **Remarque :** pour les instances Nitro uniquement. Non publié pour les volumes attachés à Amazon ECS et AWS Fargate les tâches. Indique si un volume a réussi ou échoué à une *vérification d’E/S bloquée* au cours de la dernière minute. Cette métrique peut avoir la valeur `0` (succès) ou `1` (échec).  |  Aucune  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/viewing_metrics_with_cloudwatch.html)  | 

## Métriques de mise en miroir du trafic
<a name="traffic-mirroring-metrics"></a>

L’espace de noms `AWS/EC2` inclut des métriques pour le trafic mis en miroir. Pour plus d'informations, consultez [Surveiller le trafic en miroir à l'aide d'Amazon CloudWatch dans le guide Amazon](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirror-cloudwatch.html) *VPC* Traffic Mirroring.

## Métriques du groupe Auto Scaling
<a name="autoscaling-metrics"></a>

L’espace de noms `AWS/AutoScaling` inclut des métriques pour les groupes Auto Scaling. Pour plus d'informations, consultez la section [Surveillance CloudWatch des métriques pour vos groupes et instances Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-cloudwatch-monitoring.html) dans le guide de l'*utilisateur d'Amazon EC2 Auto Scaling*.

## Dimensions de métriques Amazon EC2
<a name="ec2-cloudwatch-dimensions"></a>

Vous pouvez utiliser les dimensions suivantes pour affiner les métriques répertoriées dans les tableaux précédents.


| Dimension | Description | 
| --- | --- | 
|  AutoScalingGroupName  |  Cette dimension filtre les données que vous demandez pour toutes les instances dans un groupe de capacité donné. Un *groupe Auto Scaling* est un ensemble d’instances que vous définissez si vous utilisez Auto Scaling. Cette dimension est disponible uniquement pour les métriques Amazon EC2 lorsque les instances sont dans un groupe Auto Scaling. Disponible pour les instances avec la surveillance détaillée ou basique activée.  | 
|  ImageId  |  Cette dimension filtre les données que vous demandez pour toutes les instances exécutant cette Amazon Machine Image (AMI) Amazon EC2. Disponible pour les instances avec la surveillance détaillée activée.  | 
|  InstanceId  |  Cette dimension filtre les données que vous demandez de l’instance identifiée uniquement. Cela vous aide à identifier une instance exacte à partir de laquelle surveiller les données.  | 
|  InstanceType  |  Cette dimension filtre les données que vous demandez pour toutes les instances s’exécutant avec ce type d’instance spécifiée. Cela vous permet de classer vos données selon le type d’instance en cours d’exécution. Par exemple, vous pouvez comparer les données issues d’une instance m1.small et d’une instance m1.large pour déterminer qui a la meilleure valeur commerciale pour votre application. Disponible pour les instances avec la surveillance détaillée activée.  | 

## Métriques d’utilisation Amazon EC2
<a name="service-quota-metrics"></a>

Vous pouvez utiliser les statistiques CloudWatch d'utilisation pour obtenir une visibilité sur l'utilisation des ressources par votre compte. Utilisez ces indicateurs pour visualiser l'utilisation actuelle de vos services sur CloudWatch des graphiques et des tableaux de bord.

Les métriques d'utilisation d'Amazon EC2 correspondent aux quotas de AWS service. Vous pouvez configurer des alarmes qui vous alertent lorsque votre utilisation approche d’un quota de service. Pour plus d'informations sur CloudWatch l'intégration avec les quotas de service, consultez [les statistiques AWS d'utilisation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Service-Quota-Integration.html) dans le *guide de CloudWatch l'utilisateur Amazon*.

Amazon EC2 publie les métriques suivantes dans l’espace de noms `AWS/Usage`.


| Métrique | Description | 
| --- | --- | 
| `ResourceCount` |  Nombre des ressources spécifiées exécutées dans votre compte. Les ressources sont définies par les dimensions associées à la métrique. La statistique la plus utile pour cette métrique est `MAXIMUM`, qui représente le nombre maximal de ressources utilisées pendant la période d’une minute.  | 

Les dimensions suivantes permettent d’affiner les métriques d’utilisation publiées par Amazon EC2.


| Dimension | Description | 
| --- | --- | 
|  Service  |  Nom du AWS service contenant la ressource. Pour les métriques d’utilisation d’Amazon EC2, la valeur de cette dimension est `EC2`.  | 
|  Type  |  Type d’entité faisant l’objet d’un rapport. Actuellement, la seule valeur valide pour les métriques d’utilisation d’Amazon EC2 est `Resource`.  | 
|  Resource  |  Type de ressource en cours d’exécution. Actuellement, la seule valeur valide pour les métriques d’utilisation d’Amazon EC2 est `vCPU`, qui renvoie des informations sur les instances en cours d’exécution.  | 
|  Class  |  Classe de ressource suivie. Pour les métriques d’utilisation d’Amazon EC2 avec `vCPU` comme valeur de la dimension `Resource`, les valeurs valides sont `Standard/OnDemand`, `F/OnDemand`, `G/OnDemand`, `Inf/OnDemand`, `P/OnDemand` et `X/OnDemand`. Les valeurs de cette dimension définissent la première lettre des types d’instance signalés par la métrique. Par exemple, `Standard/OnDemand` renvoie des informations sur toutes les instances en cours d’exécution dont les types commencent par A, C, D, H, I, M, R, T et Z, et `G/OnDemand` renvoie des informations sur toutes les instances en cours d’exécution dont les types commencent par G.  | 

# Installez et configurez l' CloudWatch agent à l'aide de la console Amazon EC2 pour ajouter des métriques supplémentaires
<a name="install-and-configure-cloudwatch-agent-using-ec2-console"></a>


|  | 
| --- |
| L'installation et la configuration de l' CloudWatch agent à l'aide de la console Amazon EC2 sont en version bêta pour Amazon EC2 et sont susceptibles d'être modifiées. | 

Par défaut, Amazon CloudWatch fournit des métriques de base, telles que `CPUUtilization` et`NetworkIn`, pour surveiller vos instances Amazon EC2. Pour collecter des métriques supplémentaires, vous pouvez installer l' CloudWatch agent sur vos instances EC2, puis configurer l'agent pour qu'il émette les métriques sélectionnées. Au lieu d'installer et de configurer manuellement l' CloudWatch agent sur chaque instance EC2, vous pouvez utiliser la console Amazon EC2 pour le faire à votre place.

Vous pouvez utiliser la console Amazon EC2 pour installer l' CloudWatch agent sur vos instances et le configurer pour qu'il émette des métriques sélectionnées.

Sinon, pour effectuer ce processus manuellement, consultez la section [Installation de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html) dans le *guide de CloudWatch l'utilisateur Amazon*. Pour plus d'informations sur l' CloudWatch agent, consultez la section [Collecter des métriques, des journaux et des traces à l'aide de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html).

**Topics**
+ [

## Conditions préalables
](#install-and-configure-cw-agent-prerequisites)
+ [

## Comment ça marche
](#install-and-configure-cw-agent-how-it-works)
+ [

## Coûts
](#install-and-configure-cw-agent-costs)
+ [

## Installation et configuration de l' CloudWatch agent
](#install-and-configure-cw-agent-procedure)

## Conditions préalables
<a name="install-and-configure-cw-agent-prerequisites"></a>

Pour utiliser Amazon EC2 afin d'installer et de configurer l' CloudWatch agent, vous devez satisfaire aux exigences relatives à l'utilisateur et à l'instance décrites dans cette section.

**Astuce**  
Cette fonctionnalité n'est pas disponible du tout Régions AWS. Si l’élément de menu décrit dans la procédure d’installation de cette page n’existe pas dans la console Amazon EC2 et que vous êtes flexible quant à l’emplacement d’exécution de vos instances, essayez une autre région. Sinon, vous pouvez utiliser les instructions du manuel du *guide de CloudWatch l'utilisateur Amazon* pour installer et configurer l'agent.

**Prérequis pour l'utilisateur**  
Pour utiliser cette fonctionnalité, l'utilisateur ou le rôle de votre console IAM doit disposer des autorisations requises pour utiliser Amazon EC2 et des autorisations IAM suivantes :

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:GetParameter",
                "ssm:PutParameter"
            ],
            "Resource": "arn:aws:ssm:*:*:parameter/EC2-Custom-Metrics-*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "ssm:SendCommand",
                "ssm:ListCommandInvocations",
                "ssm:DescribeInstanceInformation"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:GetInstanceProfile",
                "iam:SimulatePrincipalPolicy"
            ],
            "Resource": "*"
        }
    ]
}
```

------

**Prérequis pour l'instance**
+ État de l’instance : `running`
+ Système d'exploitation pris en charge : Linux
+ AWS Systems Manager Agent (agent SSM) : installé. Deux remarques à propos de l'agent SSM :
  + L'agent SSM est préinstallé sur certaines Amazon Machine Images (AMIs) fournies par des tiers AWS de confiance. *Pour plus d'informations sur le support AMIs et les instructions d'installation de l'agent SSM, consultez [Amazon Machine Images (AMIs) avec l'agent SSM préinstallé](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html) dans le guide de l'AWS Systems Manager utilisateur.*
  + Si vous rencontrez des problèmes avec l'agent SSM, consultez [Résolution des problèmes liés à l'agent SSM](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-ssm-agent.html) dans le *AWS Systems Manager Guide de l'utilisateur*.
+ Autorisations IAM pour l'instance : les politiques AWS gérées suivantes doivent être ajoutées à un rôle IAM attaché à l'instance :
  + [Amazon SSMManaged InstanceCore](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonSSMManagedInstanceCore.html) — Permet à une instance d'utiliser Systems Manager pour installer et configurer l' CloudWatch agent.
  + [CloudWatchAgentServerPolicy](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchAgentServerPolicy.html)— Permet à une instance d'utiliser l' CloudWatchagent pour y écrire des données CloudWatch.

  Pour plus d’informations sur la façon d’ajouter des autorisations IAM à votre instance, consultez la section [Utilisation des profils d’instance](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html) dans le *Guide de l’utilisateur IAM*.

## Comment ça marche
<a name="install-and-configure-cw-agent-how-it-works"></a>

Avant de pouvoir utiliser la console Amazon EC2 pour installer et configurer l' CloudWatch agent, vous devez vous assurer que votre utilisateur ou rôle IAM, ainsi que les instances sur lesquelles vous souhaitez ajouter des métriques, répondent à certaines conditions préalables. Vous pouvez ensuite utiliser la console Amazon EC2 pour installer et configurer l' CloudWatch agent sur les instances que vous avez sélectionnées.

**Remplissez d'abord les [prérequis](#install-and-configure-cw-agent-prerequisites)**
+ **Vous avez besoin des autorisations IAM requises** : avant de commencer, assurez-vous que l'utilisateur ou le rôle de votre console dispose des autorisations IAM requises pour utiliser cette fonctionnalité.
+ **Instances** : pour utiliser cette fonctionnalité, vos instances EC2 doivent être des instances Linux, disposer de l'agent SSM installé, des autorisations IAM requises et être en cours d'exécution. 

**Ensuite, vous pouvez [utiliser la fonctionnalité](#install-and-configure-cw-agent-procedure)**

1. **Sélectionnez vos instances** : dans la console Amazon EC2, vous sélectionnez les instances sur lesquelles vous souhaitez installer et configurer l' CloudWatch agent. Vous lancez ensuite le processus en choisissant **Configurer CloudWatch l'agent**.

1. **Validez l'agent SSM** : Amazon EC2 vérifie que l'agent SSM est installé et démarré sur chaque instance. Toutes les instances qui ne répondent pas à ce critère sont exclues du processus. L'agent SSM est utilisé pour effectuer des actions sur l'instance au cours de ce processus.

1. **Validez les autorisations IAM** : Amazon EC2 vérifie que chaque instance dispose des autorisations IAM requises pour ce processus. Toutes les instances qui ne répondent pas à ce critère sont exclues du processus. Les autorisations IAM permettent à l' CloudWatch agent de collecter des métriques à partir de l'instance et de les intégrer AWS Systems Manager pour utiliser l'agent SSM.

1. **Valider CloudWatch l'agent** : Amazon EC2 vérifie que l' CloudWatch agent est installé et s'exécute sur chaque instance. Si une instance échoue à cette vérification, Amazon EC2 propose d'installer et de démarrer l' CloudWatch agent pour vous. L' CloudWatch agent collectera les métriques sélectionnées sur chaque instance une fois ce processus terminé.

1. **Sélectionnez la configuration des métriques** : vous sélectionnez les métriques que l' CloudWatch agent doit émettre à partir de vos instances. Une fois sélectionné, Amazon EC2 stocke un fichier de configuration dans Parameter Store, où il est conservé jusqu'à la fin du processus. Amazon EC2 supprimera le fichier de configuration de Parameter Store à moins que le processus ne soit interrompu. Notez que si vous ne sélectionnez pas de métrique, mais que vous l'avez déjà ajoutée à votre instance, elle sera supprimée de votre instance une fois ce processus terminé.

1. **Mettre à jour la configuration de l' CloudWatch agent** : Amazon EC2 envoie la configuration métrique à l' CloudWatch agent. Il s'agit de la dernière étape du processus. En cas de succès, vos instances peuvent émettre des données pour les mesures sélectionnées et Amazon EC2 supprime le fichier de configuration du stock de paramètres.

## Coûts
<a name="install-and-configure-cw-agent-costs"></a>

Les métriques supplémentaires que vous ajoutez au cours de ce processus sont facturées en tant que métriques personnalisées. Pour plus d'informations sur la tarification des CloudWatch métriques, consultez [Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/).

## Installation et configuration de l' CloudWatch agent
<a name="install-and-configure-cw-agent-procedure"></a>

Vous pouvez utiliser la console Amazon EC2 pour installer et configurer l' CloudWatch agent afin d'ajouter des métriques supplémentaires.

**Note**  
Chaque fois que vous effectuez cette procédure, vous remplacez la configuration de l' CloudWatch agent existante. Si vous ne sélectionnez pas une métrique déjà sélectionnée, elle sera supprimée de l'instance.

**Pour installer et configurer l' CloudWatch agent à l'aide de la console Amazon EC2**

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 les instances sur lesquelles vous souhaitez installer et configurer l' CloudWatch agent.

1. Choisissez **Actions**, **Surveillance et résolution des problèmes, Configuration** **de CloudWatch l'agent**.

1. Pour chaque étape du processus, lisez le texte de la console, puis choisissez **Suivant**.

1. Pour terminer le processus, dans la dernière étape, sélectionnez **Terminer**.

**Pour mettre à jour la configuration de l’agent créée par la console Amazon EC2**  
Vous pouvez personnaliser manuellement la configuration créée par la console EC2. Pour plus d'informations, consultez la section [Création ou modification manuelle du fichier de configuration de l' CloudWatch agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html) dans le *guide de CloudWatch l'utilisateur Amazon*.

# Statistiques pour les CloudWatch métriques relatives à vos instances
<a name="monitoring_get_statistics"></a>

Vous pouvez obtenir des statistiques relatives aux CloudWatch métriques de vos instances. Les *statistiques* sont des agrégations de données métriques sur des périodes spécifiques. CloudWatch fournit des statistiques basées sur les points de données métriques fournis par vos données personnalisées ou fournis par d'autres services AWS connexes CloudWatch. Les regroupements sont effectués en utilisant l’espace de noms, le nom métrique, les dimensions et l’unité de mesure des points de données, pendant la période spécifiée. Le tableau suivant décrit les statistiques disponibles.


| Statistique | Description | 
| --- | --- | 
| Minimum |  La valeur la plus basse observée pendant la période spécifiée. Vous pouvez utiliser cette valeur pour déterminer les faibles volumes d’activité pour votre application.   | 
| Maximum |  La valeur la plus haute observée pendant la période spécifiée. Vous pouvez utiliser cette valeur pour déterminer les volumes d’activité élevés pour votre application.   | 
| Sum |  Toutes les valeurs soumises pour la métrique correspondante ajoutées ensemble. Cette statistique peut être utile pour déterminer le volume total d’une métrique.   | 
| Average |  La valeur de `Sum` / `SampleCount` pendant la période spécifiée. En comparant cette statistique à `Minimum` et à `Maximum`, vous pouvez déterminer l’ampleur d’une métrique et si l’utilisation moyenne est proche de `Minimum` ou de `Maximum`. Cette comparaison vous permet de savoir quand augmenter ou diminuer vos ressources en fonction des besoins.   | 
| SampleCount |  Le compte (nombre) des points de données utilisé pour le calcul statistique.  | 
| pNN.NN |  Valeur du centile spécifié. Vous pouvez spécifier un centile en utilisant jusqu’à deux décimales (par exemple, p95.45).  | 

**Topics**
+ [

# Obtenir les statistiques d’une instance spécifique
](US_SingleMetricPerInstance.md)
+ [

# Regrouper les statistiques à travers les instances
](GetSingleMetricAllDimensions.md)
+ [

# Regroupement de statistiques par groupe Auto Scaling
](GetMetricAutoScalingGroup.md)
+ [

# Regroupement de statistiques par AMI
](US_SingleMetricPerAMI.md)

# Obtenir les statistiques d’une instance spécifique
<a name="US_SingleMetricPerInstance"></a>

Vous pouvez utiliser le AWS Management Console ou le AWS CLI pour obtenir des statistiques pour une instance spécifique. Les exemples suivants vous montrent comment utiliser le AWS Management Console ou le AWS CLI pour déterminer l'utilisation maximale du processeur d'une instance EC2 spécifique.

**Exigences**
+ Vous devez avoir l’ID de l’instance. Vous pouvez obtenir l’ID d’instance en utilisant AWS Management Console ou la commande [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html).
+ Par défaut, la surveillance basique est activée, mais vous pouvez activer la surveillance détaillée. Pour de plus amples informations, veuillez consulter [Gérez la surveillance détaillée de vos instances EC2](manage-detailed-monitoring.md).

**Pour afficher l’utilisation d’UC d’une instance spécifique (console)**

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, sélectionnez ‎**Metrics** (Métriques).

1. Choisissez l’espace de nom de métrique **EC2**.

1. Choisissez la dimension **Per-Instance Metrics (Métriques par instance)**.

1. Dans le champ de recherche, entrez **CPUUtilization**, puis appuyez sur Entrée. Choisissez la ligne pour l'instance spécifique, qui affiche un graphique pour la **CPUUtilization**métrique de l'instance. Pour nommer le graphique, choisissez l’icône en forme de crayon. Pour modifier la plage de temps, sélectionnez l’une des valeurs prédéfinies ou choisissez **custom**.  
![\[Représenter graphiquement une seule métrique\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/metric_statistics_ec2_instance.png)

1. Pour modifier la statistique ou la période pour la métrique, choisissez l’onglet **Graphed metrics**. Sélectionnez l’en-tête de colonne ou une valeur individuelle et choisissez une autre valeur.  
![\[Modification de la statistique ou de la période pour une métrique\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/metric_statistics_ec2_instance_statistic_period.png)

**Pour obtenir l’utilisation d’UC pour une instance spécifique (AWS CLI)**  
Utilisez la [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)commande suivante pour obtenir la **CPUUtilization**métrique pour l'instance spécifiée, en utilisant la période et l'intervalle de temps spécifiés :

```
aws cloudwatch get-metric-statistics --namespace AWS/EC2 --metric-name CPUUtilization  --period 3600 \
--statistics Maximum --dimensions Name=InstanceId,Value=i-1234567890abcdef0 \
--start-time 2022-10-18T23:18:00 --end-time 2022-10-19T23:18:00
```

Voici un exemple de sortie. Chaque valeur représente le pourcentage d’utilisation maximale de l’UC pour une seule instance EC2.

```
{
    "Datapoints": [
        {
            "Timestamp": "2022-10-19T00:18:00Z", 
            "Maximum": 0.33000000000000002, 
            "Unit": "Percent"
        }, 
        {
            "Timestamp": "2022-10-19T03:18:00Z", 
            "Maximum": 99.670000000000002, 
            "Unit": "Percent"
        }, 
        {
            "Timestamp": "2022-10-19T07:18:00Z", 
            "Maximum": 0.34000000000000002, 
            "Unit": "Percent"
        }, 
        {
            "Timestamp": "2022-10-19T12:18:00Z", 
            "Maximum": 0.34000000000000002, 
            "Unit": "Percent"
        }
    ], 
    "Label": "CPUUtilization"
}
```

# Regrouper les statistiques à travers les instances
<a name="GetSingleMetricAllDimensions"></a>

Les statistiques agrégées sont disponibles pour des instances pour lesquelles la surveillance détaillée a été activée. Les instances qui utilisent la surveillance basique ne sont pas incluses dans les regroupements. Avant de pouvoir obtenir des statistiques regroupées entre les instances, vous devez [activer la surveillance détaillée](manage-detailed-monitoring.md#enable-detailed-monitoring) (avec coût additionnel) qui fournit des données toutes les minutes.

Notez qu'Amazon CloudWatch ne peut pas agréger les données entre AWS les régions. Les métriques sont totalement séparées d’une région à une autre.

Cet exemple vous montre comment obtenir l’utilisation moyenne de l’UC pour vos instances EC2 à l’aide de la surveillance détaillée. Aucune dimension n'étant spécifiée, CloudWatch renvoie des statistiques pour toutes les dimensions de l'espace de `AWS/EC2` noms.

**Important**  
Cette technique de récupération de toutes les dimensions d'un espace de AWS noms ne fonctionne pas pour les espaces de noms personnalisés que vous publiez sur Amazon. CloudWatch Avec les espaces de noms personnalisés, vous devez spécifier l’ensemble complet des dimensions associées à un point de données particulier pour pouvoir extraire les statistiques qui incluent le point de données. 

**Pour afficher l’utilisation moyenne de l’UC dans vos instances (console)**

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, sélectionnez ‎**Metrics** (Métriques).

1. Choisissez l’espace de noms **EC2**, puis choisissez **Across All Instances (Sur toutes les instances)**.

1. Choisissez la ligne qui contient **CPUUtilization**, qui affiche un graphique pour la métrique pour toutes vos instances EC2. Pour nommer le graphique, choisissez l’icône en forme de crayon. Pour modifier la plage de temps, sélectionnez l’une des valeurs prédéfinies ou choisissez **custom**.  
![\[Métriques regroupées à travers vos instances EC2\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/metric_aggregated_instances.png)

1. Pour modifier la statistique ou la période pour la métrique, choisissez l’onglet **Graphed metrics**. Sélectionnez l’en-tête de colonne ou une valeur individuelle et choisissez une autre valeur.

**Pour obtenir l’utilisation moyenne de l’UC sur vos instances (AWS CLI)**  
Utilisez la [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)commande suivante pour obtenir la moyenne de la **CPUUtilization**métrique sur vos instances.

```
aws cloudwatch get-metric-statistics \
    --namespace AWS/EC2 \
    --metric-name CPUUtilization \ 
    --period 3600  --statistics "Average" "SampleCount" \ 
    --start-time 2022-10-11T23:18:00 \
    --end-time 2022-10-12T23:18:00
```

Voici un exemple de sortie :

```
{
    "Datapoints": [
        {
            "SampleCount": 238.0, 
            "Timestamp": "2022-10-12T07:18:00Z", 
            "Average": 0.038235294117647062, 
            "Unit": "Percent"
        }, 
        {
            "SampleCount": 240.0, 
            "Timestamp": "2022-10-12T09:18:00Z", 
            "Average": 0.16670833333333332, 
            "Unit": "Percent"
        }, 
        {
            "SampleCount": 238.0, 
            "Timestamp": "2022-10-11T23:18:00Z", 
            "Average": 0.041596638655462197, 
            "Unit": "Percent"
        }
    ], 
    "Label": "CPUUtilization"
}
```

# Regroupement de statistiques par groupe Auto Scaling
<a name="GetMetricAutoScalingGroup"></a>

Vous pouvez regrouper des statistiques pour les instances EC2 dans un groupe Auto Scaling. Notez qu'Amazon CloudWatch ne peut pas agréger les données entre AWS les régions. Les métriques sont totalement séparées d’une région à une autre.

Cet exemple vous montre comment récupérer le nombre total d’octets écrits sur disque pour un groupe Auto Scaling. Le total est calculé par durée d’une minute sur une période de 24 heures pour toutes les instances EC2 dans le groupe Auto Scaling spécifié.

**DiskWriteBytes Pour afficher les instances d'un groupe Auto Scaling (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 ‎**Metrics (Métriques)**.

1. Choisissez l’espace de noms **EC2**, puis choisissez **By Auto Scaling Group (Par groupe Auto Scaling)**.

1. Choisissez la ligne pour la **DiskWriteBytes**métrique et le groupe Auto Scaling spécifique, qui affiche un graphique pour la métrique pour les instances du groupe Auto Scaling. Pour nommer le graphique, choisissez l’icône en forme de crayon. Pour modifier la plage de temps, sélectionnez l’une des valeurs prédéfinies ou choisissez **custom**.

1. Pour modifier la statistique ou la période pour la métrique, choisissez l’onglet **Graphed metrics**. Sélectionnez l’en-tête de colonne ou une valeur individuelle et choisissez une autre valeur.

**DiskWriteBytes Pour afficher les instances d'un groupe Auto Scaling (AWS CLI)**  
Utilisez la commande [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) comme suit.

```
aws cloudwatch get-metric-statistics --namespace AWS/EC2 --metric-name DiskWriteBytes --period 360 \
--statistics "Sum" "SampleCount" --dimensions Name=AutoScalingGroupName,Value=my-asg --start-time 2022-10-16T23:18:00 --end-time 2022-10-18T23:18:00
```

Voici un exemple de sortie :

```
{
    "Datapoints": [
        {
            "SampleCount": 18.0, 
            "Timestamp": "2022-10-19T21:36:00Z", 
            "Sum": 0.0, 
            "Unit": "Bytes"
        }, 
        {
            "SampleCount": 5.0, 
            "Timestamp": "2022-10-19T21:42:00Z", 
            "Sum": 0.0, 
            "Unit": "Bytes"
        }
    ], 
    "Label": "DiskWriteBytes"
}
```

# Regroupement de statistiques par AMI
<a name="US_SingleMetricPerAMI"></a>

Vous pouvez regrouper des statistiques par AMI pour les instances dont la surveillance détaillée est activée. Les instances qui utilisent la surveillance basique ne sont pas incluses dans les regroupements. Avant de pouvoir obtenir des statistiques regroupées entre les instances, vous devez [activer la surveillance détaillée](manage-detailed-monitoring.md#enable-detailed-monitoring) (avec coût additionnel) qui fournit des données toutes les minutes.

Notez qu'Amazon CloudWatch ne peut pas agréger les données entre AWS les régions. Les métriques sont totalement séparées d’une région à une autre.

Cet exemple vous montre comment déterminer l’utilisation moyenne de l’UC pour toutes les instances qui utilisent une Amazon Machine Image (AMI) spécifique. La moyenne est calculée par intervalles de 60 secondes pour une période d’un jour.

**Pour afficher l’utilisation moyenne de l’UC par AMI (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 ‎**Metrics (Métriques)**.

1. Choisissez l’espace de noms **EC2**, puis choisissez **By Image (AMI) Id (Par ID d’image (AMI))**.

1. Choisissez la ligne pour la **CPUUtilization**métrique et l'AMI spécifique, qui affiche un graphique pour la métrique pour l'AMI spécifiée. Pour nommer le graphique, choisissez l’icône en forme de crayon. Pour modifier la plage de temps, sélectionnez l’une des valeurs prédéfinies ou choisissez **custom**.

1. Pour modifier la statistique ou la période pour la métrique, choisissez l’onglet **Graphed metrics**. Sélectionnez l’en-tête de colonne ou une valeur individuelle et choisissez une autre valeur.

**Pour obtenir l’utilisation moyenne de l’UC pour un ID d’image (AWS CLI)**  
Utilisez la commande [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html) comme suit.

```
aws cloudwatch get-metric-statistics --namespace AWS/EC2 --metric-name CPUUtilization  --period 3600 \
--statistics Average --dimensions Name=ImageId,Value=ami-3c47a355 --start-time 2022-10-10T00:00:00 --end-time 2022-10-11T00:00:00
```

Voici un exemple de sortie. Chaque valeur représente le pourcentage d’utilisation moyenne de l’UC pour les instances EC2 exécutant l’AMI spécifiée.

```
{
    "Datapoints": [
        {
            "Timestamp": "2022-10-10T07:00:00Z", 
            "Average": 0.041000000000000009, 
            "Unit": "Percent"
        }, 
        {
            "Timestamp": "2022-10-10T14:00:00Z", 
            "Average": 0.079579831932773085, 
            "Unit": "Percent"
        }, 
        {
            "Timestamp": "2022-10-10T06:00:00Z", 
            "Average": 0.036000000000000011, 
            "Unit": "Percent"
        }
    ], 
    "Label": "CPUUtilization"
}
```

# Affichez les graphiques de surveillance de vos instances
<a name="graphs-in-the-aws-management-console"></a>

Après avoir lancé une instance, vous pouvez ouvrir la console Amazon EC2 et afficher les graphiques de surveillance d’une instance dans l’onglet **Surveillance**. Chaque graphique s’appuie sur l’une des métriques Amazon EC2 disponibles.

Les graphiques suivants sont disponibles :
+ Utilisation moyenne de l’UC (pourcentage)
+ Lectures moyennes sur disque (octets)
+ Ecritures moyennes sur disque (octets)
+ Nombre maximal entrées réseau (octets)
+ Nombre maximal sorties réseau (octets)
+ Récapitulatif des opérations de lecture sur disque (nombre)
+ Récapitulatif des opérations d’écriture sur disque (nombre)
+ Récapitulatif des statuts (quels qu’il soient)
+ Récapitulatif des statuts d’instance (nombre)
+ Récapitulatif des statuts système (nombre)

Pour plus d’informations sur les métriques et les données qu’elles leur fournissent, consultez [CloudWatch métriques disponibles pour vos instances](viewing_metrics_with_cloudwatch.md).

**Représentez graphiquement les métriques à l'aide CloudWatch de**  
Vous pouvez également utiliser la CloudWatch console pour représenter graphiquement les données métriques générées par Amazon EC2 et d'autres AWS services. Pour plus d'informations, consultez la section [Représentation graphique des métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) dans le *guide de CloudWatch l'utilisateur Amazon*.

# Création d'une CloudWatch alarme pour une instance
<a name="using-cloudwatch-createalarm"></a>

Vous pouvez créer une CloudWatch alarme qui surveille les CloudWatch métriques de l'une de vos instances. CloudWatchvous enverra automatiquement une notification lorsque la métrique atteindra le seuil que vous spécifiez. Vous pouvez créer une CloudWatch alarme à l'aide de la console Amazon EC2 ou à l'aide des options plus avancées proposées par la CloudWatch console.

**Pour créer une alarme à l'aide de la CloudWatch console**  
Pour des exemples, consultez la section [Création d' CloudWatchalarmes Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) dans le *guide de CloudWatch l'utilisateur Amazon*.

**Pour créer une alarme à l’aide de la console Amazon EC2**

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**, **Surveiller et dépanner**, **Gérer les CloudWatch alarmes**.

1. Sur la page détaillée de **gestion des CloudWatch alarmes**, sous **Ajouter ou modifier une alarme**, sélectionnez **Créer une alarme**.

1. Pour **Notification d’alarme**, choisissez si vous souhaitez configurer les notifications Amazon Simple Notiﬁcation Service (Amazon SNS). Entrez une rubrique Amazon SNS existante ou entrez un nom pour créer une nouvelle rubrique.

1. Pour **Action d’alarme**, choisissez si vous souhaitez spécifier une action à effectuer lorsque l’alarme est déclenchée. Choisissez une action dans la liste.

1. Pour **Seuils d’alarme**, sélectionnez la métrique et les critères de l’alarme. Par exemple, pour créer une alarme qui se déclenche lorsque l’utilisation du processeur atteint 80 % pendant une période de 5 minutes, procédez comme suit :

   1. Laissez le paramètre par défaut pour **Regrouper les exemples par** (**Moyenne**) et **Type de données à échantillonner** (**Utilisation du processeur**).

   1. Choisissez **>=** pour **Alarme quand** et saisissez **0.80** pour **Pourcentage**.

   1. Saisissez **1** pour **Période consécutive** et sélectionnez **5 minutes** pour **Période**.

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

1. Choisissez **Créer**.

Vous pouvez modifier les paramètres de votre CloudWatch alarme depuis la console Amazon EC2 ou depuis la CloudWatch console. Si vous souhaitez supprimer votre alarme, vous pouvez le faire depuis la CloudWatch console. Pour plus d'informations, consultez [Modifier ou supprimer une CloudWatch alarme](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Manage-CloudWatch-Alarm.html#Edit-CloudWatch-Alarm) dans le *guide de CloudWatch l'utilisateur Amazon*.

# Créer des alarmes qui arrêtent, finissent, redémarrent ou récupèrent une instance
<a name="UsingAlarmActions"></a>

À l'aide des actions CloudWatch d'alarme Amazon, vous pouvez créer des alarmes qui arrêtent, mettent fin, redémarrent ou restaurent automatiquement vos instances. Vous pouvez utiliser les actions d’arrêt ou de terminaison pour vous permettre d’économiser de l’argent quand vous n’avez plus besoin qu’une instance s’exécute. De même, les actions de redémarrage et de récupération vous permettent de redémarrer automatiquement ces instances ou de les récupérer sur un nouveau matériel en cas de déficience du nouveau matériel.

**Note**  
Pour les informations de facturation et de tarification d'Amazon CloudWatch Alarmes, consultez la section [ CloudWatch facturation et coûts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_billing.html) dans le *guide de CloudWatch l'utilisateur Amazon*.

Le rôle `AWSServiceRoleForCloudWatchEvents` lié au service permet d' AWS effectuer des actions d'alarme en votre nom. La première fois que vous créez une alarme dans l'API AWS Management Console AWS CLI, le ou l'API IAM, le rôle lié au service est CloudWatch créé pour vous.

Il existe un certain nombre de scénarios dans lesquels vous pourriez vouloir arrêter ou terminer automatiquement votre instance. Par exemple, vous pourriez avoir des instances dédiées aux tâches de traitement différé de la paie ou de calcul scientifique qui s’exécutent pendant une durée, puis achèvent leur travail. Plutôt que de laisser ces instances demeurer inactives (et d’accumuler les frais), vous pouvez les arrêter ou les terminer, ce qui peut vous aider à économiser de l’argent. La principale différence entre l’utilisation des actions d’alarme « stop » et « terminate » est que vous pouvez facilement démarrer une instance arrêtée si vous devez l’exécuter à nouveau ultérieurement, et que vous pouvez conserver les mêmes ID d’instance et volume racine. Cependant, vous ne pouvez pas démarrer une instance résiliée. Vous devez à la place lancer une nouvelle instance. Lorsqu’une instance est arrêtée ou résiliée, les données sur les volumes de stockage d’instances sont perdues.

Vous pouvez ajouter les actions d'arrêt, de résiliation, de redémarrage ou de restauration à toute alarme définie sur une métrique Amazon EC2 par instance, y compris les mesures de surveillance de base et détaillées fournies par Amazon CloudWatch (dans l'`AWS/EC2`espace de noms), ainsi que toutes les mesures personnalisées incluant la `InstanceId` dimension, à condition que sa valeur fasse référence à une instance Amazon EC2 en cours d'exécution valide.

**Important**  
Les alarmes de contrôle d'état peuvent entrer temporairement dans l'`INSUFFICIENT_DATA` état si des points de données métriques manquent. 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 la `INSUFFICIENT_DATA` situation comme des données manquantes plutôt que comme une violation d'alarme, en particulier lorsque vous configurez l'alarme pour arrêter, terminer, redémarrer ou récupérer une instance.

**Prise en charge de la console**  
Vous pouvez créer des alarmes à l'aide de la console Amazon EC2 ou de la CloudWatch console. Les procédures décrites dans cette documentation utilisent la console Amazon EC2. Pour les procédures utilisant la CloudWatch console, consultez la section [Créer des alarmes qui arrêtent, mettent fin, redémarrent ou restaurent une instance](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/UsingAlarmActions.html) dans le *guide de CloudWatch l'utilisateur Amazon*.

**Permissions**  
Vous devez disposer de l’autorisation `iam:CreateServiceLinkedRole` pour créer ou modifier une alarme exécutant des actions d’alarme EC2. Une fonction de service est un [rôle IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) qu’un service endosse pour accomplir des actions en votre nom. Un administrateur IAM peut créer, modifier et supprimer un rôle de service à partir d’IAM. Pour plus d’informations, consultez [Création d’un rôle pour la délégation d’autorisations à un Service AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) dans le *Guide de l’utilisateur IAM*. 

**Topics**
+ [

## Ajouter des actions d'arrêt aux CloudWatch alarmes Amazon
](#AddingStopActions)
+ [

## Ajouter des actions de résiliation aux CloudWatch alarmes Amazon
](#AddingTerminateActions)
+ [

## Ajouter des actions de redémarrage aux CloudWatch alarmes Amazon
](#AddingRebootActions)
+ [

## Ajouter des actions de restauration aux CloudWatch alarmes Amazon
](#AddingRecoverActions)
+ [

# Scénarios CloudWatch d'action d'alarme Amazon
](AlarmActionScenarios.md)

## Ajouter des actions d'arrêt aux CloudWatch alarmes Amazon
<a name="AddingStopActions"></a>

Vous pouvez créer une alarme qui arrête une instance Amazon EC2 quand un certain seuil a été atteint. Par exemple, vous pouvez exécuter des instances de développement ou de test, et, à l’occasion, oublier de les fermer. Vous pouvez créer une alarme qui est déclenchée quand le pourcentage moyen d’utilisation de l’UC a été inférieur à 10 % pendant 24 heures, indiquant que l’instance est inactive et n’est plus en cours d’utilisation. Vous pouvez ajuster le seuil, la durée et la période en fonction de vos besoins ; de plus, vous pouvez ajouter une notification Amazon Simple Notiﬁcation Service (Amazon SNS) de façon à recevoir un courrier électronique quand l’alarme est déclenchée.

Les instances qui utilisent un volume Amazon EBS comme volume racine peuvent être arrêtées ou résiliées, tandis que celles qui recourent au stockage d’instance comme volume racine peuvent uniquement être résiliées. Les données stockées sur des volumes de stockage d’instance sont perdues lorsque l’instance est résiliée ou arrêtée.

**Pour créer une alarme afin d’arrêter une instance inactive (console Amazon EC2)**

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**, **Surveiller et dépanner**, **Gérer les CloudWatch alarmes**.

   Vous pouvez également sélectionner le signe plus ( ![\[Plus sign.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/add-plus.png) ) dans la colonne **Alarm status** (Statut de l’alarme) .

1. Sur la page **Gérer les CloudWatch alarmes**, procédez comme suit :

   1. Sélectionnez **Create an alarm** (Créer une alarme).

   1. Pour recevoir un e-mail lorsque l’alarme est déclenchée, sélectionnez une rubrique de Amazon SNS existante pour **Alarm notification** (Notification d’alarme). Vous devez d’abord créer une rubrique Amazon SNS à l’aide de la console Amazon SNS. Pour plus d'informations, consultez la section [Utilisation d'Amazon SNS pour la messagerie application-to-person (A2P) dans le manuel](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html) du développeur *Amazon Simple Notification Service*.

   1. Activer l’option **Alarm action** (Action d’alarme), puis sélectionnez **Stop** (Arrêter).

   1. Pour **Group samples by** (Regrouper les échantillons par) et **Type of data to sample** (Type de données à échantillonner), sélectionnez une statistique et une métrique. Dans cet exemple, sélectionnez **Average** (Moyenne) et **CPU utilization** (Utilisation de l’UC).

   1. Pour **Alarm When** (Alarme Quand) et **Percent** (Pourcentage), spécifiez le seuil de la métrique. Dans cet exemple, spécifiez **<=** et **10** pour cent.

   1. Pour **Consecutive period** (Période consécutive) et **Period** (Période), spécifiez la période d’évaluation de l’alarme. Dans cet exemple, spécifiez **1** période consécutive de **5 Minutes**.

   1. Amazon crée CloudWatch automatiquement un nom d'alarme pour vous. Pour modifier le nom, saisissez un nouveau nom dans **Alarm name** (Nom de l’alarme). Les noms d’alarme doivent contenir uniquement des caractères ASCII.
**Note**  
Vous pouvez régler la configuration de l’alarme en fonction de vos propres besoins avant de créer l’alarme, ou pouvez la modifier ultérieurement. Les paramètres de configuration incluent ceux de métrique, de seuil, de durée, d’action et de notification. Cependant, après avoir créé une alarme, vous ne pourrez pas modifier son nom par la suite.

   1. Choisissez **Créer**.

## Ajouter des actions de résiliation aux CloudWatch alarmes Amazon
<a name="AddingTerminateActions"></a>

Vous pouvez créer une alarme qui finit automatiquement une instance EC2 quand un certain seuil a été atteint (aussi longtemps que la protection de fin n’est pas activée pour l’instance). Par exemple, il se peut que vous vouliez finir une instance quand elle a terminé son travail et que vous n’avez pas besoin de l’instance à nouveau. Si vous souhaitez utiliser l’instance par la suite, vous devez arrêter l’instance, et non y mettre fin. Les données stockées sur des volumes de stockage d’instance sont perdues lorsque l’instance est résiliée. Pour plus d’informations sur l’activation et la désactivation de la protection contre la résiliation pour une instance, consultez [Modification de la protection contre la résiliation d’instance](Using_ChangingDisableAPITermination.md).

**Pour créer une alarme afin de résilier une instance inactive (console Amazon EC2)**

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**, **Surveiller et dépanner**, **Gérer les CloudWatch alarmes**.

   Vous pouvez également sélectionner le signe plus ( ![\[Plus sign.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/add-plus.png) ) dans la colonne **Alarm status** (Statut de l’alarme) .

1. Sur la page **Gérer les CloudWatch alarmes**, procédez comme suit :

   1. Sélectionnez **Create an alarm** (Créer une alarme).

   1. Pour recevoir un e-mail lorsque l’alarme est déclenchée, sélectionnez une rubrique de Amazon SNS existante pour **Alarm notification** (Notification d’alarme). Vous devez d’abord créer une rubrique Amazon SNS à l’aide de la console Amazon SNS. Pour plus d'informations, consultez la section [Utilisation d'Amazon SNS pour la messagerie application-to-person (A2P) dans le manuel](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html) du développeur *Amazon Simple Notification Service*.

   1. Activer l’option **Alarm action** (Action d’alarme), puis sélectionnez **Terminate** (Résilier).

   1. Pour **Group samples by** (Regrouper les échantillons par) et **Type of data to sample** (Type de données à échantillonner), sélectionnez une statistique et une métrique. Dans cet exemple, sélectionnez **Average** (Moyenne) et **CPU utilization** (Utilisation de l’UC).

   1. Pour **Alarm When** (Alarme Quand) et **Percent** (Pourcentage), spécifiez le seuil de la métrique. Dans cet exemple, spécifiez **=>** et **10** pour cent.

   1. Pour **Consecutive period** (Période consécutive) et **Period** (Période), spécifiez la période d’évaluation de l’alarme. Dans cet exemple, spécifiez **24** périodes consécutives de **1 heure**.

   1. Amazon crée CloudWatch automatiquement un nom d'alarme pour vous. Pour modifier le nom, saisissez un nouveau nom dans **Alarm name** (Nom de l’alarme). Les noms d’alarme doivent contenir uniquement des caractères ASCII.
**Note**  
Vous pouvez régler la configuration de l’alarme en fonction de vos propres besoins avant de créer l’alarme, ou pouvez la modifier ultérieurement. Les paramètres de configuration incluent ceux de métrique, de seuil, de durée, d’action et de notification. Cependant, après avoir créé une alarme, vous ne pourrez pas modifier son nom par la suite.

   1. Choisissez **Créer**.

## Ajouter des actions de redémarrage aux CloudWatch alarmes Amazon
<a name="AddingRebootActions"></a>

Vous pouvez créer une CloudWatch alarme Amazon qui surveille une instance Amazon EC2 et redémarre automatiquement l'instance. L’action d’alarme de redémarrage est recommandée pour les défaillances de vérification de l’état d’instance (par opposition à l’action d’alarme de récupération, qui convient aux défaillances de la vérification de l’état du système). Le redémarrage d’une instance est similaire à celui d’un système d’exploitation. Dans la plupart des cas, il suffit de quelques minutes pour redémarrer votre instance. Lorsque vous redémarrez une instance, elle reste sur le même hôte physique, ce qui signifie qu’elle conserve son nom DNS public, son adresse IP privée et toutes les données se trouvant sur ses volumes de stockage d’instance.

Le redémarrage d’une instance ne déclenche pas de nouvelle période de facturation d’instance (avec frais d’une minute minimum), contrairement à l’arrêt, puis au redémarrage d’une instance. Les données des volumes de stockage d’instances sont conservées lorsque l’instance est redémarrée. Les volumes de stockage d’instances doivent être remontés dans le système de fichiers après un redémarrage. Pour de plus amples informations, veuillez consulter [Redémarrez votre EC2 instance Amazon](ec2-instance-reboot.md).

**Important**  
Pour prévenir toute condition de concurrence entre les actions de redémarrage et de récupération, évitez de définir le même nombre de périodes d’évaluation pour une alarme de redémarrage et une alarme de récupération. Nous vous recommandons de définir des alarmes de redémarrage sur trois périodes d’évaluation d’une minute chacune. Pour plus d'informations, consultez la section [Évaluation d'une alarme](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarm-evaluation) dans le *guide de CloudWatch l'utilisateur Amazon*.

**Pour créer une alarme afin de redémarrer une instance (console Amazon EC2)**

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**, **Surveiller et dépanner**, **Gérer les CloudWatch alarmes**.

   Vous pouvez également sélectionner le signe plus ( ![\[Plus sign.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/add-plus.png) ) dans la colonne **Alarm status** (Statut de l’alarme) .

1. Sur la page **Gérer les CloudWatch alarmes**, procédez comme suit :

   1. Sélectionnez **Create an alarm** (Créer une alarme).

   1. Pour recevoir un e-mail lorsque l’alarme est déclenchée, sélectionnez une rubrique de Amazon SNS existante pour **Alarm notification** (Notification d’alarme). Vous devez d’abord créer une rubrique Amazon SNS à l’aide de la console Amazon SNS. Pour plus d'informations, consultez la section [Utilisation d'Amazon SNS pour la messagerie application-to-person (A2P) dans le manuel](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html) du développeur *Amazon Simple Notification Service*.

   1. Activer l’option **Alarm action** (Action d’alarme), puis sélectionnez **Reboot** (Redémarrer).

   1. Pour **Group samples by** (Regrouper les échantillons par) et **Type of data to sample** (Type de données à échantillonner), sélectionnez une statistique et une métrique. Dans cet exemple, sélectionnez **Average** (Moyenne) et **Status check failed: instance** (Échec du contrôle de statut : instance).

   1. Pour **Consecutive period** (Période consécutive) et **Period** (Période), spécifiez la période d’évaluation de l’alarme. Dans cet exemple, entrez **3** périodes consécutives de **1 minutes**. Si **1 minute est désactivé**, vous devez [activer la surveillance détaillée](manage-detailed-monitoring.md#enable-detailed-monitoring), ou vous pouvez plutôt choisir **5 minutes**.

   1. Amazon crée CloudWatch automatiquement un nom d'alarme pour vous. Pour modifier le nom, saisissez un nouveau nom dans **Alarm name** (Nom de l’alarme). Les noms d’alarme doivent contenir uniquement des caractères ASCII.

   1. Choisissez **Créer**.

## Ajouter des actions de restauration aux CloudWatch alarmes Amazon
<a name="AddingRecoverActions"></a>

Vous pouvez créer une CloudWatch alarme Amazon qui surveille une instance Amazon EC2. Si l'instance est altérée en raison d'une défaillance matérielle sous-jacente ou d'un problème nécessitant une AWS intervention pour être réparée, vous pouvez la récupérer automatiquement. Les instances mises hors service ne peuvent pas être récupérées. Une instance récupérée est identique à l'instance d'origine, y compris pour l'ID d'instance, les adresses IP privées, les adresses IP Elastic et toutes les métadonnées de l'instance.

CloudWatch vous empêche d'ajouter une action de restauration à une alarme qui se trouve sur une instance qui ne prend pas en charge les actions de restauration.

Lorsque l’alarme `StatusCheckFailed_System` est déclenchée et que l’action de récupération est initiée, vous en êtes averti par la rubrique Amazon SNS que vous avez choisie quand vous avez créé l’alarme et associé l’action de récupération. Lors de la récupération d’instance, l’instance est migrée pendant un redémarrage d’instance, et toutes les données en mémoire sont perdues. Lorsque le processus est terminé, les informations sont publiées dans la rubrique SNS que vous avez configurée pour l’alarme. Toutes les personnes abonnées à cette rubrique SNS reçoivent une notification par e-mail qui inclut le statut de la tentative de récupération et les éventuelles instructions supplémentaires. Vous remarquez un redémarrage d’instance sur l’instance récupérée.

**Note**  
L’action de récupération ne peut être utilisée qu’avec `StatusCheckFailed_System`, pas avec `StatusCheckFailed_Instance`.

Les problèmes suivants peuvent entraîner l’échec des contrôles de statut de système :
+ Perte de connectivité réseau
+ Perte d’alimentation système
+ Problèmes logiciels sur un hôte physique
+ Problèmes matériels sur un hôte physique ayant un impact sur l’accessibilité du réseau

L'opération de récupération est prise en charge uniquement sur les instances présentant certaines caractéristiques. Pour de plus amples informations, veuillez consulter [Récupération automatique des instances](ec2-instance-recover.md).

Si votre instance a une adresse IP publique, elle la conserve après la récupération.

**Important**  
Pour prévenir toute condition de concurrence entre les actions de redémarrage et de récupération, évitez de définir le même nombre de périodes d’évaluation pour une alarme de redémarrage et une alarme de récupération. Nous vous recommandons de définir des alarmes de récupération sur deux périodes d’évaluation d’une minute chacune. Pour plus d'informations, consultez la section [Évaluation d'une alarme](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarm-evaluation) dans le *guide de CloudWatch l'utilisateur Amazon*.

**Pour créer une alarme afin de récupérer une instance (console Amazon EC2)**

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**, **Surveiller et dépanner**, **Gérer les CloudWatch alarmes**.

   Vous pouvez également sélectionner le signe plus ( ![\[Plus sign.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/add-plus.png) ) dans la colonne **Alarm status** (Statut de l’alarme) .

1. Sur la page **Gérer les CloudWatch alarmes**, procédez comme suit :

   1. Sélectionnez **Create an alarm** (Créer une alarme).

   1. Pour recevoir un e-mail lorsque l’alarme est déclenchée, sélectionnez une rubrique de Amazon SNS existante pour **Alarm notification** (Notification d’alarme). Vous devez d’abord créer une rubrique Amazon SNS à l’aide de la console Amazon SNS. Pour plus d'informations, consultez la section [Utilisation d'Amazon SNS pour la messagerie application-to-person (A2P) dans le manuel](https://docs.aws.amazon.com/sns/latest/dg/sns-user-notifications.html) du développeur *Amazon Simple Notification Service*.
**Note**  
Les utilisateurs doivent s’abonner à la rubrique SNS spécifiée pour recevoir des notifications par e-mail lorsque l’alarme se déclenche. Il reçoit Utilisateur racine d'un compte AWS toujours des notifications par e-mail lorsque des actions de restauration automatique d'instance se produisent, même si aucune rubrique SNS n'est spécifiée ou si l'utilisateur root n'est pas abonné à la rubrique SNS spécifiée.

   1. Activer l’option **Alarm action** (Action d’alarme), puis sélectionnez **Recover** (Récupérer).

   1. Pour **Group samples by** (Regrouper les échantillons par) et **Type of data to sample** (Type de données à échantillonner), sélectionnez une statistique et une métrique. Dans cet exemple, sélectionnez **Average** (Moyenne) et **Status check failed: system** (Échec du contrôle de statut : système).

   1. Pour **Consecutive period** (Période consécutive) et **Period** (Période), spécifiez la période d’évaluation de l’alarme. Dans cet exemple, entrez **2** périodes consécutives de **1 minutes**. Si **1 minute est désactivé**, vous devez [activer la surveillance détaillée](manage-detailed-monitoring.md#enable-detailed-monitoring), ou vous pouvez plutôt choisir **5 minutes**.

   1. Amazon crée CloudWatch automatiquement un nom d'alarme pour vous. Pour modifier le nom, saisissez un nouveau nom dans **Alarm name** (Nom de l’alarme). Les noms d’alarme doivent contenir uniquement des caractères ASCII.

   1. Choisissez **Créer**.

# Scénarios CloudWatch d'action d'alarme Amazon
<a name="AlarmActionScenarios"></a>

Vous pouvez utiliser la console Amazon EC2 pour créer des actions d’alarme qui arrêtent ou finissent une instance Amazon EC2 quand certaines conditions sont satisfaites. Dans la capture d’écran suivante de la page de la console où vous avez défini les actions d’alarme, nous avons numéroté les paramètres. Nous avons également numéroté les paramètres des scénarios qui suivent afin de vous aider à créer les actions appropriées.

![\[Page Gérer les alarmes CloudWatch.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/manage-cloudwatch-alarms.png)


## Scénario 1 : arrêter le développement inactif et tester les instances
<a name="StopIdleInstance"></a>

Créez une alarme qui arrête une instance utilisée pour le développement ou le test de logiciels quand elle a été inactive pendant au moins une heure.


| Paramètre | Value | 
| --- | --- | 
|  1  |  Arrêter  | 
|  2  |  Maximum  | 
|  3  |  CPU Utilization  | 
|  4  |  <=  | 
|  5  |  10 %  | 
|  6  |  1  | 
|  7  |  1 heure  | 

## Scénario 2 : arrêter les instances inactives
<a name="StopLowUtilizationInstance"></a>

Créez une alarme qui arrête une instance et envoie un courrier électronique quand l’instance est inactive depuis 24 heures.


| Paramètre | Value | 
| --- | --- | 
|  1  |  Arrêter et envoyer un e-mail  | 
|  2  |  Moyenne  | 
|  3  |  CPU Utilization  | 
|  4  |  <=  | 
|  5  |  5 %  | 
|  6  |  24  | 
|  7  |  1 heure  | 

## Scénario 3 : envoyer un e-mail relatif aux serveurs Web ayant un trafic inhabituellement élevé
<a name="StopHighWebTraffic"></a>

Créez une alarme qui envoie un courrier électronique quand une instance dépasse 10 Go de trafic réseau sortant par jour.


| Paramètre | Value | 
| --- | --- | 
|  1  |  E-mail  | 
|  2  |  Somme  | 
|  3  |  Réseau sortant  | 
|  4  |  >  | 
|  5  |  10 Go  | 
|  6  |  24  | 
|  7  |  1 heure  | 

## Scénario 4 : arrêter les serveurs Web avec un trafic inhabituellement élevé
<a name="StopHighWebTraffic2"></a>

Créez un alarme qui arrête une instance et envoie un SMS quand le trafic sortant excède 1 Go par heure.


| Paramètre | Value | 
| --- | --- | 
|  1  |  Arrêter et envoyer un SMS  | 
|  2  |  Somme  | 
|  3  |  Réseau sortant  | 
|  4  |  >  | 
|  5  |  1 Go  | 
|  6  |  1  | 
|  7  |  1 heure  | 

## Scénario 5 : arrêter une instance déficiente
<a name="StopImpairedInstance"></a>

Créez une alarme qui arrête une instance après qu’elle a échoué à trois contrôles de statut consécutifs (exécutés à 5 minutes d’intervalle).


| Paramètre | Value | 
| --- | --- | 
|  1  |  Arrêter  | 
|  2  |  Moyenne  | 
|  3  |  Échec du contrôle de du statut : Système  | 
|  4  |  -  | 
|  5  |  -  | 
|  6  |  1  | 
|  7  |  15 minutes  | 

## Scénario 6 : résilier les instances quand les tâches de traitement par batch sont terminés
<a name="TerminateBatchProcesses"></a>

Créez une alarme qui finit une instance exécutant des traitements par batch quand elle n’envoie plus de données de résultat.


| Paramètre | Value | 
| --- | --- | 
|  1  |  Terminer  | 
|  2  |  Maximum  | 
|  3  |  Réseau sortant  | 
|  4  |  <=  | 
|  5  |  100,000 bytes  | 
|  6  |  1  | 
|  7  |  5 minutes  | 

# Automatisez Amazon EC2 en utilisant EventBridge
<a name="automating_with_eventbridge"></a>

Vous pouvez utiliser Amazon EventBridge pour automatiser Services AWS et répondre automatiquement aux événements du système, tels que les problèmes de disponibilité des applications ou les modifications des ressources. Les événements AWS liés aux services sont diffusés EventBridge en temps quasi réel. Vous pouvez créer des règles pour indiquer quels événements vous intéressent et les actions à effectuer quand un événement correspond à une règle. Les actions pouvant être déclenchées automatiquement sont les suivantes :
+ Invoquer une AWS Lambda fonction
+ Invoquer la commande Amazon EC2 Run
+ Relayer l’événement à Amazon Kinesis Data Streams
+ Activer une machine à AWS Step Functions états
+ Notifier une rubrique Amazon SNS
+ Notifier une file d’attente Amazon SQS

Voici des exemples d'utilisation que vous pouvez utiliser EventBridge avec Amazon EC2 :
+ Activer une fonction Lambda chaque fois qu’une instance entre dans l’état d’exécution.
+ Notifier une rubrique Amazon SNS lorsqu’un volume Amazon EBS est créé ou modifié.
+ Envoyez une commande à une ou plusieurs EC2 instances Amazon à l'aide d'Amazon EC2 Run Command chaque fois qu'un certain événement se produit dans un autre AWS service.

Pour plus d'informations, consultez le [guide de EventBridge l'utilisateur Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/).

## Types d' EC2 événements Amazon
<a name="ec2-events-eventbridge"></a>

Amazon EC2 prend en charge les types d'événements suivants :
+ [EC2 Modification de l'état de l'AMI](monitor-ami-events.md#ami-events)
+ [EC2 Notification de changement d'état de lancement rapide](win-fast-launch-monitor.md#win-monitor-fast-launch-events)
+ [EC2 Erreur de flotte](monitor-ec2-fleet-using-eventbridge.md#ec2-fleet-config-not-valid)
+ [EC2 Informations sur le parc](monitor-ec2-fleet-using-eventbridge.md#ec2-fleet-info)
+ [EC2 Modification de l'instance du parc](monitor-ec2-fleet-using-eventbridge.md#ec2-fleet-instance-change)
+ [EC2 Demande de modification de l'instance Fleet Spot](monitor-ec2-fleet-using-eventbridge.md#ec2-fleet-spot-instance-request-change)
+ [EC2 Modification de l'état de la flotte](monitor-ec2-fleet-using-eventbridge.md#ec2-fleet-state-change)
+ [EC2 Recommandation de rééquilibrage des instances](rebalance-recommendations.md#cp-eventbridge)
+ [EC2 Notification de changement d'état de l'instance](monitoring-instance-state-changes.md)
+ [EC2 Repérez une erreur de flotte](monitor-ec2-fleet-using-eventbridge.md#spot-fleet-config-not-valid)
+ [EC2 Informations sur la flotte Spot](monitor-ec2-fleet-using-eventbridge.md#spot-fleet-info)
+ [EC2 Changement d'instance de Spot Fleet](monitor-ec2-fleet-using-eventbridge.md#spot-fleet-instance-change)
+ [EC2 Modification de la demande d'instance Spot Fleet Spot](monitor-ec2-fleet-using-eventbridge.md#spot-fleet-spot-instance-request-change)
+ [EC2 Changement d'état du parc de véhicules Spot](monitor-ec2-fleet-using-eventbridge.md#spot-fleet-state-change)
+ [EC2 Avertissement d'interruption d'une instance ponctuelle](spot-instance-termination-notices.md#ec2-spot-instance-interruption-warning-event)
+ [EC2 Traitement des demandes d'instance Spot](spot-request-status.md#spot-request-fulfillment-event)
+ [EC2 Notification de sous-utilisation de l'ODCR](cr-eventbridge.md)

Pour plus d'informations sur les types d'événements pris en charge par Amazon EBS, consultez [Amazon EventBridge pour Amazon EBS](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-cloud-watch-events.html).

# Enregistrez les appels d' EC2 API Amazon à l'aide de AWS CloudTrail
<a name="monitor-with-cloudtrail"></a>

L' EC2 API Amazon est intégrée à [AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un Service AWS. CloudTrail capture tous les appels d' EC2 API Amazon sous forme d'événements. Les appels capturés comprennent les appels effectués par la console. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande envoyée à l' EC2 API Amazon, l'adresse IP à partir de laquelle la demande a été effectuée et la date à laquelle elle a été faite.

Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l’identité permettent de déterminer :
+ Si la demande a été effectuée avec des informations d’identification d’utilisateur root ou d’utilisateur root.
+ Si la demande a été faite au nom d'un utilisateur du centre d'identité IAM.
+ Si la demande a été effectuée avec les informations d’identification de sécurité temporaires d’un rôle ou d’un utilisateur fédéré.
+ Si la requête a été effectuée par un autre Service AWS.

CloudTrail est actif dans votre compte Compte AWS lorsque vous créez le compte et vous avez automatiquement accès à l'**historique des CloudTrail événements**. L'**historique des CloudTrail événements** fournit un enregistrement consultable, consultable, téléchargeable et immuable des 90 derniers jours des événements de gestion enregistrés dans un. Région AWS Pour plus d'informations, consultez la section [Utilisation de l'historique des CloudTrail événements](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) dans le *guide de AWS CloudTrail l'utilisateur*. La consultation de CloudTrail l'**historique des événements est gratuite**.

Pour un enregistrement continu des événements de vos 90 Compte AWS derniers jours, créez un magasin de données sur les événements de Trail ou [CloudTrailLake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html).

**CloudTrail sentiers**  
Un *suivi* permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Tous les sentiers créés à l'aide du AWS Management Console sont multirégionaux. Vous ne pouvez créer un journal de suivi en une ou plusieurs régions à l'aide de l' AWS CLI. Il est recommandé de créer un parcours multirégional, car vous capturez l'activité dans l'ensemble Régions AWS de votre compte. Si vous créez un journal de suivi pour une seule région, il convient de n'afficher que les événements enregistrés dans le journal de suivi pour une seule région Région AWS. Pour plus d'informations sur les journaux de suivi, consultez [Créez un journal de suivi dans vos Compte AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) et [Création d'un journal de suivi pour une organisation](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-trail-organization.html) dans le *AWS CloudTrail Guide de l'utilisateur*.  
Vous pouvez envoyer une copie de vos événements de gestion en cours dans votre compartiment Amazon S3 gratuitement CloudTrail en créant un journal. Toutefois, des frais de stockage Amazon S3 sont facturés. Pour plus d'informations sur la CloudTrail tarification, consultez la section [AWS CloudTrail Tarification](https://aws.amazon.com/cloudtrail/pricing/). Pour obtenir des informations sur la tarification Amazon S3, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/).

**CloudTrail Stockages de données sur les événements du lac**  
*CloudTrail Lake* vous permet d'exécuter des requêtes SQL sur vos événements. CloudTrail Lake convertit les événements existants au format JSON basé sur les lignes au format [Apache ORC](https://orc.apache.org/). ORC est un format de stockage en colonnes qui est optimisé pour une récupération rapide des données. Les événements sont agrégés dans des *magasins de données d’événement*. Ceux-ci constituent des collections immuables d’événements basées sur des critères que vous sélectionnez en appliquant des [sélecteurs d’événements avancés](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors). Les sélecteurs que vous appliquez à un magasin de données d’événement contrôlent les événements qui persistent et que vous pouvez interroger. Pour plus d'informations sur CloudTrail Lake, consultez la section [Travailler avec AWS CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) dans le *guide de AWS CloudTrail l'utilisateur*.  
CloudTrail Les stockages et requêtes de données sur les événements de Lake entraînent des coûts. Lorsque vous créez un magasin de données d’événement, vous choisissez l’[option de tarification](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option) que vous voulez utiliser pour le magasin de données d’événement. L’option de tarification détermine le coût d’ingestion et de stockage des événements, ainsi que les périodes de conservation par défaut et maximale pour le magasin de données d’événement. Pour plus d'informations sur la CloudTrail tarification, consultez la section [AWS CloudTrail Tarification](https://aws.amazon.com/cloudtrail/pricing/).

## Événements de gestion des EC2 API Amazon dans CloudTrail
<a name="cloudtrail-management-events"></a>

[Les événements de gestion](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) fournissent des informations sur les opérations de gestion effectuées sur les ressources de votre Compte AWS. Ils sont également connus sous le nom opérations de plan de contrôle. Par défaut, CloudTrail enregistre les événements de gestion.

Toutes les actions de EC2 l'API Amazon sont enregistrées en tant qu'événements de gestion. Pour obtenir la liste des actions d'API auxquelles vous êtes connecté CloudTrail, consultez le [Amazon EC2 API Reference](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/). Par exemple, les appels au [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html), [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html), et les [https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StopInstances.html](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StopInstances.html) actions sont enregistrés en tant qu'événements de gestion.

## Exemples d'événements EC2 liés à l'API Amazon
<a name="cloudtrail-event-examples"></a>

Un événement représente une demande unique provenant de n'importe quelle source et inclut des informations sur l'opération d'API demandée, la date et l'heure de l'opération, les paramètres de la demande, etc. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics. Les événements n'apparaissent donc pas dans un ordre spécifique.

L’enregistrement de fichier journal suivant montre qu’un utilisateur a résilié une instance.

```
{
   "Records":[
      {
         "eventVersion":"1.03",
         "userIdentity":{
            "type":"Root",
            "principalId":"123456789012",
            "arn":"arn:aws:iam::123456789012:root",
            "accountId":"123456789012",
            "accessKeyId":"AKIAIOSFODNN7EXAMPLE",
            "userName":"user"
         },
         "eventTime":"2016-05-20T08:27:45Z",
         "eventSource":"ec2.amazonaws.com",
         "eventName":"TerminateInstances",
         "awsRegion":"us-west-2",
         "sourceIPAddress":"198.51.100.1",
         "userAgent":"aws-cli/1.10.10 Python/2.7.9 Windows/7botocore/1.4.1",
         "requestParameters":{
            "instancesSet":{
               "items":[{
                  "instanceId":"i-1a2b3c4d"
               }]
            }
         },
         "responseElements":{
            "instancesSet":{
               "items":[{
                  "instanceId":"i-1a2b3c4d",
                  "currentState":{
                     "code":32,
                     "name":"shutting-down"
                  },
                  "previousState":{
                     "code":16,
                     "name":"running"
                  }
               }]
            }
         },
         "requestID":"be112233-1ba5-4ae0-8e2b-1c302EXAMPLE",
         "eventID":"6e12345-2a4e-417c-aa78-7594fEXAMPLE",
         "eventType":"AwsApiCall",
         "recipientAccountId":"123456789012"
     }
   ]
}
```

Pour plus d'informations sur le contenu des CloudTrail enregistrements, voir [le contenu des CloudTrail enregistrements](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html) dans le *Guide de AWS CloudTrail l'utilisateur*.

## Audit des connexions établies à l'aide d' EC2 Instance Connect
<a name="ec2-instance-connect-cloudtrail"></a>

Vous pouvez l'utiliser AWS CloudTrail pour auditer les utilisateurs qui se connectent à vos instances à l'aide d' EC2 Instance Connect.

**Pour auditer l'activité SSH via EC2 Instance Connect à l'aide de la console AWS CloudTrail**

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

1. Vérifiez que vous êtes dans la région correcte.

1. Dans le volet de navigation, sélectionnez **Event history (Historique des événements)**.

1. Pour **Filter (Filtre)**, choisissez **Event source (Source de l’événement)**, **ec2-instance-connect.amazonaws.com**.

1. (Facultatif) Pour **Time range (Plage de temps)**, sélectionnez une plage de temps.

1. Choisissez l’icône **Refresh events (Actualiser les événements)**.

1. La page affiche les événements correspondant aux appels d’API [https://docs.aws.amazon.com/ec2-instance-connect/latest/APIReference/API_SendSSHPublicKey.html](https://docs.aws.amazon.com/ec2-instance-connect/latest/APIReference/API_SendSSHPublicKey.html). Développez un événement à l'aide de la flèche pour afficher des détails supplémentaires, tels que le nom d'utilisateur et la clé d' AWS accès utilisés pour établir la connexion SSH, ainsi que l'adresse IP source.

1. Pour afficher toutes les informations sur l’événement au format JSON, choisissez **Afficher l’événement**. Le champ **requestParameters** contient l’identifiant de l’instance de destination, le nom d’utilisateur OS et la clé publique qui ont été utilisés pour établir la connexion SSH.

   ```
   {
       "eventVersion": "1.05",
       "userIdentity": {
           "type": "IAMUser",
           "principalId": "ABCDEFGONGNOMOOCB6XYTQEXAMPLE",
           "arn": "arn:aws:iam::1234567890120:user/IAM-friendly-name",
           "accountId": "123456789012",
           "accessKeyId": "ABCDEFGUKZHNAW4OSN2AEXAMPLE",
           "userName": "IAM-friendly-name",
           "sessionContext": {
               "attributes": {
                   "mfaAuthenticated": "false",
                   "creationDate": "2018-09-21T21:37:58Z"}
           }
       },
       "eventTime": "2018-09-21T21:38:00Z",
       "eventSource": "ec2-instance-connect.amazonaws.com",
       "eventName": "SendSSHPublicKey ",
       "awsRegion": "us-west-2",
       "sourceIPAddress": "123.456.789.012",
       "userAgent": "aws-cli/1.15.61 Python/2.7.10 Darwin/16.7.0 botocore/1.10.60",
       "requestParameters": {
           "instanceId": "i-0123456789EXAMPLE",
           "osUser": "ec2-user",
           "SSHKey": {
               "publicKey": "ssh-rsa ABCDEFGHIJKLMNO01234567890EXAMPLE"
           }
        },
       "responseElements": null,
       "requestID": "1a2s3d4f-bde6-11e8-a892-f7ec64543add",
       "eventID": "1a2w3d4r5-a88f-4e28-b3bf-30161f75be34",
       "eventType": "AwsApiCall",
       "recipientAccountId": "0987654321"
   }
   ```

   Si vous avez configuré votre AWS compte pour collecter des CloudTrail événements dans un compartiment S3, vous pouvez télécharger et auditer les informations par programmation. Pour plus d'informations, consultez la section [Obtenir et consulter vos fichiers CloudTrail journaux](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/get-and-view-cloudtrail-log-files.html) dans le *guide de AWS CloudTrail l'utilisateur*.

# Surveillez les applications .NET et SQL Server à l'aide d' CloudWatch Application Insights
<a name="monitoring-appinsights"></a>

CloudWatch Application Insights vous aide à surveiller vos applications .NET et SQL Server qui utilisent des instances Amazon EC2 ainsi que d'autres ressources [AWS applicatives](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/appinsights-what-is.html#appinsights-components). Cette solution identifie et configure des journaux de métriques clés et des alarmes sur vos ressources d’application et votre pile technologique (par exemple, votre base de données Microsoft SQL Server, les serveurs Web (IIS) et d’applications, le système d’exploitation, les équilibreurs de charge et les files d’attente). Elle surveille en permanence les métriques et les journaux afin de détecter et de corréler les anomalies et les erreurs. Lorsque des erreurs et des anomalies sont détectées, Application Insights génère des événements que vous pouvez utiliser pour configurer des notifications ou prendre des mesures. Pour faciliter le dépannage, elle crée des tableaux de bord automatisés qui retracent les problèmes détectés, les anomalies métriques, les erreurs de journalisation corrélées, ainsi que des informations supplémentaires vous indiquant la cause potentielle. Les tableaux de bord automatisés vous aident à prendre rapidement des mesures correctives pour vous assurer que vos applications sont saines et que les utilisateurs finaux ne sont pas affectés.

**Informations fournies sur les problèmes détectés**
+ Un bref résumé du problème
+ La date et l’heure de début du problème
+ La gravité du problème : High/Medium/Low
+ Le statut du problème détecté : In‐progress/Resolved (En cours/Résolu)
+ Analyses : génération automatique d’analyses concernant le problème détecté et sa possible cause
+ Commentaires sur les informations : commentaires que vous avez fournis sur l'utilité des informations générées par CloudWatch Application Insights pour .NET et SQL Server
+ Observations connexes : une vue détaillée des anomalies métriques et des extraits pertinents de journaux d’erreurs liés au problème, parmi différents composants d’application

**Commentaires**  
Vous pouvez fournir des commentaires sur les analyses générées automatiquement relatives aux problèmes détectés en les qualifiant d’utiles ou d’inutiles. Les commentaires que vous laissez sur les analyses, ainsi que vos diagnostics d’application (anomalies métriques et exceptions de journaux) sont utilisés pour améliorer les futures détections de problèmes similaires.

Pour plus d'informations, consultez la documentation [CloudWatchApplication Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-application-insights.html) dans le *guide de CloudWatch l'utilisateur Amazon*. 

# Suivez l'utilisation de votre Free Tier pour Amazon EC2
<a name="ec2-free-tier-usage"></a>

Lorsque vous créez votre Compte AWS, vous pouvez commencer à utiliser Amazon EC2 gratuitement en utilisant le niveau [AWS gratuit](https://aws.amazon.com/free). Vos avantages de l’offre gratuite varient selon que vous avez créé votre compte avant le 15 juillet 2025 ou à partir du 15 juillet 2025. Pour plus d'informations, consultez la section [Découvrir les AWS services avec le niveau AWS gratuit](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/free-tier.html) dans le *guide de AWS Billing l'utilisateur*.

## Avantages de l’offre gratuite avant et après le 15 juillet 2025
<a name="ec2-free-tier-comparison"></a>

Le tableau suivant compare vos avantages de l’offre gratuite en fonction de la date de création de votre Compte AWS  :


| Avantages de l’offre gratuite | Compte créé avant le 15 juillet 2025 | Compte créé le 15 juillet 2025 ou après | 
| --- | --- | --- | 
| Types d’instances marqués Éligible à l’offre gratuite |  `t2.micro`, `t3.micro`  |  `t3.micro`, `t3.small`, `t4g.micro`, `t4g.small`, `c7i-flex.large`, `m7i-flex.large`  | 
| Types de volumes Amazon EBS marqués Éligible à l’offre gratuite |  `standard`, `st1`, `sc1`, `gp2` et `gp3`  |  `standard`, `st1`, `sc1`, `gp2` et `gp3`  | 
| AMIs marqué comme éligible au niveau gratuit | Vérifiez si le niveau gratuit est AMIs marqué comme éligible. | Vérifiez si le niveau gratuit est AMIs marqué comme éligible. | 
| Limite d’utilisation | Limité aux limites d'utilisation, après quoi des pay-as-you-go tarifs vous sont facturés. |  Recevez un crédit d’inscription de 100 USD et gagnez jusqu’à 100 USD en crédits supplémentaires.  | 
| Durée de l’offre gratuite | Votre offre gratuite est valable pendant 12 mois à compter de la date de création de votre compte. Pendant cette période, si vous dépassez les limites d'utilisation du niveau gratuit, des pay-as-you-go tarifs vous seront facturés. | Votre offre gratuite est valable pendant 6 mois à compter de la date de création de votre compte ou jusqu’à épuisement de vos crédits, selon la première éventualité. Vous ne pouvez pas dépasser les limites de votre offre gratuite. | 

**Pour répertorier les types d’instances éligibles à l’offre gratuite**  
Utilisez la commande [describe-instance-types](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-types.html) avec le filtre `free-tier-eligible`.

```
aws ec2 describe-instance-types \
    --filters Name=free-tier-eligible,Values=true \
    --query "InstanceTypes[*].[InstanceType]" \
    --output text | sort
```

**Pour répertorier ceux AMIs qui sont éligibles au niveau gratuit**  
Utilisez la commande [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html) avec le filtre `free-tier-eligible`.

```
aws ec2 describe-images \
    --filters Name=free-tier-eligible,Values=true \
    --query "Images[*].[ImageId]" \
    --output text | sort
```

## Suivre l’utilisation de l’offre gratuite pour les comptes créés avant le 15 juillet 2025
<a name="track-ec2-free-tier-usage"></a>

**Note**  
***Cette section s'applique uniquement aux utilisateurs du niveau gratuit qui ont créé Comptes AWS avant le 15 juillet 2025. Si vous avez créé votre compte le 15 juillet 2025 ou après cette date, consultez la section [Suivi de votre utilisation du niveau AWS gratuit](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/tracking-free-tier-usage.html) dans le guide de AWS Billing l'utilisateur.***

Si vous avez créé votre compte avant le 15 juillet 2025, vous pouvez utiliser Amazon EC2 sans frais si vous êtes AWS client depuis moins de 12 mois et si vous respectez les limites d'utilisation. Niveau gratuit d'AWS Il est important de suivre votre utilisation de l’offre gratuite pour éviter les surprises liées à la facturation. Si vous dépassez les limites du niveau gratuit, vous devrez payer des pay-as-go frais standard. Pour de plus amples informations, veuillez consulter [Niveau gratuit d'AWS](https://aws.amazon.com/free/).

**Note**  
Si vous êtes AWS client depuis plus de 12 mois, vous n'êtes plus éligible à l'utilisation du niveau gratuit et vous ne verrez pas la case du **niveau gratuit EC2** décrite dans la procédure suivante.

**Pour suivre votre utilisation de l’offre gratuite**

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 **Tableau de bord du EC2**.

1. Recherchez la case **Offre gratuite EC2** (en haut à droite).  
![\[La case Offre gratuite EC2 dans le tableau de bord EC2.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/ec2-free-tier-widget.png)

1. Dans la case **Offre gratuite EC2**, vérifiez votre utilisation de l’offre gratuite, comme suit :
   + Sous **Offres gratuites EC2 en cours d’utilisation**, prenez note des avertissements :
     + **Prévisions de fin de mois** : vous avertit que des frais vous seront facturés ce mois si vous continuez avec votre modèle d’utilisation actuel.
     + **Dépasse l’offre gratuite** : indique que vous avez dépassé les limites de l’offre gratuite et que vous avez déjà engagé des frais.
   + Sous **Utilisation de l’offre (mensuelle)**, notez votre utilisation des instances Linux, des instances Windows et du stockage EBS. Le pourcentage indique la part des limites de l’offre gratuite que vous avez utilisée ce mois-ci. Si vous êtes à 100 %, des frais vous seront facturés pour toute utilisation ultérieure.
**Note**  
Ces informations apparaissent uniquement une fois que vous avez créé une instance. Toutefois, les informations relatives à l’utilisation ne sont pas mises à jour en temps réel, mais trois fois par jour.

1. Pour éviter d’encourir des frais supplémentaires, supprimez toutes les ressources qui sont actuellement facturées ou qui le seront si vous dépassez la limite d’utilisation de votre offre gratuite.
   + Pour les instructions relatives à la suppression de votre instance, consultez [Terminez l'instance Amazon EC2](terminating-instances.md).
   + Pour vérifier si vous disposez de ressources dans d’autres régions qui sont susceptibles d’être facturées, dans la case **Offre gratuite EC2**, choisissez **Afficher les ressources EC2 globales** et ouvrir la **vue globale EC2**. Pour de plus amples informations, veuillez consulter [Afficher les ressources dans toutes les régions à l'aide de AWS Global View](global-view.md).

1. Pour afficher l'utilisation de vos ressources pour Services AWS tous Niveau gratuit d'AWS, en bas de la case **EC2 Free Tier**, choisissez **Afficher toutes les Niveau gratuit d'AWS offres**. Pour plus d'informations, consultez [ Essais de services utilisant Niveau gratuit d'AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-free-tier.html) le *Guide de l'utilisateur de la facturation AWS *.

# Comprendre les codes utilisés par Amazon EC2 dans les rapports de facturation et d'utilisation
<a name="ec2-billing-usage-reports"></a>

Lorsque vous utilisez Amazon EC2, nous incluons les codes associés dans vos rapports AWS de facturation et d'utilisation. L'examen de ces codes vous aide à comprendre vos coûts et vos habitudes d'utilisation pour Amazon EC2. Le suivi et la gestion de vos dépenses sont essentiels pour optimiser vos coûts.

Les tableaux suivants décrivent les codes Amazon EC2 qui apparaissent dans vos rapports de facturation et d'utilisation. Pour obtenir la liste des codes de région utilisés dans les rapports de facturation et d’utilisation, consultez la section [Codes de facturation des AWS](https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-region-billing-codes.html).

**Topics**
+ [

## instances
](#instances-billing-usage-reports)
+ [

## Instances nues
](#bare-metal-instances-billing-usage-reports)
+ [

## Hôtes dédiés
](#dedicated-hosts-billing-usage-reports)
+ [

## Dedicated instances
](#dedicated-instances-billing-usage-reports)
+ [

## Optimisation EBS
](#ebs-billing-usage-reports)
+ [

## Réserve de capacité
](#capacity-reservation-billing-usage-reports)

**Ressources connexes**
+ [Modalités de facturation et d'achat de l'Amazon EC2](instance-purchasing-options.md)
+ [Comprendre les informations de facturation d’AMI](ami-billing-info.md)
+ [ EC2 Tarifs Amazon](https://aws.amazon.com/ec2/pricing/)

## instances
<a name="instances-billing-usage-reports"></a>


| Code | Description | Uunités | 
| --- | --- | --- | 
| region-BoxUsage:instance-type | Durée d’exécution pour les instances à la demande. | Heures | 
| region-HostBoxUsage:instance-type | Durée d’exécution des instances sur les hôtes dédiés. | Heures | 
| region-SpotUsage:instance-type | Durée d’exécution des instances Spot. | Heures | 



## Instances nues
<a name="bare-metal-instances-billing-usage-reports"></a>


| Code | Description | Uunités | 
| --- | --- | --- | 
| region-BoxUsage: instance-family .métal | Durée d’exécution pour les instances à la demande matériel nu. | Heures | 
| region-HostBoxUsage: instance-family .métal | Durée d’exécution des instances matériel nu sur des hôtes dédiés. | Heures | 
| region-SpotUsage: instance-family .métal | Durée d’exécution des instances Spot matériel nu. | Heures | 



## Hôtes dédiés
<a name="dedicated-hosts-billing-usage-reports"></a>


| Code | Description | Uunités | 
| --- | --- | --- | 
| region-HostUsage:host-type | Heure à laquelle les hôtes dédiés sont alloués. | Heures | 
| region-ReservedHostUsage:host-type | Heure à laquelle les réserves d’hôtes dédiés sont appliquées. | Heures | 



## Dedicated instances
<a name="dedicated-instances-billing-usage-reports"></a>


| Code | Description | Uunités | 
| --- | --- | --- | 
| region-DedicatedUsage:instance-type | Durée d’exécution des instances dédiées. | Heures \$1 frais par région | 



## Optimisation EBS
<a name="ebs-billing-usage-reports"></a>


| Code | Description | Uunités | 
| --- | --- | --- | 
| region-EBSOptimized:instance-type | Heure à laquelle l’optimisation EBS est activée. | Heures | 



## Réserve de capacité
<a name="capacity-reservation-billing-usage-reports"></a>


| Code | Description | Uunités | 
| --- | --- | --- | 
| region-Reservation:instance-type | Durée de l’instance réservée pour les réserves de capacité. | Heures | 
| region-UnusedBox:instance-type | La durée d’instance réservée inutilisée pour les réserves de capacité. | Heures | 
| region-DedicatedRes:instance-type | La durée de l’instance réservée pour les réserves de capacité dédiées. | Heures | 
| region-UnusedDed:instance-type | La durée d’instance réservée inutilisée pour les réserves de capacité dédiées. | Heures | 



# Créez un inventaire de vos EC2 instances
<a name="ec2-data-inventory"></a>

Amazon EC2 fournit des capacités informatiques évolutives à la demande. Une EC2 instance est un serveur virtuel qui s'exécute sur le AWS réseau.

Le tableau suivant décrit les principales caractéristiques d'une EC2 instance. Un administrateur système peut utiliser les instructions fournies dans ce guide pour obtenir des informations sur ces caractéristiques et les utiliser pour configurer des serveurs fonctionnellement équivalents qui s’exécutent sur site ou dans le réseau d’un autre fournisseur de cloud.


| Caractéristiques | Description | 
| --- | --- | 
| [Emplacement géographique](#ec2-data-geographic-location) | Amazon EC2 est hébergé dans toutes les AWS régions du monde. Vous choisissez des emplacements pour vos instances qui les placent à proximité de vos clients. Vous pouvez lancer des instances à plusieurs emplacements. | 
| [Caractéristiques du matériel](#ec2-data-specifications) | Amazon EC2 propose une large sélection de types d'instances, optimisés pour différents cas d'utilisation. Les types d’instances que vous sélectionnez pour vos instances déterminent leurs ressources de calcul, de mémoire, de réseau et de stockage. | 
| [Images](#ec2-data-images) | Une Amazon Machine Image (AMI) inclut le logiciel à installer sur votre instance au lancement. Cela inclut le système d’exploitation, les progiciels et les configurations personnalisées. | 
| [Adresses IP et noms d’hôte DNS](#ec2-data-ip-dns) | Les instances reçoivent des adresses IP privées et un nom d’hôte DNS privé. Si vous configurez une adresse IP publique pour une instance, celle-ci reçoit également un nom d’hôte DNS public. | 
| [Règles relatives aux groupes de sécurité](#ec2-data-rules) | Les règles du groupe de sécurité associées à vos instances déterminent le trafic entrant et sortant autorisé. | 
| [Données de l’utilisateur](#ec2-data-user-data) | Les données utilisateur sont mises à la disposition des instances lors du lancement. Il s'agit de scripts shell (Linux) ou de PowerShell scripts (Windows). | 

## Situation géographique
<a name="ec2-data-geographic-location"></a>

Amazon EC2 est disponible dans toutes les AWS régions du monde. Chaque région constitue une zone géographique séparée. Vous pouvez réduire la latence du réseau en choisissant pour vos serveurs des régions proches de la majorité de vos utilisateurs.

Vous pouvez utiliser [Amazon EC2 Global View](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/global-view.html) pour répertorier vos EC2 instances Amazon dans toutes les régions. Avec l'API AWS Management Console et l'API, vous devez répertorier les instances de chaque région individuellement.

**Pourquoi est-ce important**  
Après avoir déterminé l’emplacement de vos instances, vous pouvez décider de déployer des serveurs fonctionnellement équivalents aux mêmes emplacements ou à des emplacements différents, en fonction de vos besoins.

**Pour obtenir un résumé de vos EC2 instances dans toutes les régions**

1. Ouvrez la console Amazon EC2 Global View à la [https://console.aws.amazon.com/ec2globalview/maison](https://console.aws.amazon.com/ec2globalview/home).

1. Dans l’onglet **Explorateur de régions**, sous **Résumé**, vérifiez le nombre de ressources pour **Instances**, qui inclut le nombre d’instances et le nombre de régions. Cliquez sur le texte souligné pour voir comment le nombre d’instances est réparti entre les régions.

1. Dans l’onglet **Recherche globale**, sélectionnez le filtre client **Type de ressource = Instance**. Vous pouvez filtrer davantage les résultats en spécifiant une région ou une balise.

**Pour obtenir le nombre d' EC2 instances dans une région à l'aide du AWS CLI**  
Utilisez la commande [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html) suivante pour compter les instances dans la région spécifiée. Vous devez exécuter cette commande dans chaque région où vous avez des instances.

```
aws ec2 describe-instances \
    --region us-east-2 \
    --query "length(Reservations[*].Instances[])"
```

Voici un exemple de sortie.

```
27
```

Pour obtenir une liste des instances IDs au lieu du nombre d'instances, utilisez plutôt le `--query` paramètre suivant.

```
--query "Reservations[*].Instances[].InstanceId"
```

## Spécifications matérielles
<a name="ec2-data-specifications"></a>

Le type d'instance que vous spécifiez pour une EC2 instance détermine les ressources de calcul, de mémoire, de stockage et de réseau mises à sa disposition. Chaque famille d’instances offre un équilibre différent entre les ressources de calcul, de mémoire, de réseau et de stockage. Pour plus d'informations, consultez le [guide des types d' EC2 instances Amazon](https://docs.aws.amazon.com/ec2/latest/instancetypes/instance-types.html).

**Pourquoi est-ce important**  
Après avoir déterminé les spécifications matérielles de vos instances, vous pouvez définir les spécifications minimales requises pour des serveurs fonctionnellement équivalents.

**Pour obtenir un résumé des types d’instances utilisés par vos instances**  
Utilisez la commande [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html) suivante. La commande **sed** supprime les lignes entre crochets et les lignes vides. Vous devez exécuter cette commande dans chaque région où vous avez des instances.

```
aws ec2 describe-instances \
    --query "Reservations[*].Instances[].InstanceType" | sed 's/[][]//g;/^$/d' | sort | uniq -c | sort -nr
```

Voici un exemple de sortie.

```
  20    "c6i.4xlarge",
   5    "t2.micro",
   2    "g6e.2xlarge",
```

**Pour obtenir des informations sur des types d’instance spécifiques**  
Utilisez la [describe-instance-types](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-types.html)commande suivante pour décrire les types d'instances. Le paramètre `--query` n’inclut que les champs spécifiés dans la sortie. Telles sont les caractéristiques de base. Vous pouvez inclure tous les champs supplémentaires dont vous avez besoin, ou vous pouvez vous référer aux [spécifications relatives aux types d' EC2 instances Amazon](https://docs.aws.amazon.com/ec2/latest/instancetypes/ec2-instance-type-specifications.html) *dans le guide des types d' EC2 instances Amazon*.

```
aws ec2 describe-instance-types \
    --instance-types c6i.4xlarge t2.micro g6e.2xlarge \
    --query "InstanceTypes[*].[InstanceType,VCpuInfo.DefaultVCpus,MemoryInfo.SizeInMiB,NetworkInfo.NetworkPerformance]" \
    --output table
```

Voici un exemple de sortie. Les colonnes sont le type d'instance, vCPUs, la mémoire (GiB) et la bande passante réseau (Gbit/s).

```
------------------------------------------------------
|                DescribeInstanceTypes               |
+--------------+-----+--------+----------------------+
|  t2.micro    |  1  |  1024  |  Low to Moderate     |
|  c6i.4xlarge |  16 |  32768 |  Up to 12.5 Gigabit  |
|  g6e.2xlarge |  8  |  65536 |  Up to 20 Gigabit    |
+--------------+-----+--------+----------------------+
```

## Images
<a name="ec2-data-images"></a>

Une Amazon Machine Image (AMI) fournit les logiciels installés sur votre instance au lancement, tels que le système d’exploitation, les services, les outils de développement et les applications. Vous pouvez exporter une AMI vers d’autres formats afin de l’utiliser avec d’autres serveurs.

**Pourquoi est-ce important**  
Après avoir déterminé les images AMIs pour vos instances, vous pouvez planifier les images requises pour des serveurs fonctionnellement équivalents. Il est peut-être possible de l'exporter AMIs dans un format que vous pouvez utiliser ailleurs. Vous pouvez également avoir besoin de vous connecter à une instance que vous avez lancée à partir de chaque AMI, de confirmer ce qui est installé et comment elle est configurée, et de vous assurer que vous disposez d’une copie de tout ce dont vous avez besoin.

**Pour obtenir le AMIs pour vos instances**  
Utilisez la commande [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html) suivante. La commande **sed** supprime les lignes entre crochets et les lignes vides. Vous devez exécuter cette commande dans chaque région où vous avez des instances.

```
aws ec2 describe-instances \
    --query "Reservations[*].Instances[].ImageId" | sed 's/[][]//g;/^$/d' | sort | uniq -c | sort -nr
```

Voici un exemple de sortie.

```
20     "ami-0a70b9d193ae8a79",
 5     "ami-07d9cf938edb0739b",
 2     "ami-09245d5773578a1d6",
```

**Pour obtenir des informations sur des sujets spécifiques AMIs**  
Utilisez la commande [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html) suivante. Le paramètre `--query` n’inclut que les champs spécifiés dans la sortie. Vous pouvez inclure tous les champs supplémentaires dont vous avez besoin.

```
aws ec2 describe-images \
    --image-id ami-0a70b9d193ae8a79 ami-07d9cf938edb0739b ami-09245d5773578a1d6 \
    --query "Images[*].{ID:ImageId,CreateDate:CreationDate,Name:Name,Description:Description}"
```

Voici un exemple de sortie.

```
[
    {
        "ID": "ami-0a70b9d193ae8a799",
        "CreateDate": "2025-03-01T02:22:41.000Z",
        "Name": "web-server-3.1",
        "Description": "Image for web servers"
    },
    {
        "ID": "ami-07d9cf938edb0739b",
        "CreateDate": "2025-02-01T23:59:03.000Z",
        "Name": "awesome-application-11.5",
        "Description": "Image for Awesome Application"
    },
    {
        "ID": "ami-09245d5773578a1d6",
        "CreateDate": "2025-01-31T02:22:41.000Z",
        "Name": "monitoring-4.2",
        "Description": "Monitoring software"
    }
]
```

**Pour créer un fichier de machine virtuelle à partir d’une AMI**  
Utilisez la commande [export-image](https://docs.aws.amazon.com/cli/latest/reference/ec2/export-image.html). Les formats d'image pris en charge sont VHD (compatible avec Citrix Xen et Microsoft Hyper-V), VMDK (compatible avec ESX VMware et VMware vSphere) et le format brut (compatible avec les hyperviseurs KVM et Xen). Pour plus d'informations sur les exigences et les limites de l'importation/exportation de machines virtuelles, consultez la section Exigences relatives aux [machines virtuelles Import/Export ](https://docs.aws.amazon.com/vm-import/latest/userguide/vmie_prereqs.html).

## Adresses IP et noms d’hôte DNS
<a name="ec2-data-ip-dns"></a>

Vos utilisateurs se connectent à vos EC2 instances via Internet à l'aide de leurs noms d'hôte DNS publics. Le nom d'hôte DNS public d'une EC2 instance est remplacé par son adresse IP publique. EC2 les instances peuvent communiquer entre elles à l'aide de leurs adresses IP privées.

**Pourquoi est-ce important**  
Les adresses IP permettent aux périphériques de communiquer entre eux via un réseau local ou via Internet. En notant les adresses IP et les noms DNS de vos instances, vous pouvez contribuer à garantir que des serveurs fonctionnellement équivalents peuvent communiquer avec les mêmes clients ou périphériques que vos instances. Par exemple, vous pouvez mettre à jour la configuration de votre équilibreur de charge ou les enregistrements DNS que vous avez créés pour votre fournisseur DNS.

**Pour obtenir les adresses IP et les noms d’hôte DNS de vos instances**  
Utilisez la commande [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html) suivante. Vous devez exécuter cette commande dans chaque région où vous avez des instances. Le paramètre `--query` n’inclut que les champs spécifiés dans la sortie. Vous pouvez inclure tous les champs supplémentaires dont vous avez besoin.

```
aws ec2 describe-instances \
    --query "Reservations[*].Instances[].[InstanceId,PrivateIpAddress,PublicDnsName]" \
    --output table
```

Voici un exemple de sortie. Les colonnes sont l'ID d'instance, IPv4 l'adresse privée et le nom IPv4 DNS public.

```
----------------------------------------------------------------------------------------
|                                   DescribeInstances                                  |
+---------------------+------------+---------------------------------------------------+
| i-0bac57d7472c89bac | 10.0.2.139 | ec2-192-0-2-142.us-east-2.compute.amazonaws.com   |
| i-0fa8b7678975a3fff | 10.0.14.85 | ec2-198-51-100-56.us-east-2.compute.amazonaws.com |
  ...
  ...
| i-08fd74f3f1595fdbd | 10.0.1.241 | ec2-203.0.113.13.us-east-2.compute.amazonaws.com  |
+---------------------+------------+---------------------------------------------------+
```

## Règles des groupes de sécurité
<a name="ec2-data-rules"></a>

Le groupe de sécurité agit comme un pare-feu virtuel. Une fois que vous avez associé un groupe de sécurité à une EC2 instance, ses règles autorisent le trafic entrant et sortant pour l' EC2 instance via des ports et des protocoles spécifiques.

**Pourquoi est-ce important**  
Après avoir déterminé le trafic entrant autorisé à atteindre votre serveur et le trafic sortant autorisé à quitter votre serveur, vous pouvez planifier les règles de pare-feu nécessaires pour les serveurs fonctionnellement équivalents.

**Pour obtenir les groupes de sécurité pour vos instances**  
Utilisez la commande [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html) suivante. La commande **sed** supprime les lignes entre crochets et les lignes vides. Vous devez exécuter cette commande dans chaque région où vous avez des instances.

```
aws ec2 describe-instances \
    --query "Reservations[*].Instances[].SecurityGroups[].GroupId" | sed 's/[][]//g;/^$/d' | sort | uniq -c | sort -nr
```

Voici un exemple de sortie.

```
27     "sg-01dd3383691d02f42",
10     "sg-08c77cc910c0b3b2c",
 2     "sg-00f4e409629f1a42d",
```

**Pour obtenir les règles entrantes pour un groupe de sécurité**  
Utilisez la [describe-security-group-rules](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-security-group-rules.html)commande suivante pour afficher les règles du groupe de sécurité spécifié où se `IsEgress` trouve`false`.

```
aws ec2 describe-security-group-rules \
    --filters Name=group-id,Values=sg-01dd3383691d02f42 \
    --query 'SecurityGroupRules[?IsEgress==`false`]'
```

Voici un exemple de sortie. La première est la règle entrante par défaut, qui autorise le trafic entrant à partir de toutes les ressources attribuées à ce groupe de sécurité. L’autre règle autorise le trafic SSH à partir des adresses IP de la liste de préfixes spécifiée. Pour décrire les blocs CIDR dans une liste de préfixes, utilisez la [describe-prefix-lists](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-prefix-lists.html)commande.

```
[
    {
        "SecurityGroupRuleId": "sgr-06c8b42574a91db1b",
        "GroupId": "sg-01dd3383691d02f42",
        "GroupOwnerId": "123456789012",
        "IsEgress": false,
        "IpProtocol": "-1",
        "FromPort": -1,
        "ToPort": -1,
        "ReferencedGroupInfo": {
            "GroupId": "sg-01dd3383691d02f42",
            "UserId": "123456789012"
        },
        "Tags": [],
        "SecurityGroupRuleArn": "arn:aws:ec2:us-west-2:123456789012:security-group-rule/sgr-06c8b42574a91db1b"
    },
    {
        "SecurityGroupRuleId": "sgr-0886a5d46afcd1758",
        "GroupId": "sg-01dd3383691d02f42",
        "GroupOwnerId": "123456789012",
        "IsEgress": false,
        "IpProtocol": "tcp",
        "FromPort": 22,
        "ToPort": 22,
        "PrefixListId": "pl-f8a6439125e7bf465",
        "Tags": [],
        "SecurityGroupRuleArn": "arn:aws:ec2:us-east-2:123456789012:security-group-rule/sgr-0886a5d46afcd1758"
    }
]
```

**Pour obtenir les règles sortantes pour un groupe de sécurité**  
Utilisez la [describe-security-group-rules](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-security-group-rules.html)commande suivante pour afficher les règles du groupe de sécurité spécifié où se `IsEgress` trouve`true`.

```
aws ec2 describe-security-group-rules \
    --filters Name=group-id,Values=sg-01dd3383691d02f42 \
    --query 'SecurityGroupRules[?IsEgress==`true`]'
```

Voici un exemple de sortie. Il contient uniquement la règle sortante par défaut, qui autorise tout le trafic sortant IPv4 .

```
[
    {
        "SecurityGroupRuleId": "sgr-048f09a719247dce7",
        "GroupId": "sg-01dd3383691d02f42",
        "GroupOwnerId": "123456789012",
        "IsEgress": true,
        "IpProtocol": "-1",
        "FromPort": -1,
        "ToPort": -1,
        "CidrIpv4": "0.0.0.0/0",
        "Tags": [],
        "SecurityGroupRuleArn": "arn:aws:ec2:us-east-2:123456789012:security-group-rule/sgr-048f09a719247dce7"
    }
]
```

## Données de l’utilisateur
<a name="ec2-data-user-data"></a>

Lorsque vous lancez une EC2 instance, vous pouvez lui transmettre un script shell à l'aide des données utilisateur. Notez que les données utilisateur sont codées en base64, vous devez donc les décoder pour lire le script.

**Pourquoi est-ce important**  
Si vous exécutez des commandes au lancement dans le cadre de la configuration de vos instances, vous devrez peut-être effectuer les mêmes tâches lors de la configuration de serveurs fonctionnellement équivalents.

**Pour afficher les données utilisateur décodées pour une instance**  
Utilisez la commande [describe-instance-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-attribute.html) suivante. La commande **base64** décode les données utilisateur.

```
aws ec2 describe-instance-attribute \
    --instance-id i-1234567890abcdef0 \
    --attribute userData \
    --output text \
    --query "UserData.Value" | base64 --decode
```

Voici un exemple de sortie.

```
#!/bin/bash
yum update -y
service httpd start
chkconfig httpd on
```

## Ressources connexes
<a name="ec2-data-related-resources"></a>

Les caractéristiques supplémentaires des EC2 instances sont les suivantes :
+ [Paires de clés](ec2-key-pairs.md)
+ [Stockage](Storage.md)
+ [Balises](Using_Tags.md)

Vous pouvez vérifier si vous utilisez les éléments suivants pour lancer EC2 des instances ou répartir le trafic entre vos EC2 instances :
+ [Groupes Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html)
+ [EC2 Parc](Fleets.md)
+ [Elastic Load Balancing](https://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/)