Scénario : publier des métriques sur CloudWatch - Amazon CloudWatch
Étape 1 : définir la configuration des donnéesÉtape 2 : ajouter des métriques à CloudWatch Étape 3 : obtention des statistiques de CloudWatch Étape 4 : afficher des graphiques avec la console

Scénario : publier des métriques sur CloudWatch

Dans ce scénario, vous utilisez AWS Command Line Interface (AWS CLI) afin de publier une seule métrique pour une application hypothétique nommée GetStarted. Si vous n'avez pas déjà installé et configuré AWS CLI, consultez Installation de AWS Command Line Interface dans le Guide de l'utilisateur AWS Command Line Interface.

É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 noms GetStarted.

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 sur CloudWatch sous la forme de points de données uniques ou d'un ensemble de points de données regroupés 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 commande, exécutez les commandes put-metric-data suivantes pour ajouter des données pour 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

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

  3. 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 : obtention des statistiques 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 commande get-metric-statistics comme suit. 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 console CloudWatch pour afficher des graphiques statistiques.

Pour afficher des graphiques de vos statistiques sur la console

  1. Ouvrez la console CloudWatch à l’adresse https://console.aws.amazon.com/cloudwatch/.

  2. Dans le panneau de Navigation, choisissez Métriques.

  3. Sous l'onglet Toutes les métriques, dans la zone de recherche, tapez RequestLatency et appuyez sur Entrée.

  4. Sélectionnez la case à cocher pour la métrique RequestLatency. Un graphique des données de métrique s'affiche dans le volet supérieur.

Pour de plus amples informations, consultez Graphique des métriques.