mon-describe-alarm-history

Descrizione

Recupera la cronologia per l'allarme specificato. Puoi filtrare allarmi per intervallo di date o tipo di elemento. Se non specifichi un nome per gli allarmi, Amazon CloudWatch restituisce la cronologia di tutti gli allarmi.

Nota

Amazon CloudWatch conserva la cronologia degli allarmi attivi ed eliminati per due settimane.

Sintassi

mon-describe-alarm-history [AlarmNames [AlarmNames ...]] [--end-date value] [--history-item-type value] [--start-date value] [Common Options]

Opzioni

Nome	Descrizione
AlarmName AlarmNames	I nomi degli allarmi, separati da spazi. Se non specifichi un nome di allarme, questo comando restituisce le cronologie di tutti gli allarmi. Puoi anche impostare questo valore utilizzando --alarm-name. Tipo: argomento Valori validi: qualsiasi stringa di lunghezza compresa tra 1 e 255 caratteri. Impostazione predefinita: n/d Campo obbligatorio: no
--end-date VALUE	La fine dell'intervallo di date per la cronologia. Tipo: data Valori validi: data in formato AAAA-MM-GG. Impostazione predefinita: data corrente. Campo obbligatorio: no
--history-item-type VALUE	Il tipo di elementi della cronologia da recuperare Per impostazione predefinita, vengono restituiti tutti i tipi. Tipo: enumerazione Valori validi: ConfigurationUpdate StateUpdate, o Action Impostazione predefinita: vengono restituiti tutti i tipi. Campo obbligatorio: no
--start-date VALUE	L'inizio dell'intervallo di date per la cronologia. Per impostazione predefinita si estende a tutta la cronologia disponibile. Tipo: data Valori validi: data in formato AAAA-MM-GG. Impostazione predefinita: tutta la cronologia disponibile. Campo obbligatorio: no

Opzioni comuni

Nome	Descrizione
--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: 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	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: stringa Valori validi: un percorso di file valido per il file PEM fornito da Amazon AWS Identity and Access Management EC2 o. Impostazione predefinita: utilizza la variabile di ambiente EC2_CERT, se impostata.
--connection-timeout VALUE	Il valore del tempo di connessione (in secondi). Tipo: integer 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'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 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 respinta. ▬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:

• ALARM – Il nome dell'allarme.

• TIMESTAMP - Il timestamp.

• TIPO: il tipo di evento, uno di ConfigurationUpdate StateUpdate e l'azione.

• SUMMARY – Un riepilogo leggibile di evento cronologia.

• DATA – I dati dettagliati relativi all'evento in formato JSON leggibile dal computer. Questa colonna appare solo nella visualizzazione -show-long.

L'Amazon CloudWatch CLI mostra gli errori su stderr.

Esempi

Richiesta di esempio

Questo esempio descrive tutti gli elementi della cronologia per l'allarme my-alarm.

mon-describe-alarm-history--alarm-name my-alarm --headers

Questo è un esempio di output di questo comando.

ALARM     TIMESTAMP                 TYPE                 SUMMARY
my-alarm  2013-05-07T18:46:16.121Z  Action               Published a notification to arn:aws:sns:...
my-alarm  2013-05-07T18:46:16.118Z  StateUpdate          Alarm updated from INSUFFICIENT_DATA to OK
my-alarm  2013-05-07T18:46:07.362Z  ConfigurationUpdate  Alarm "my-alarm" created

Argomenti correlati

Scarica

• Impostazione dell'interfaccia a riga di comando

Operazione correlata

• DescribeAlarmHistory

Comandi correlati

• mon-describe-alarms

• mon-describe-alarms-for-metrico