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-put-data
Description
Permet d'ajouter des points de données de métriques à la métrique spécifiée. Cette commande appelle des données en séries chronologiques, pour la valeur brute ou les valeurs statistiques valides d'une métrique donnée. Elle prend en charge l'entrée d'un seul point de données à la fois.
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-put-data --metric-name
value[--namespace value
[--dimensions
"key1=value1,key2=value2..."]
[--statisticValues
"key1=value1,key2=value2..."]
[--timestamp value] [--unit value]
[--value value] [Common Options]
Options
| Name (Nom) | Description |
|---|---|
|
-d, --dimensions "key1=value1,key2=value2..." |
Dimensions qui identifient de façon unique les données de métriques. 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 : S.o. Obligatoire : non |
|
|
Le nom de la métrique. Type : String Valeurs valides : tout nom de métrique valide comportant entre 1 et 250 caractères. Par défaut : S.o. Obligatoire : oui |
|
|
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 : une chaîne ANSI comportant entre 1 et 250 caractères. Par défaut : S.o. Obligatoire : oui |
|
|
Statistiques à stocker pour l'horodatage et la métrique spécifiés. Cette option est exclusive avec Type : carte Valeurs valides : chaîne contenant toutes les valeurs doubles pour tous les noms de statistiques : Sum SampleCount, Maximum et Minimum. Toutes ces valeurs doivent être comprises entre et 1E-130 et 1E130. Par défaut : S.o. Obligatoire : oui |
|
|
Horodatage du point de données ou observation de la métrique à enregistrer. 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. Type : simple Valeurs valides : horodatage valide représenté au format ISO86 01 avec décalage horaire ou indicateur UTC. Par défaut : heure UTC actuelle. Obligatoire : non |
|
|
Unité de la métrique. Type : énumération Valeurs valides : l'une des valeurs suivantes :
Par défaut : S.o. Obligatoire : non |
|
|
Une seule valeur à enregistrer. La valeur est convertie en un ensemble de statistiques de la forme : SampleCount =1, SUM=valeur, MINIMUM=valeur, maximum=valeur. Cette option est exclusive de Type : simple Valeurs valides : toutes les valeurs doivent être un nombre compris entre et 1E-130 et 1E130. Par défaut : S.o. Obligatoire : oui |
Options courantes
| Nom | Description |
|---|---|
|
|
L'emplacement du fichier contenant vos AWS informations d'identification. Vous pouvez définir cette valeur à l'aide de la variable d'environnement 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 |
|
|
Emplacement de votre fichier de EC2 certificat pour les demandes de signature. Vous pouvez utiliser la variable d'environnement 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 |
|
|
Valeur d'expiration de la connexion, en secondes. Type : entier 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 : String 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 elles sont rejetées. Type : String 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 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 Type : String Valeurs valides : chemin d'accès à une clé privée ASN.1 valide. Par défaut : aucun |
|
|
Les demandes de région sont dirigées vers. Vous pouvez utiliser la variable d'environnement 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 |
|
|
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 : String 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 contacter CloudWatch. Vous pouvez définir cette valeur à l'aide de la variable d'environnement Type : String Valeurs valides : une URL HTTP ou HTTPS valide. Par défaut : utilise la valeur spécifiée dans |
Sortie
Cette commande permet d'ajouter des points de données de métriques à une métrique.
L'Amazon CloudWatch CLI affiche les erreurs sur stderr.
Exemples
Exemple de demande
Cet exemple place les données statistiques de RequestCount dans l'espace de noms MyService. La métrique ne contient aucune dimension et représente donc l' RequestCountensemble du service. La mesure est une statisticValue regroupée au préalable représentant cinq mesures antérieures dont le maximum était de 70, le minimum de 30 et la somme de 250.
mon-put-data --metric-name RequestCount --namespace "MyService" --timestamp 2013-11-25T00:00:00.000Z --statisticValues "Sum=250,Minimum=30,Maximum=70,SampleCount=5"
Exemple de demande
Cet exemple place les données de test de RequestCount spécifiques à l'utilisateur dans l'espace de noms MyService. L'utilisateur et le nom de pile sont stockés en tant que dimensions afin de distinguer cette métrique de la métrique à l'échelle du service dans l'exemple ci-dessus.
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50
Rubriques en relation
Téléchargement
Action connexe
Commande connexe
