

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.

# Obtention des statistiques d’une métrique
<a name="getting-metric-statistics"></a>

# CloudWatch définitions des statistiques
<a name="Statistics-definitions"></a>

Les statistiques sont des regroupements de données de métrique sur une période donnée. Lorsque vous tracez ou récupérez les statistiques d'une métrique, vous spécifiez le paramètre *Period (Période)*, par exemple cinq minutes, à utiliser pour calculer chaque valeur statistique. Par exemple, si le champ **Period (Période)** est cinq minutes, le champ**Sum (Somme)** est la somme de toutes les valeurs de l'échantillon recueillies au cours de la période de cinq minutes, tandis que le paramètre **Minimum** est la valeur la plus faible recueillie au cours de la période de cinq minutes.

CloudWatch prend en charge les statistiques suivantes pour les métriques.
+ **SampleCount**est le nombre de points de données au cours de la période.
+ **Sum** (Somme) est la somme des valeurs de tous les points de données collectés au cours de la période.
+ **Average (Moyenne)** est la valeur de `Sum/SampleCount` pendant la période spécifiée.
+ **Minimum** est la valeur la plus basse observée pendant la période spécifiée.
+ **Maximum** est la valeur la plus haute observée pendant la période spécifiée.
+ **Percentile (p) (Centile [p])** indique la position relative d'une valeur dans un jeu de données. Par exemple, **p95** est le 95e centile et signifie que 95 % les données de cette période sont inférieures à cette valeur et que 5 % des données lui sont supérieures. Les centiles vous permettent de mieux comprendre la distribution des données de vos métriques.
+ **Trimmed mean (TM) (Moyenne ajustée [TM])** est la moyenne de toutes les valeurs situées entre deux limites spécifiées. Les valeurs en dehors des limites sont ignorées lorsque la moyenne est calculée. Vous définissez les limites comme un ou deux nombres compris entre 0 et 100, jusqu'à 10 décimales. Les nombres peuvent être des valeurs absolues ou des pourcentages. Par exemple, **tm90** calcule la moyenne après avoir supprimé les 10 % des points de données avec les valeurs les plus élevées. **TM(2 %:98 %)** calcule la moyenne après avoir supprimé les 2 % de points de données les plus bas et les 2 % de points de données les plus élevés. **TM(150:1000)** calcule la moyenne après avoir supprimé tous les points de données inférieurs ou égaux à 150, ou supérieurs à 1 000.
+ **Interquartile mean (IQM) (Moyenne interquartile [IQM])** est la moyenne ajustée de la *plage interquartile*, ou le milieu 50 % des valeurs. Elle est équivalente à **TM(25 %:75 %)**.
+ **Winsorized mean (WM) (Moyenne winsorisée [WM])** est similaire à la moyenne ajustée. Cependant, avec la moyenne winsorisée, les valeurs qui sont en dehors de la limite ne sont pas ignorées, mais sont considérées comme égales à la valeur au bord de la limite appropriée. Après cette normalisation, la moyenne est calculée. Vous définissez les limites comme un ou deux nombres compris entre 0 et 100, jusqu'à 10 décimales. Par exemple, **wm98** calcule la moyenne tout en traitant les 2 % des valeurs les plus élevées pour être égal à la valeur au 98e percentile. **WM(10 %:90 %)** calcule la moyenne tout en traitant les 10 % les plus élevés des points de données comme étant la valeur de la limite de 90 %, et en traitant les 10 % les plus bas des points de données comme étant la valeur de la limite de 10 %.
+ **Percentile rank (PR) (Rang centile [PR])** est le pourcentage de valeurs qui atteignent un seuil fixe. Par exemple, **PR(:300)** renvoie le pourcentage de points de données dont la valeur est inférieure ou égale à 300. **PR(100:2000)** renvoie le pourcentage de points de données dont la valeur est comprise entre 100 et 2 000.

  Le rang de centile est exclusif sur la limite inférieure et inclusif sur la limite supérieure.
+ **Trimmed count (Nombre ajusté [TC])** est le nombre de points de données dans la plage choisie pour une statistique moyenne ajustée. Par exemple, **tc90** renvoie le nombre de points de données, sans compter les points de données qui se situent dans les 10 % les plus élevés des valeurs. **TC(0,005:0,030)** renvoie le nombre de points de données avec des valeurs comprises entre 0,005 (exclusif) et 0,030 (inclus).

  Le nombre ajusté peut renvoyer une valeur décimale au lieu d’un nombre entier. En effet, il s’agit d’une valeur approximative interpolée qui peut donner des résultats fractionnaires. 
+ **Trimmed sum (Somme ajustée [TS])** est la somme des valeurs des points de données dans la plage choisie pour une statistique moyenne ajustée. Elle est équivalente à (Moyenne ajustée) \$1 (Nombre ajusté). Par exemple, **ts90** renvoie la somme des points de données, sans compter les points de données qui se situent dans les 10 % les plus élevés des valeurs. **TS(80 %:)** renvoie la somme des valeurs de point de données, sans compter les points de données dont les valeurs se situent dans les 80 % les plus bas de la plage de valeurs.

**Note**  
Pour la moyenne ajustée, le nombre ajusté, la somme ajustée et la moyenne winsorisée, si vous définissez deux limites en tant que valeurs fixes au lieu de pourcentages, le calcul inclut des valeurs égales à la limite supérieure, mais n'inclut pas les valeurs égales à la limite inférieure.

## Syntaxe
<a name="Statistics-syntax"></a>

Pour la moyenne ajustée, le nombre ajusté, la somme ajustée et la moyenne winsorisée, les règles de syntaxe suivantes s'appliquent :
+ L'utilisation de parenthèses avec un ou deux nombres sans signe de pourcentage définit les limites à utiliser comme valeurs dans le jeu de données qui se trouvent entre les deux centiles que vous spécifiez. Par exemple, **TM(10 %:90 %)** utilise uniquement les valeurs comprises entre le 10e et le 90e centiles. **TM(:95 %)** utilise les valeurs de l'extrémité la plus basse des données définies jusqu'au 95e centile, en ignorant les 5 % des points de données avec les valeurs les plus élevées. 
+ L'utilisation de parenthèses avec un ou deux nombres sans signe de pourcentage définit les limites à utiliser comme valeurs dans le jeu de données qui se trouvent entre les valeurs explicites que vous spécifiez. Par exemple, **TC(80:500)** utilise uniquement les valeurs comprises entre 80 (exclusive) et 500 (inclusive). **TC(:0,5)** utilise uniquement les valeurs qui sont égales ou inférieures à 0,5. 
+ L'utilisation d'un nombre sans parenthèses calcule à l'aide de pourcentages, en ignorant les points de données supérieurs au centile spécifié. Par exemple, **tm99** calcule la moyenne tout en ignorant 1 % des points de données avec la valeur la plus élevée. Il s'agit de la même valeur que **TM(:99 %)**. 
+ La moyenne ajustée, le nombre ajusté, la somme ajustée et la moyenne winsorisée peuvent toutes être abrégées à l'aide de lettres majuscules lors de la spécification d'une plage, telle que **TM(5 %:95 %)**, **TM(100:200)** ou **TM(:95 %)**. Ils ne peuvent être abrégés qu'en minuscules lorsque vous spécifiez un seul nombre, tel que **tm99**.

## Cas d'utilisation des statistiques
<a name="Statistics-usecases"></a>
+ **Trimmed mean (Moyenne ajustée)** est particulièrement utile pour les métriques ayant une taille d'échantillon importante, comme la latence de page Web. Par exemple, **tm99** ne tient pas compte des valeurs aberrantes extrêmement élevées qui pourraient résulter de problèmes de réseau ou d'erreurs humaines, afin de donner un nombre plus précis pour la latence moyenne des requêtes typiques. De même, **TM(10 %:)**ne tient pas compte des 10 % les plus faibles des valeurs de latence, telles que celles résultant des accès au cache. Et **TM(10 %:99 %)** exclut ces deux types de valeurs aberrantes. Nous vous recommandons d'utiliser une moyenne ajustée pour surveiller la latence. 
+ Il est conseillé de surveiller le nombre de valeurs ajustées chaque fois que vous utilisez la moyenne ajustée, pour vous assurer que le nombre de valeurs utilisées dans vos calculs de moyenne ajustée est suffisant pour être statistiquement significatif.
+ Le rang de centile vous permet de placer des valeurs dans des « casiers » de plages, et vous pouvez l'utiliser pour créer manuellement un histogramme. Pour ce faire, décomposez vos valeurs en plusieurs casiers, tels que **PR(:1)**, **PR(1:5)**, **PR(5:10)** et **PR(10:)**. Placez chacun de ces casiers dans une visualisation sous forme de graphiques à barres, et vous obtenez un histogramme.

  Le rang de centile est exclusif sur la limite inférieure et inclusif sur la limite supérieure.

## Centiles par rapport à la moyenne ajustée
<a name="Percentile-versus-Trimmed-Mean"></a>

Un centile, tel que **p99**, et une moyenne ajustée, telle que **tm99**, mesurent des valeurs similaires, mais pas identiques. **p99** et **tm99** ignorent 1 % des points de données avec les valeurs les plus élevées, qui sont considérés comme des valeurs aberrantes. Puis, **p99** est la **valeur maximale des 99 % restants, tandis que **tm99** est la *moyenne* des 99 % restants. Si vous regardez la latence des requêtes Web, **p99** vous indique la pire expérience client, en ignorant les valeurs aberrantes, tandis que **tm99** vous indique l'expérience client moyenne, en ignorant les valeurs aberrantes.

La moyenne ajustée est une bonne statistique de latence à surveiller si vous cherchez à optimiser votre expérience client.

## Exigences relatives à l'utilisation de centiles, de la moyenne ajustée et d'autres statistiques
<a name="Percentiles-trimmedmean-requirements"></a>

CloudWatch a besoin de points de données bruts pour calculer les statistiques suivantes :
+ Centiles
+ Moyenne ajustée
+ Moyenne interquartile
+ Moyenne winsorisée
+ Somme ajustée
+ Nombre ajustée
+ Rang de centile

Si vous publiez des données pour des statistiques personnalisées à l'aide d'un jeu de statistiques au lieu de données brutes, vous pouvez récupérer ces types de statistiques pour ces données uniquement si l'une des conditions suivantes est vraie :
+ La SampleCount valeur de l'ensemble de statistiques est 1 et Min, Max et Sum sont tous égaux.
+ Les valeurs Min et Max sont égales, et Sum est égale à Min multiplié par SampleCount.

Les AWS services suivants incluent des mesures qui prennent en charge ces types de statistiques.
+ API Gateway
+ Application Load Balancer
+ Amazon EC2
+ Elastic Load Balancing
+ Kinesis
+ Amazon RDS

De plus, ces types de statistiques sur les centiles ne sont pas disponibles pour les métriques lorsque l'une des valeurs des métriques est un nombre négatif.

## Exemples
<a name="statistics-examples-intro"></a>

Les exemples suivants vous montrent comment obtenir des statistiques pour les CloudWatch métriques relatives à vos ressources, telles que vos instances EC2.

**Topics**

# Obtenir des statistiques pour une ressource spécifique
<a name="US_SingleMetricPerInstance"></a>

L'exemple suivant vous montre comment déterminer l'utilisation maximale de l'UC d'une instance EC2 spécifique.

**Exigences**
+ Vous devez avoir l’ID de l’instance. Vous pouvez obtenir l'ID d'instance à l'aide de la console Amazon EC2 ou de 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 plus d’informations, consultez [Activer ou désactiver la surveillance détaillée pour vos instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-cloudwatch-new.html) dans le *Guide de l’utilisateur Amazon EC2*.

**Afficher l'utilisation moyenne de l'UC pour une instance spécifique à l'aide de la console**

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

1. Dans le panneau de navigation, sélectionnez **Métriques**, **Toutes les métriques**.

1. Sélectionnez l'espace de noms de métrique **EC2**.  
![\[Sélectionnez l'espace de noms des métriques EC2\]](http://docs.aws.amazon.com/fr_fr/AmazonCloudWatch/latest/monitoring/images/metric_view_categories.png)

1. Sélectionnez la dimension **Per-Instance Metrics (Métriques par instance)**.  
![\[Afficher les dimensions des métriques pour Amazon EC2\]](http://docs.aws.amazon.com/fr_fr/AmazonCloudWatch/latest/monitoring/images/metric_view_metric_category.png)

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

1. Pour modifier les statistiques, choisissez l'onglet **Graphed metrics (Graphique des métriques)**. Choisissez l'en-tête de colonne ou une valeur individuelle, puis choisissez l'une des statistiques ou des centiles prédéfinis, ou bien spécifiez un centile personnalisé (par exemple, **p99.999**).  
![\[Modifier les statistiques d'une métrique\]](http://docs.aws.amazon.com/fr_fr/AmazonCloudWatch/latest/monitoring/images/metric_statistics_ec2_instance_statistic_period.png)

1. Pour modifier la période, choisissez l'onglet **Graphed metrics (Graphique des métriques)**. Sélectionnez l’en-tête de colonne ou une valeur individuelle et choisissez une autre valeur.

**Pour obtenir l'utilisation du processeur par instance EC2 à l'aide du AWS CLI**  
Utilisez la [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)commande comme suit pour obtenir la `CPUUtilization` métrique pour l'instance spécifiée.

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

Les statistiques renvoyées sont des valeurs de six minutes pour l'intervalle de 24 heures demandé. Chaque valeur représente le pourcentage maximal d'utilisation de l'UC pour l'instance spécifiée au cours d'une période de six minutes donnée. Les points de données ne sont pas renvoyés dans l'ordre chronologique. Voici une illustration du début de l'exemple de sortie (la sortie complète comprend des points de données correspondant à tous les intervalles de six minutes au cours de la période de 24 heures).

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

# Regrouper des statistiques sur des ressources
<a name="GetSingleMetricAllDimensions"></a>

Vous pouvez agréger les mesures relatives AWS aux ressources de plusieurs ressources. Les métriques sont complètement séparées entre les régions, mais vous pouvez utiliser les calculs de métriques pour agréger des métriques similaires entre les régions. Pour de plus amples informations, veuillez consulter [Utilisation d'expressions mathématiques avec des CloudWatch métriques](using-metric-math.md).

Par exemple, vous pouvez regrouper des statistiques pour vos instances EC2 qui ont la surveillance détaillée activée. Les instances qui utilisent une surveillance basique ne sont pas incluses. Par conséquent, vous devez activer la surveillance détaillée (à un coût supplémentaire), qui fournit des données par périodes de 1 minute. Pour plus d’informations, consultez [Activer ou désactiver la surveillance détaillée pour vos instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-cloudwatch-new.html) dans le *Guide de l’utilisateur Amazon EC2*.

Cet exemple vous montre comment obtenir l'utilisation moyenne de l'UC pour vos instances EC2. Aucune dimension n'étant spécifiée, CloudWatch renvoie des statistiques pour toutes les dimensions de l'espace de `AWS/EC2` noms. Pour obtenir les statistiques d'autres métriques, consultez la page [AWS services qui publient CloudWatch des statistiques](aws-services-cloudwatch-metrics.md).

**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 dans lesquels vous publiez. 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. 

**Afficher l'utilisation moyenne de l'UC pour vos instances EC2**

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

1. Dans le panneau de navigation, sélectionnez **Métriques**, **Toutes les métriques**.

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

1. Sélectionnez la ligne contenant `CPUUtilization` qui affiche un graphique pour la métrique pour toutes vos instances EC2. Pour modifier le nom du graphique, choisissez l'icône représentant un 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/AmazonCloudWatch/latest/monitoring/images/metric_aggregated_instances.png)

1. Pour modifier les statistiques, choisissez l'onglet **Graphed metrics (Graphique des métriques)**. Choisissez l'en-tête de colonne ou une valeur individuelle, puis choisissez l'une des statistiques ou des centiles prédéfinis, ou bien spécifiez un centile personnalisé (par exemple, **p95.45**).

1. Pour modifier la période, choisissez l'onglet **Graphed metrics (Graphique des métriques)**. Sélectionnez l'en-tête de colonne ou une valeur individuelle et choisissez une autre valeur.

**Pour obtenir l'utilisation moyenne du processeur sur vos instances EC2 à l'aide du AWS CLI**  
Utilisez la commande [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-staticstics.html) comme suit :

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

Voici un exemple de sortie :

```
{
    "Datapoints": [
        {
            "SampleCount": 238.0, 
            "Timestamp": "2016-10-12T07:18:00Z", 
            "Average": 0.038235294117647062, 
            "Unit": "Percent"
        }, 
        {
            "SampleCount": 240.0, 
            "Timestamp": "2016-10-12T09:18:00Z", 
            "Average": 0.16670833333333332, 
            "Unit": "Percent"
        }, 
        {
            "SampleCount": 238.0, 
            "Timestamp": "2016-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. Les métriques sont complètement distinctes entre les régions, mais vous pouvez utiliser les mathématiques des CloudWatch métriques pour agréger et transformer les métriques de plusieurs régions. Vous pouvez également utiliser le tableau de bord multi-comptes pour effectuer des calculs sur les métriques provenant de différents comptes.

Cet exemple vous montre comment obtenir le nombre total d'octets écrit 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 à l'aide de la console**

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

1. Dans le panneau de navigation, sélectionnez **Métriques**, **Toutes les métriques**.

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

1. Sélectionnez 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 modifier le nom du graphique, choisissez l'icône représentant un crayon. Pour modifier la plage de temps, sélectionnez l'une des valeurs prédéfinies ou choisissez **custom (personnalisé)**.  
![\[Métriques regroupées à travers un groupe Auto Scaling\]](http://docs.aws.amazon.com/fr_fr/AmazonCloudWatch/latest/monitoring/images/metric_aggregated_auto_scaling.png)

1. Pour modifier les statistiques, choisissez l'onglet **Graphed metrics (Graphique des métriques)**. Choisissez l'en-tête de colonne ou une valeur individuelle, puis choisissez l'une des statistiques ou des centiles prédéfinis, ou bien spécifiez un centile personnalisé (par exemple, **p95.45**).

1. Pour modifier la période, choisissez l'onglet **Graphed metrics (Graphique des métriques)**. Sélectionnez l'en-tête de colonne ou une valeur individuelle et choisissez une autre valeur.

**DiskWriteBytes Pour obtenir les instances d'un groupe Auto Scaling à l'aide du 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  
--dimensions Name=AutoScalingGroupName,Value=my-asg --statistics "Sum" "SampleCount" \
--start-time 2016-10-16T23:18:00 --end-time 2016-10-18T23:18:00 --period 360
```

Voici un exemple de sortie.

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

# Regrouper des statistiques par Amazon Machine Image (AMI)
<a name="US_SingleMetricPerAMI"></a>

Vous pouvez regrouper des statistiques pour les instances EC2 dont la surveillance détaillée est activée. Les instances qui utilisent une surveillance basique ne sont pas incluses. Pour plus d’informations, consultez [Activer ou désactiver la surveillance détaillée pour vos instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-cloudwatch-new.html) dans le *Guide de l’utilisateur Amazon EC2*.

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

**Afficher l'utilisation moyenne de l'UC par AMI à l'aide de la console**

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

1. Dans le panneau de navigation, sélectionnez **Métriques**, **Toutes les métriques**.

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

1. Sélectionnez la ligne de la métrique `CPUUtilization` et l'AMI spécifique, qui affiche un graphique pour la métrique pour l'AMI spécifiée. Pour modifier le nom du graphique, choisissez l'icône représentant un crayon. Pour modifier la plage de temps, sélectionnez l'une des valeurs prédéfinies ou choisissez **custom (personnalisé)**.  
![\[Métriques regroupées par AMI\]](http://docs.aws.amazon.com/fr_fr/AmazonCloudWatch/latest/monitoring/images/metric_aggregated_ami.png)

1. Pour modifier les statistiques, choisissez l'onglet **Graphed metrics (Graphique des métriques)**. Choisissez l'en-tête de colonne ou une valeur individuelle, puis choisissez l'une des statistiques ou des centiles prédéfinis, ou bien spécifiez un centile personnalisé (par exemple, **p95.45**).

1. Pour modifier la période, choisissez l'onglet **Graphed metrics (Graphique des métriques)**. Sélectionnez l'en-tête de colonne ou une valeur individuelle et choisissez une autre valeur.

**Pour obtenir l'utilisation moyenne du processeur par AMI à l'aide du 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 \
--dimensions Name=ImageId,Value=ami-3c47a355 --statistics Average \
--start-time 2016-10-10T00:00:00 --end-time 2016-10-11T00:00:00 --period 3600
```

L'opération retourne les statistiques qui sont des valeurs d'une heure pour un intervalle d'un jour. Chaque valeur représente le pourcentage d'utilisation moyenne de l'UC pour les instances EC2 exécutant l'AMI spécifiée. Voici un exemple de sortie.

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