View a markdown version of this page

mon-list-metrics - Amazon CloudWatch
DescriptionSintassiOpzioniOpzioni comuniOutputEsempiArgomenti correlati

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-list-metrics

Description

Elenca i nomi, gli spazi dei nomi e le dimensioni dei parametri associati all'account AWS . Puoi filtrare i parametri utilizzando qualsiasi combinazione di nome parametro, spazio dei nomi e dimensioni. Se non specifichi un filtro, vengono restituite tutte le corrispondenze possibili per l'attributo.

Nota

Il comando mon-list-metrics può richiedere fino a 15 minuti per segnalare nuovi nomi parametri, spazi dei nomi e dimensioni aggiunti da chiamate a mon-put-data. I punti dati inseriti da mon-put-data o da altri metodi saranno disponibili da mon-get-statistics in meno di cinque minuti.

Sintassi

mon-list-metrics [--dimensions "key1=value1,key2=value2..."] [--metric-name value] [--namespace value] [Common Options]

Opzioni

Nome Description

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

Le dimensioni del parametro da recuperare. Puoi specificare le dimensioni in due modi e i formati possono essere combinati o utilizzati in modo intercambiabile:

  • Un'opzione per dimensione: --dimensions "key1=value1" --dimensions "key2=value2"

  • Opzione tutto in uno: --dimensions "key1=value1,key2=value2"

Se non vengono specificate dimensioni, non verrà eseguito alcun filtro di dimensioni. Eventuali altri filtri richiesti verranno comunque applicati. Affinché venga incluso nel risultato, un parametro deve contenere tutte le dimensioni specificate, anche se il parametro potrebbe contenere dimensioni aggiuntive oltre i parametri richiesti.

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.

Predefinito: n/a

Obbligatorio: no

-m, --metric-name VALUE

Nome del parametro. Affinché venga incluso nei risultati, il nome parametro deve corrispondere esattamente al nome parametro richiesto. Se nessun nome parametro è specificato, non viene applicato alcun filtro. Eventuali altri filtri richiesti vengono applicati.

Tipo: semplice

Valori validi: qualsiasi nome parametro valido di lunghezza compresa tra 1 e 250 caratteri.

Predefinito: n/a

Obbligatorio: no

-n, --namespace VALUE

Lo spazio dei nomi da utilizzare per filtrare i parametri. Per ulteriori informazioni sugli spazi dei nomi, consulta Spazi dei nomi AWS.

Tipo: String

Valori validi: uno spazio dei nomi valido di lunghezza compresa tra 1 e 250 caratteri.

Predefinito: n/a

Obbligatorio: no

Opzioni comuni

Nome Description

--aws-credential-file VALUE

La posizione del file con le tue AWS credenziali. È 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: String

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

Il percorso del file di certificato EC2 per le richieste di firma. Puoi usare la variabile di ambiente EC2_CERT per specificare questo valore.

Tipo: String

Valori validi: un percorso 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: String

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: String

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: String

Valori validi: il percorso di una chiave ASN.1 privata 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: String

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: String

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: String

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:

  • Nome parametro – Il nome del parametro collegato a questo parametro.

  • Spazio dei nomi – Lo spazio dei nomi associato a questo parametro.

  • Dimensioni – I nomi e i valori di dimensione associati a questo parametro.

L'Amazon CloudWatch CLI mostra gli errori su stderr.

Esempi

Richiesta di esempio

Questo esempio restituisce un elenco di tutti i parametri.

mon-list-metrics

Questo è un esempio di output di una chiamata a 'mon-list-metrics'.

Metric Name                 Namespace  Dimensions
CPUUtilization               AWS/EC2    {InstanceId=i-e7e48a8e}
CPUUtilization               AWS/EC2    {InstanceId=i-231d744a}
CPUUtilization               AWS/EC2    {InstanceId=i-22016e4b}
CPUUtilization               AWS/EC2    {InstanceId=i-b0345cd9}
CPUUtilization               AWS/EC2    {InstanceId=i-539dff3a}
CPUUtilization               AWS/EC2    {InstanceId=i-af3544c6}
CPUUtilization               AWS/EC2    {InstanceId=i-d4f29ebd}
CPUUtilization               AWS/EC2    {ImageId=ami-de4daab7}
...

Richiesta di esempio

Questo esempio elenca i parametri con il nome specificato.

mon-list-metrics --metric-name RequestCount

Richiesta di esempio

Questo esempio elenca i parametri che appartengono allo spazio dei nomi specificato.

mon-list-metrics --namespace MyService

Richiesta di esempio

Questo esempio elenca i parametri con i nomi di dimensione e i valori specificati.

mon-list-metrics --dimensions "User=SomeUser,Stack=Test"

Argomenti correlati

Scarica

Operazione correlata

Comando correlato