mon-get-stats - Amazon CloudWatch
DescriptionSyntaxeOptionsOptions courantesSortieExemplesRubriques en relation

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

Name (Nom) Description

MetricName

Le nom de la métrique. Vous pouvez également définir cette valeur à l'aide de --metric-name.

Type : argument

Valeurs valides : tout nom de métrique valide comportant entre 1 et 255 caractères.

Par défaut : S.o.

Obligatoire : oui

--dimensions "key1=value1,key2=value2..."

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 :

  • Une option par dimension : --dimensions "key1=value1" --dimensions "key2=value2"

  • Option tout en un : --dimensions "key1=value1,key2=value2"

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 : S.o.

Obligatoire : non

--end-time VALUE

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é ISO86 01. 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 au format UTC : 2013-07-30T19:30:00Z. La résolution maximale pouvant être renvoyée est de 1 minute, CloudWatch c'est pourquoi tous les horodatages sont arrondis à la minute inférieure la plus proche.

Type : argument

Valeurs valides : horodatage valide représenté au format ISO86 01 avec décalage horaire ou indicateur UTC.

Par défaut : date/heure actuelles.

Obligatoire : non

-n, --namespace VALUE

Espace de noms de la métrique. Pour plus d'informations sur les espaces de noms, consultez AWS Espaces de noms.

Type : String

Valeurs valides : espace de noms valide comportant entre 1 et 250 caractères.

Par défaut : S.o.

Obligatoire : oui

--period VALUE

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

-s, --statistics VALUE1,VALUE2,VALUE3...

Statistiques à renvoyer pour la métrique spécifiée.

Type : énumération

Valeurs valides : Moyenne, Somme, Maximum ou Minimum

Par défaut : S.o.

Obligatoire : oui

--start-time VALUE

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é ISO86 01. 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 au format UTC : 2013-07-30T19:30:00Z. La résolution maximale pouvant être renvoyée est de 1 minute, CloudWatch c'est pourquoi tous les horodatages sont arrondis à la minute inférieure la plus proche.

Type : argument

Valeurs valides : horodatage valide représenté au format ISO86 01 avec décalage horaire ou indicateur UTC.

Par défaut : une heure avant l'heure actuelle.

Obligatoire : non

--unit VALUE

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 :

  • Secondes

  • Microsecondes

  • Millisecondes

  • Octets

  • Kilooctets

  • Mégaoctets

  • Gigaoctets

  • Téra-octets

  • Bits

  • Kilobits

  • Megabits

  • Gigabits

  • Terabits

  • Pourcentage

  • Nombre

  • Octets/seconde

  • Kilo-octets/seconde

  • Mega-octets/seconde

  • Giga-octets/seconde

  • Tera-octets/seconde

  • Bits/seconde

  • Kilobits/seconde

  • Megabits/seconde

  • Gigabits/seconde

  • Terabits/seconde

  • Nombre/seconde

  • Aucun

Par défaut : S.o.

Obligatoire : non

Options courantes

Nom Description

--aws-credential-file VALUE

L'emplacement du fichier contenant vos AWS informations d'identification. Vous pouvez définir cette valeur à l'aide de la variable d'environnement AWS_CREDENTIAL_FILE. Si vous définissez la variable d'environnement ou si vous fournissez le chemin d'accès au fichier d'informations d'identification, le fichier doit exister ou la demande échoue. Toutes les CloudWatch demandes doivent être signées à l'aide de votre identifiant de clé d'accès et de votre clé d'accès secrète.

Type : String

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 AWS_CREDENTIAL_FILE, si elle est définie.

-C, --ec2-cert-file-path VALUE

Emplacement de votre fichier de EC2 certificat pour les demandes de signature. Vous pouvez utiliser la variable d'environnement EC2_CERT pour spécifier cette valeur.

Type : String

Valeurs valides : chemin de fichier valide vers le fichier PEM fourni par Amazon EC2 ou AWS Identity and Access Management.

Par défaut : utilise la variable d'environnement EC2_CERT, si elle est définie.

--connection-timeout VALUE

Valeur d'expiration de la connexion, en secondes.

Type : entier

Valeurs valides : tout nombre positif.

Valeur par défaut : 30

--delimiter VALUE

Le délimiteur à utiliser lors de l'affichage des résultats délimités (longs).

Type : String

Valeurs valides : toute chaîne.

Par défaut : virgule (,)

--headers

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 --headers est désactivée par défaut.

-I, --access-key-id VALUE

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 elles sont rejetées.

Type : String

Valeurs valides : un identifiant de clé d'accès valide.

Par défaut : aucun

-K, --ec2-private-key-file-path VALUE

La clé privée utilisée pour signer la demande. L'utilisation de clés publiques/privées 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 EC2_CERT, sinon la valeur est ignorée. La valeur de la variable d'environnement EC2_PRIVATE_KEY sera utilisée si elle est définie, et cette option n'est pas spécifiée. Cette option est ignorée si la variable d'environnement AWS_CREDENTIAL_FILE est définie, ou si --aws-credentials-file est utilisé. Toutes les demandes CloudWatch doivent être signées, sinon elles sont rejetées.

Type : String

Valeurs valides : chemin d'accès à une clé privée ASN.1 valide.

Par défaut : aucun

--region VALUE

Les demandes de région sont dirigées vers. Vous pouvez utiliser la variable d'environnement EC2_REGION pour spécifier la valeur. La région est utilisée pour créer l'URL utilisée pour appeler CloudWatch et doit être une région Amazon Web Services (AWS) valide.

Type : String

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 EC2_REGION est définie.

S, --secret-key VALUE

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 --access-key-id, sinon cette option est ignorée.

Type : String

Valeurs valides : votre identifiant de clé d'accès.

Par défaut : aucun

--show-empty-fields

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.

--show-request

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

--show-table, --show-long, --show-xml, --quiet

Spécifie comment les résultats sont affichés : dans une table, délimités (long), XML ou sans sortie (silencieux). L'affichage --show-table montre un sous-ensemble des données sous forme de largeur de colonne fixe ; --show-long montre toutes les valeurs renvoyées délimitées par un caractère ; --show-xml est le rendement brut du service et --quiet supprime toutes les sorties standard. Toutes les options sont mutuellement exclusives, avec la priorité --show-table, --show-long, --show-xml, et --quiet.

Type : indicateur

Valeurs valides : aucune

Par défaut : --show-table

-U, --url VALUE

URL utilisée pour contacter CloudWatch. Vous pouvez définir cette valeur à l'aide de la variable d'environnement AWS_CLOUDWATCH_URL. Cette valeur est utilisée conjointement avec --region pour créer l'URL attendue. Cette option remplace l'URL de l'appel de service.

Type : String

Valeurs valides : une URL HTTP ou HTTPS valide.

Par défaut : utilise la valeur spécifiée dans AWS_CLOUDWATCH_URL, si elle est définie.

Sortie

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 les erreurs sur stderr.

Exemples

Exemple de demande

Cet exemple renvoie l'utilisation moyenne, minimale et maximale du processeur pour l' EC2instance i-c07704a9, à une résolution d'une 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 indique l'utilisation du processeur dans l'ensemble de votre EC2 flotte.

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 demandes adressées à la pile de tests MyService pour un utilisateur donné, à 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 les RequestCount 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 en relation

Téléchargement

Action connexe

Commandes connexes