Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
mon-put-data
Descrizione
Aggiunge punti dati del parametro al parametro specificato. Questa chiamata inserirà dati delle serie temporali, per il valore non elaborato o valori statistici validi di un determinato nome parametro. Supporta l'inserimento di un singolo punto dati alla volta.
Nota
Quando creai un nuovo parametro utilizzando il comando mon-put-data
, possono essere necessari fino a due minuti prima di poter recuperare le statistiche sul nuovo parametro tramite il comando mon-get-stats
. Tuttavia, possono essere necessari fino a 15 minuti prima che il nuovo parametro venga visualizzato nell'elenco di parametri recuperati tramite il comando mon-list-metrics
.
Sintassi
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]
Opzioni
Nome | Descrizione |
---|---|
-d, --dimensions "key1=value1,key2=value2..." |
Le dimensioni che identificano in modo univoco i dati del parametro. Puoi specificare le dimensioni in due modi e i formati possono essere combinati o utilizzati in modo intercambiabile:
Tipo: Map Valori validi: una stringa di formato nome=valore, in cui la chiave è il nome della dimensione e il valore è il valore della dimensione. I nomi di dimensione e i valori devono essere una stringa ANSI di lunghezza compresa tra 1 e 250 caratteri. Sono consentite un numero massimo di 10 dimensioni. Impostazione predefinita: n/d Campo obbligatorio: no |
|
Nome del parametro. Tipo: stringa Valori validi: qualsiasi nome parametro valido compreso tra 1 e 250 caratteri. Impostazione predefinita: n/d Campo obbligatorio: sì |
|
Namespace del parametro. Per ulteriori informazioni sugli spazi dei nomi, consulta Spazi dei nomi AWS. Tipo: stringa Valori validi: una stringa ANSI di lunghezza compresa tra 1 e 250 caratteri. Impostazione predefinita: n/d Campo obbligatorio: sì |
|
Le statistiche da archiviare per il timestamp e il parametro specificati. Questa opzione è esclusa con Tipo: Map Valori validi: una stringa contenente tutti i valori doppi per tutti i nomi statistici: Sum SampleCount, Maximum e Minimum. Tutti questi valori devono essere compresi tra 1E-130 e 1E130. Impostazione predefinita: n/d Campo obbligatorio: sì |
|
Il timestamp del punto dati o dell'osservazione per il parametro da registrare. I timestamp vengono specificati utilizzando il formato combinato ISO86 01. Ad esempio, la data e l'ora 30 luglio 2013 alle 12:30:00 PST vengono rappresentati come 2013-07-30T12:30:00-07:00 o in UTC: 2013-07-30T19:30:00Z. Tipo: semplice Valori validi: un timestamp valido rappresentato in formato ISO86 01 con offset del fuso orario o indicatore UTC. Default: l'ora UTC corrente. Campo obbligatorio: no |
|
L'unità per il parametro. Tipo: enumerazione Valori validi: uno dei seguenti:
Impostazione predefinita: n/d Campo obbligatorio: no |
|
Un singolo valore da registrare. Il valore viene tradotto in un set di statistiche nel formato: SampleCount =1, sum=value, minimum=value, maximum=value. Questa opzione è esclusiva di Tipo: semplice Valori validi: tutti i valori devono essere un numero compreso tra 1E-130 e 1E130. Impostazione predefinita: n/d Campo obbligatorio: sì |
Opzioni comuni
Nome | Descrizione |
---|---|
|
La posizione del AWS file con le tue credenziali. È possibile impostare questo valore utilizzando la variabile di ambiente Tipo: stringa Valori validi: un percorso valido di un file contenente l'ID chiave di accesso e la chiave di accesso segreta. Impostazione predefinita: utilizza la variabile di ambiente |
|
La posizione del file di EC2 certificato per la firma delle richieste. Puoi usare la variabile di ambiente Tipo: stringa Valori validi: un percorso di file valido per il file PEM fornito da Amazon EC2 o AWS Identity and Access Management. Impostazione predefinita: utilizza la variabile di ambiente |
|
Il valore del tempo di connessione (in secondi). Tipo: integer Valori validi: qualsiasi numero positivo. Impostazione predefinita: 30 |
|
Il delimitatore da utilizzare quando si visualizzano risultati (lunghi) delimitati. Tipo: stringa Valori validi: qualsiasi stringa. Impostazione predefinita: virgola (,) |
|
Se si visualizzano risultati tabulari o delimitati, includere le intestazioni di colonna. Se si visualizzano risultati in XML, restituire le intestazioni HTTP dalla richiesta di servizio, se applicabile. Tipo: flag Valori validi: quando presenti, mostra le intestazioni. Impostazione predefinita: l'opzione |
|
L'ID chiave di accesso che verrà utilizzato insieme alla chiave segreta per firmare la richiesta. Questo deve essere utilizzato insieme alla chiave segreta, altrimenti l'opzione viene ignorata. Tutte le richieste CloudWatch devono essere firmate, altrimenti la richiesta viene rifiutata. Tipo: stringa Valori validi: un ID chiave di accesso valido. Impostazione predefinita: nessuna |
|
La chiave privata che verrà utilizzata per firmare la richiesta. L'utilizzo di chiavi pubbliche/private fa sì che la CLI utilizzi SOAP. La richiesta viene firmata con un certificato pubblico e una chiave privata. Questo parametro deve essere utilizzato in combinazione con Tipo: stringa Valori validi: il percorso di una chiave privata ASN.1 valida. Impostazione predefinita: nessuna |
|
La regione a cui sono indirizzate le richieste. Per specificare il valore è possibile utilizzare la variabile di ambiente Tipo: stringa Valori validi: qualsiasi AWS regione, ad esempio us-east-1. Impostazione predefinita: us-east-1, a meno che non sia impostata la variabile |
|
La chiave di accesso segreta che verrà utilizzata insieme all'ID chiave di accesso per firmare la richiesta. Questo parametro deve essere utilizzato in combinazione con Tipo: stringa Valori validi: l'ID chiave di accesso. Impostazione predefinita: nessuna |
|
Mostra i campi vuoti utilizzando (nullo) come placeholder per indicare che questi dati non sono stati richiesti. Tipo: flag Valori validi: None Impostazione predefinita: i campi vuoti non vengono mostrati per impostazione predefinita. |
|
Visualizza l'URL utilizzato dalla CLI per chiamare AWS. Tipo: flag Valori validi: None Impostazione predefinita: false |
|
Specifica la modalità di visualizzazione dei risultati: in tabella, delimitati (lungo), XML o nessun output (silenzio). Tipo: flag Valori validi: None Impostazione predefinita: |
|
L'URL utilizzato per contattare. CloudWatch È possibile impostare questo valore utilizzando la variabile di ambiente Tipo: stringa Valori validi: un URL HTTP o HTTPS valido. Impostazione predefinita: utilizza il valore specificato in |
Output
Questo comando aggiunge punti dati del parametro a un parametro.
L'Amazon CloudWatch CLI mostra gli errori su stderr.
Esempi
Richiesta di esempio
Questo esempio inserisce dati delle statistiche per RequestCount
nello spazio dei nomi MyService
. La metrica non contiene dimensioni e rappresenta quindi il valore complessivo dell' RequestCountintero servizio. La misura è un statisticValue pre-aggregato che rappresenta cinque misure precedenti il cui massimo era 70, il cui minimo era 30 e la cui somma era 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"
Richiesta di esempio
Questo esempio inserisce dati di test RequestCount
specifici dell'utente nello spazio dei nomi MyService
. L'utente e il nome dello stack vengono archiviati come dimensioni per distinguere questo parametro dal parametro a livello di servizio dell'esempio precedente.
mon-put-data --metric-name RequestCount --namespace "MyService" --dimensions "User=SomeUser,Stack=Test" --timestamp 2013-11-25T00:00:00.000Z --value 50