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.
mon-get-stats
Description
Permet d'obtenir des données en séries chronologiques pour les statistiques spécifiées.
Note
Lorsque vous créez une nouvelle métrique avec la commande mon-put-data, jusqu'à deux minutes peuvent être nécessaires avant de pouvoir extraire les statistiques de la nouvelle métrique au moyen de la commande mon-get-stats. Cependant, l'affichage de la nouvelle métrique dans la liste des métriques récupérées au moyen de la commande mon-list-metrics peut prendre jusqu'à quinze minutes.
Syntaxe
mon-get-stats MetricName
--namespace
value --statistics value[,value...] [--dimensions "key1=value1,key2=value2..."
] [--end-time value] [--period value] [--start-time value] [--unit value] [Common Options]
Options
| Nom | Description |
|---|---|
|
|
Le nom de la métrique. Vous pouvez également définir cette valeur à l'aide de Type : argument Valeurs valides : tout nom de métrique valide comportant entre 1 et 255 caractères. Par défaut : n/a Obligatoire : oui |
|
|
Dimensions de la métrique. Vous pouvez spécifier les dimensions de deux manières et les formats peuvent être combinés ou utilisés de façon interchangeable :
Type : carte Valeurs valides : une chaîne au format name=value, où la clé est le nom de la dimension et la valeur est la valeur de la dimension. Les noms de dimension et les valeurs doivent être une chaîne ANSI comportant entre 1 et 250 caractères. 10 dimensions au maximum sont autorisées. Par défaut : n/a Obligatoire : non |
|
|
Dernier horodatage autorisé des points de données retournés. L'heure de fin est exclusive. Les horodatages sont spécifiés en utilisant le format combiné ISO8601. Par exemple, la date et l'heure du 30 juillet 2013 à 12:30:00 PST seraient représentées comme 2013-07-30T12:30:00-07:00, ou en UTC : 2013-07-30. T19:30:00Z La résolution la plus élevée pouvant être renvoyée CloudWatch est de 1 minute. Par conséquent, tous les horodatages sont arrondis à la minute la plus proche. Type : argument Valeurs valides : un horodatage valide représenté au format ISO8601 avec un décalage de fuseau horaire ou l'indicateur de l'heure universelle coordonnée (UTC). Par défaut : le courant date/time. Obligatoire : non |
|
|
Espace de noms de la métrique. Pour plus d'informations sur les espaces de noms, consultez AWS Espaces de noms. Type : Chaîne Valeurs valides : espace de noms valide comportant entre 1 et 250 caractères. Par défaut : n/a Obligatoire : oui |
|
|
Granularité, en secondes, pour laquelle récupérer des statistiques. La période doit être d'au moins 60 secondes et doit être un multiple de 60. Type : argument Valeurs valides : un nombre (en secondes) qui est un multiple de 60 secondes. Par défaut : 60 secondes. Obligatoire : non |
|
|
Statistiques à renvoyer pour la métrique spécifiée. Type : énumération Valeurs valides : Moyenne, Somme, Maximum ou Minimum Par défaut : n/a Obligatoire : oui |
|
|
Premier horodatage autorisé des points de données retournés. L'heure de début est inclusive. Les horodatages sont spécifiés en utilisant le format combiné ISO8601. Par exemple, la date et l'heure du 30 juillet 2013 à 12:30:00 PST seraient représentées comme 2013-07-30T12:30:00-07:00, ou en UTC : 2013-07-30. T19:30:00Z La résolution la plus élevée pouvant être renvoyée CloudWatch est de 1 minute. Par conséquent, tous les horodatages sont arrondis à la minute la plus proche. Type : argument Valeurs valides : un horodatage valide représenté au format ISO8601 avec un décalage de fuseau horaire ou l'indicateur de l'heure universelle coordonnée (UTC). Par défaut : une heure avant l'heure actuelle. Obligatoire : non |
|
|
Unité pour laquelle récupérer les métriques. Les métriques peuvent être rapportées dans plusieurs unités, cette commande permet d'extraire une unité spécifique pour une métrique donnée. Le fait de ne pas demander d'unité entraîne le renvoi de toutes les unités. Si la métrique est signalée avec une seule unité, cela n'a aucun effet. Type : énumération Valeurs valides : l'une des valeurs suivantes :
Par défaut : n/a Obligatoire : non |
Options courantes
| Nom | Description |
|---|---|
|
|
Emplacement du fichier contenant vos AWS informations d'identification. Vous pouvez définir cette valeur à l'aide de la variable d'environnement Type : Chaîne Valeurs valides : chemin d'accès valide à un fichier contenant votre identifiant de clé d'accès et votre clé d'accès secrète. Par défaut : utilise la variable d'environnement |
|
|
Emplacement de votre fichier de certificat EC2 pour les demandes de signature. Vous pouvez utiliser la variable d'environnement Type : Chaîne Valeurs valides : chemin de fichier valide vers le fichier PEM fourni par Amazon EC2 ou. Gestion des identités et des accès AWS Par défaut : utilise la variable d'environnement |
|
|
Valeur d'expiration de la connexion, en secondes. Type : Integer Valeurs valides : tout nombre positif. Valeur par défaut : 30 |
|
|
Le délimiteur à utiliser lors de l'affichage des résultats délimités (longs). Type : Chaîne Valeurs valides : toute chaîne. Par défaut : virgule (,) |
|
|
Si vous affichez des résultats tabulaires ou délimités, incluez les en-têtes de colonne. Si vous affichez des résultats XML, renvoyez les en-têtes HTTP de la demande de service, le cas échéant. Type : indicateur Valeurs valides : lorsqu'elles sont présentes, affiche les en-têtes. Par défaut : l'option |
|
|
L'identifiant de clé d'accès utilisé conjointement à la clé secrète pour signer la demande. Cela doit être utilisé conjointement à --secret-key, sinon l'option est ignorée. Toutes les demandes CloudWatch doivent être signées, sinon la demande sera rejetée. Type : Chaîne Valeurs valides : un identifiant de clé d'accès valide. Par défaut : aucun |
|
|
La clé privée utilisée pour signer la demande. L'utilisation de public/private touches entraîne l'utilisation de SOAP par la CLI. La demande est signée à l'aide d'un certificat public et d'une clé privée. Ce paramètre doit être utilisé en conjonction avec Type : Chaîne Valeurs valides : chemin d'accès à une clé ASN.1 privée valide. Par défaut : aucun |
|
|
Les demandes de région sont dirigées vers. Vous pouvez utiliser la variable d'environnement Type : Chaîne Valeurs valides : n'importe quelle AWS région, par exemple us-east-1. Par défaut : us-east-1, sauf si la variable d'environnement |
|
|
La clé d'accès secrète utilisée pour signer la demande, en conjonction avec un identifiant de clé d'accès. Ce paramètre doit être utilisé en conjonction avec Type : Chaîne Valeurs valides : votre identifiant de clé d'accès. Par défaut : aucun |
|
|
Affiche les champs vides utilisant (nil) comme espace réservé pour indiquer que ces données n'ont pas été demandées. Type : indicateur Valeurs valides : aucune Par défaut : les champs vides ne sont pas affichés par défaut. |
|
|
Affiche l'URL utilisée par l'interface de ligne de commande (CLI) pour appeler AWS. Type : indicateur Valeurs valides : aucune Par défaut : FAUX |
|
|
Spécifie comment les résultats sont affichés : dans une table, délimités (long), XML ou sans sortie (silencieux). L'affichage Type : indicateur Valeurs valides : aucune Par défaut : |
|
|
URL utilisée pour le contact CloudWatch. Vous pouvez définir cette valeur à l'aide de la variable d'environnement Type : Chaîne Valeurs valides : une URL HTTP ou HTTPS valide. Par défaut : utilise la valeur spécifiée dans |
Output
Cette commande renvoie un tableau contenant ce qui suit :
-
Heure - Heure à laquelle la métrique a été évaluée.
-
SampleCount - Aucune description n'est disponible pour cette colonne.
-
Moyenne - Valeur moyenne.
-
Somme - Somme des valeurs.
-
Minimum - Valeur observée minimale.
-
Maximum - Valeur observée maximale.
-
Unité - Unité de la métrique.
L'Amazon CloudWatch CLI affiche des erreurs sur stderr.
Exemples
Exemple de demande
Cet exemple renvoie la moyenne, le minimum et le maximum de l'utilisation de l'UC pour l'instance EC2 i-c07704a9, avec une résolution de 1 heure.
mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2" --dimensions "InstanceId=i-c07704a9"
Ceci est un exemple de sortie des métriques Échantillons et Moyenne avec une résolution d'une minute.
Time Samples Average Unit 2013-05-19 00:03:00 2.0 0.19 Percent 2013-05-19 00:04:00 2.0 0 Percent 2013-05-19 00:05:00 2.0 0 Percent 2013-05-19 00:06:00 2.0 0 Percent 2013-05-19 00:07:00 2.0 0 Percent 2013-05-19 00:08:00 2.0 0 Percent 2013-05-19 00:09:00 2.0 0 Percent 2013-05-19 00:10:00 2.0 0 Percent 2013-05-19 00:11:00 2.0 0 Percent 2013-05-19 00:12:00 2.0 0.195 Percent 2013-05-19 00:13:00 2.0 0.215 Percent ...
Exemple de requête
Cet exemple renvoie de l'utilisation de l'UC dans votre parc EC2.
mon-get-stats CPUUtilization --start-time 2013-02-14T23:00:00.000Z --end-time 2013-03-14T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "AWS/EC2"
Exemple de demande
Cet exemple renvoie le nombre moyen, minimum et maximum de requêtes adressées à la pile de test MyService pour un utilisateur particulier, avec une résolution d'une heure.
mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum" --namespace "MyService" --dimensions "User=SomeUser,Stack=Test"
Exemple de demande
Cet exemple montre RequestCount des statistiques pour l'ensemble de « MyService ».
mon-get-stats RequestCount --start-time 2013-11-24T23:00:00.000Z --end-time 2013-11-25T23:00:00.000Z --period 3600 --statistics "Average,Minimum,Maximum,SampleCount" --namespace "MyService"
Rubriques associées
Download
Action connexe
Commandes connexes
