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.
# Scénario : publier des métriques sur CloudWatch
Dans ce scénario, vous utilisez le AWS Command Line Interface (AWS CLI) pour publier une seule métrique pour une application hypothétique nommée. *GetStarted* Si vous ne l'avez pas encore installé et configuré AWS CLI, consultez la section [Getting Up with the AWS Command Line Interface dans le](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) *guide de AWS Command Line Interface l'utilisateur*.
**Topics**
+ [Étape 1 : définir la configuration des données](#define-data-domain)
+ [Étape 2 : ajouter des métriques à CloudWatch](#add-metrics-to-scenario)
+ [Étape 3 : obtenir des statistiques à partir de CloudWatch](#GetStatistics)
+ [Étape 4 : afficher des graphiques avec la console](#ViewGraphs)
## Étape 1 : définir la configuration des données
Dans ce scénario, vous publiez des points de données qui suivent la latence des demandes pour l'application. Choisissez des noms explicites pour votre métrique et votre espace de noms. Pour cet exemple, nommez la métrique *RequestLatency*et placez tous les points de données dans l'espace de *GetStarted*noms.
Vous publiez plusieurs points de données pour un total de trois heures de données de latence. Les données brutes comprennent 15 mesures de latence de demande sur plus de trois heures. Chaque mesure est en millisecondes :
+ Première heure : 87, 51, 125, 235
+ Deuxième heure : 121, 113, 189, 65, 89
+ Troisième heure : 100, 47, 133, 98, 100, 328
Vous pouvez publier des données CloudWatch sous forme de points de données uniques ou d'un ensemble agrégé de points de données appelé *ensemble de statistiques*. Vous pouvez regrouper les métriques afin d'obtenir un niveau de détail aussi précis qu'une minute. Vous pouvez publier les points de données regroupés sur CloudWatch sous la forme d'un ensemble de statistiques avec quatre clés prédéfinies : `Sum`, `Minimum`, `Maximum` et `SampleCount`.
Vous publiez les points de données de la première heure en tant que points de données uniques. Pour les données de la deuxième et de la troisième heures, vous regroupez les points de données et publierez un ensemble de statistiques pour chaque heure. Les valeurs de ces clés figurent dans le tableau suivant.
| Heure | Données brutes | Somme | Minimum | Maximum | SampleCount |
| --- | --- | --- | --- | --- | --- |
| `1` | `87` | | | | |
| `1` | `51` | | | | |
| `1` | `125` | | | | |
| `1` | `235` | | | | |
| `2` | `121, 113, 189, 65, 89` | `577` | `65` | `189` | `5` |
| `3` | `100, 47, 133, 98, 100, 328` | `806` | `47` | `328` | `6` |
## Étape 2 : ajouter des métriques à CloudWatch
Après avoir défini la configuration de vos données, vous pouvez commencer à ajouter des données.
**Pour publier des points de données sur CloudWatch**
1. À l'invite de commandes, exécutez les [put-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-data.html)commandes suivantes pour ajouter des données pendant la première heure. Remplacez l'horodatage en exemple avec un horodatage de deux heures dans le passé, en heure UTC (Universal Coordinated Time).
```
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp 2016-10-14T20:30:00Z --value 87 --unit Milliseconds
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp 2016-10-14T20:30:00Z --value 51 --unit Milliseconds
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp 2016-10-14T20:30:00Z --value 125 --unit Milliseconds
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp 2016-10-14T20:30:00Z --value 235 --unit Milliseconds
```
1. Ajoutez des données pour la deuxième heure, à l'aide d'un horodatage défini une heure plus tard que la première heure.
```
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--timestamp 2016-10-14T21:30:00Z --statistic-values Sum=577,Minimum=65,Maximum=189,SampleCount=5 --unit Milliseconds
```
1. Ajoutez des données pour la troisième heure, en omettant l'horodatage par défaut à l'heure actuelle.
```
aws cloudwatch put-metric-data --metric-name RequestLatency --namespace GetStarted \
--statistic-values Sum=806,Minimum=47,Maximum=328,SampleCount=6 --unit Milliseconds
```
## Étape 3 : obtenir des statistiques à partir de CloudWatch
Maintenant que vous avez publié des métriques sur CloudWatch, vous pouvez récupérer des statistiques basées sur ces métriques à l'aide de la [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-statistics.html)commande suivante. Assurez-vous de spécifier `--start-time` et `--end-time` assez loin dans le passé afin de couvrir le premier horodatage que vous avez publié.
```
aws cloudwatch get-metric-statistics --namespace GetStarted --metric-name RequestLatency --statistics Average \
--start-time 2016-10-14T00:00:00Z --end-time 2016-10-15T00:00:00Z --period 60
```
Voici un exemple de sortie :
```
{
"Datapoints": [],
"Label": "Request:Latency"
}
```
## Étape 4 : afficher des graphiques avec la console
Après avoir publié des métriques sur CloudWatch, vous pouvez utiliser la CloudWatch console pour afficher des graphiques statistiques.
**Pour afficher des graphiques de vos statistiques sur 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**, choisissez **Métriques**.
1. Dans l'onglet **Toutes les mesures**, dans le champ de recherche, tapez **RequestLatency**et appuyez sur Entrée.
1. Cochez la case correspondant à la **RequestLatency**métrique. Un graphique des données de métrique s'affiche dans le volet supérieur.
Pour de plus amples informations, veuillez consulter [Graphique des métriques](graph_metrics.md).