

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.

# 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"
}
```