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-get-stats
## Description
Ottiene i dati delle serie temporali per le statistiche specificate.
**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-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] **
## Opzioni
| Nome | Description |
| --- | --- |
| `MetricName` | Nome del parametro. Puoi anche impostare questo valore utilizzando `--metric-name`. Tipo: argomento Valori validi: qualsiasi nome parametro valido compreso tra 1 e 255 caratteri. Impostazione predefinita: n/d Campo obbligatorio: sì |
| `--dimensions` `"key1=value1,key2=value2..." ` | Le dimensioni del parametro. Puoi specificare le dimensioni in due modi e i formati possono essere combinati o utilizzati in modo intercambiabile: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/cli/cli-mon-get-stats.html) 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 |
| `--end-time` `VALUE` | L'ultimo timestamp consentito per i punti dati restituiti. L'ora di fine è esclusa. 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. La risoluzione massima restituibile CloudWatch è 1 minuto, pertanto tutti i timestamp vengono arrotondati per difetto al minuto più vicino. Tipo: argomento Valori validi: un timestamp valido rappresentato in formato ISO86 01 con offset del fuso orario o indicatore UTC. Default: data/ora correnti. Campo obbligatorio: no |
| `-n, --namespace` `VALUE` | Namespace del parametro. Per ulteriori informazioni sugli spazi dei nomi, consulta [Spazi dei nomi AWS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/aws-namespaces.html). Tipo: stringa Valori validi: uno spazio dei nomi valido di lunghezza compresa tra 1 e 250 caratteri. Impostazione predefinita: n/d Campo obbligatorio: sì |
| `--period` `VALUE` | La granularità, in secondi, di recupero delle statistiche. Il periodo deve essere di almeno 60 secondi ed essere un multiplo di 60. Tipo: argomento Valori validi: un numero, in secondi, che è un multiplo di 60 secondi. Default: 60 secondi. Campo obbligatorio: no |
| `-s, --statistics` `VALUE1,VALUE2,VALUE3...` | Le statistiche che devono essere restituite per il parametro specificato. Tipo: enumerazione Valori validi: Average, Sum, Maximum o Minimum Impostazione predefinita: n/d Campo obbligatorio: sì |
| `--start-time` `VALUE` | Il primo timestamp consentito per i punti dati restituiti. L'ora di inizio è inclusa. I timestamp vengono specificati utilizzando il formato combinato 01. ISO86 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. La risoluzione massima restituibile CloudWatch è 1 minuto, pertanto tutti i timestamp vengono arrotondati per difetto al minuto più vicino. Tipo: argomento Valori validi: un timestamp valido rappresentato in formato ISO86 01 con offset del fuso orario o indicatore UTC. Default: un'ora prima dell'ora corrente. Campo obbligatorio: no |
| `--unit` `VALUE` | L'unità per cui recuperare i parametri. I parametri possono essere riportati in più unità; questo consente di recuperare un'unità specifica per un determinato parametro. La mancata richiesta di un'unità comporta la restituzione di tutte le unità. Se il parametro viene sempre riportato solo con un'unica unità, non avrà alcun effetto. Tipo: enumerazione Valori validi: uno dei seguenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonCloudWatch/latest/cli/cli-mon-get-stats.html) Impostazione predefinita: n/d Campo obbligatorio: no |
## Opzioni comuni
| Nome | Description |
| --- | --- |
| `--aws-credential-file` `VALUE` | La posizione del file con le tue credenziali. AWS È possibile impostare questo valore utilizzando la variabile di ambiente `AWS_CREDENTIAL_FILE`. Se si definisce la variabile di ambiente o si specifica il percorso del file delle credenziali, il file deve esistere o la richiesta avrà esito negativo. Tutte le CloudWatch richieste devono essere firmate utilizzando l'ID della chiave di accesso e la chiave di accesso segreta. 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 `AWS_CREDENTIAL_FILE`, se impostata. |
| `-C, --ec2-cert-file-path` `VALUE` | La posizione del file di EC2 certificato per la firma delle richieste. Puoi usare la variabile di ambiente `EC2_CERT` per specificare questo valore. 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 `EC2_CERT`, se impostata. |
| `--connection-timeout` `VALUE` | Il valore del tempo di connessione (in secondi). Tipo: numero intero Valori validi: qualsiasi numero positivo. Impostazione predefinita: 30 |
| `--delimiter` `VALUE` | Il delimitatore da utilizzare quando si visualizzano risultati (lunghi) delimitati. Tipo: stringa Valori validi: qualsiasi stringa. Impostazione predefinita: virgola (,) |
| `--headers` `` | 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 `--headers` è disattivata per impostazione predefinita. |
| `-I, --access-key-id` `VALUE` | 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 |
| `-K, --ec2-private-key-file-path` `VALUE` | La chiave privata che verrà utilizzata per firmare la richiesta. L'uso public/private delle chiavi 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 `EC2_CERT`, altrimenti il valore viene ignorato. Il valore della variabile di ambiente `EC2_PRIVATE_KEY` verrà utilizzato se è impostata e questa opzione non è specificata. Questa opzione viene ignorata se la variabile di ambiente `AWS_CREDENTIAL_FILE` è impostata, oppure viene utilizzato il `--aws-credentials-file`. Tutte le richieste CloudWatch devono essere firmate, altrimenti la richiesta viene rifiutata. Tipo: stringa Valori validi: il percorso di una chiave privata ASN.1 valida. Impostazione predefinita: nessuna |
| `--region` `VALUE` | La regione a cui sono indirizzate le richieste. Per specificare il valore è possibile utilizzare la variabile di ambiente `EC2_REGION`. La regione viene utilizzata per creare l'URL utilizzato per la chiamata CloudWatch e deve essere una regione Amazon Web Services (AWS) valida. 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 `EC2_REGION`. |
| `S, --secret-key` `VALUE` | 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 `--access-key-id`, altrimenti l'opzione viene ignorata. Tipo: stringa Valori validi: l'ID chiave di accesso. Impostazione predefinita: nessuna |
| `--show-empty-fields` `` | 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. |
| `--show-request` `` | Visualizza l'URL utilizzato dalla CLI per chiamare AWS. Tipo: flag Valori validi: None Impostazione predefinita: false |
| `--show-table, --show-long, --show-xml, --quiet` `` | Specifica la modalità di visualizzazione dei risultati: in tabella, delimitati (lungo), XML o nessun output (silenzio). `--show-table` mostra un sottoinsieme dei dati sotto forma di colonna a larghezza fissa; `--show-long` mostra tutti i valori restituiti delimitati da un carattere; `--show-xml` è il risultato grezzo restituito dal servizio; e `--quiet` sopprime tutti gli output standard. Tutte le opzioni si escludono a vicenda, con la priorità a `--show-table`, `--show-long`, `--show-xml` e `--quiet`. Tipo: flag Valori validi: None Impostazione predefinita: `--show-table` |
| `-U, --url` `VALUE` | L'URL utilizzato per contattare. CloudWatch È possibile impostare questo valore utilizzando la variabile di ambiente `AWS_CLOUDWATCH_URL`. Questo valore viene utilizzato in combinazione con `--region` per creare l'URL previsto. Questa opzione sostituisce l'URL della chiamata di servizio. Tipo: stringa Valori validi: un URL HTTP o HTTPS valido. Impostazione predefinita: utilizza il valore specificato in `AWS_CLOUDWATCH_URL`, se impostato. |
## Output
Questo comando restituisce una tabella contenente quanto segue:
+ Ora – L'ora in cui sono stati presi i parametri.
+ SampleCount - Nessuna descrizione disponibile per questa colonna.
+ Media – Il valore medio.
+ Somma – La somma di valori.
+ Minimo – Il valore minimo osservato.
+ Massimo – Il valore massimo osservato.
+ Unità – L'unità del parametro.
L'Amazon CloudWatch CLI mostra gli errori su stderr.
## Esempi
### Richiesta di esempio
Questo esempio restituisce l'utilizzo medio, minimo e massimo della CPU, ad EC2 esempio i-c07704a9, con una risoluzione di 1 ora.
```
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"
```
Questo è un esempio di output dei parametri Samples e Average alla risoluzione di un minuto.
```
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
...
```
### Richiesta di esempio
Questo esempio restituisce l'utilizzo della CPU in tutto il parco macchine. 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"
```
### Richiesta di esempio
Questo esempio restituisce il numero medio, minimo e massimo di richieste inviate allo stack di test di MyService un determinato utente, con una risoluzione di 1 ora.
```
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"
```
### Richiesta di esempio
Questo esempio mostra RequestCount le statistiche relative a tutto "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"
```
## Argomenti correlati
### Scarica
+ [Impostazione dell'interfaccia a riga di comando](SetupCLI.md)
### Operazione correlata
+ [GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)
### Comandi correlati
+ [mon-list-metrics](cli-mon-list-metrics.md)
+ [mon-describe-alarms](cli-mon-describe-alarms.md)