Scénario : publier des métriques sur CloudWatch - Amazon CloudWatch

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 guide de AWS Command Line Interface l'utilisateur.

É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 RequestLatencyet placez tous les points de données dans l'espace de GetStartednoms.

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-datacommandes 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
  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 : 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-statisticscommande 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/.

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

  3. Dans l'onglet Toutes les mesures, dans le champ de recherche, tapez RequestLatencyet appuyez sur Entrée.

  4. Cochez la case correspondant à la RequestLatencymé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.