mon-put-metric-alarm - Amazon CloudWatch
DescrizioneSintassiOpzioniOpzioni 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-put-metric-alarm

Descrizione

Crea o aggiorna un allarme e lo associa alla metrica specificata CloudWatch . Puoi anche usare questo comando per associare una o più risorse di Amazon Simple Notification Service (Amazon SNS) a un allarme.

Quando questa operazione crea un allarme, lo stato dell'allarme è impostato immediatamente su INSUFFICIENT_DATA. L'allarme viene valutato e impostato in modo appropriato StateValue . Tutte le azioni associate a StateValue vengono quindi eseguite.

Nota

Quando si aggiorna un allarme esistente, StateValue rimane invariato.

Sintassi

mon-put-metric-alarm AlarmName --comparison-operator value --evaluation-periods value --metric-name value --namespace value --period value [--statistic value] [--extendedstatistic value] --threshold value [--actions-enabled value] [--alarm-actions value[,value...] ] [--alarm-description value] [--dimensions "key1=value1,key2=value2..."] [--ok-actions value[,value...] ] [--unit value] [--insufficient-data-actions value[,value...]] [Common Options]

Opzioni

Nome Descrizione

AlarmName

Il nome dell'allarme da aggiornare o creare. Il nome deve essere unico all'interno del tuo AWS account. Puoi anche impostare questo valore utilizzando --alarm-name.

Tipo: argomento

Valori validi: una stringa UTF-8.

Impostazione predefinita: n/d

Campo obbligatorio: sì

--actions-enabled VALUE

Indica se le operazioni devono essere eseguite quando lo stato dell'allarme cambia.

Tipo: Booleano

Valori validi: True o False

Impostazione predefinita: True

Campo obbligatorio: no

--alarm-actions VALUE1,VALUE2,VALUE3...

Le operazioni (fino a cinque) da eseguire quando questo allarme passa a uno stato ALARM da qualsiasi altro stato. Ogni operazione è specificata come Amazon Resource Name (ARN). Utilizzando le azioni di allarme, puoi pubblicare su un argomento di Amazon SNS, attivare una policy di Amazon EC2 Auto Scaling o interrompere, terminare o ripristinare un'istanza Amazon. EC2

Nota

Se utilizzi un account AWS Identity and Access Management (IAM) per creare o modificare un allarme, devi disporre delle seguenti EC2 autorizzazioni Amazon:

  • ec2:DescribeInstanceStatuse ec2:DescribeInstances per tutti gli allarmi sui parametri di stato delle EC2 istanze Amazon.

  • ec2:StopInstances per allarmi con operazioni di arresto.

  • ec2:TerminateInstances per allarmi con operazioni di terminazione.

  • ec2:DescribeInstanceRecoveryAttribute e ec2:RecoverInstances per allarmi con operazioni di recupero.

Se disponi delle autorizzazioni di lettura/scrittura per Amazon CloudWatch ma non per Amazon EC2, puoi comunque creare un allarme ma le azioni di interruzione o terminazione non verranno eseguite sull'istanza Amazon. EC2 Tuttavia, se successivamente ti viene concessa l'autorizzazione a utilizzare l'Amazon associato EC2 APIs, verranno eseguite le azioni di allarme che hai creato in precedenza. Per ulteriori informazioni generali sulle autorizzazioni IAM, consulta la sezione relativa ad autorizzazioni e policy nella Guida per l'utente di IAM.

Se utilizzi un ruolo IAM (ad esempio, un profilo di EC2 istanza Amazon), non puoi interrompere o terminare l'istanza utilizzando azioni di allarme. Tuttavia, puoi comunque visualizzare lo stato dell'allarme ed eseguire qualsiasi altra azione come le notifiche di Amazon SNS o le politiche di Amazon Auto EC2 Scaling.

Se utilizzi credenziali di sicurezza temporanee concesse tramite AWS Security Token Service (AWS STS), non puoi interrompere o terminare EC2 un'istanza Amazon utilizzando azioni di allarme.

Tipo: stringa

Valori validi: un ARN per un argomento di Amazon SNS, una policy di Auto Scaling o un ARN per interrompere, terminare o ripristinare un'istanza Amazon. EC2

Impostazione predefinita: n/d

Campo obbligatorio: no

--alarm-description VALUE

La descrizione dell'allarme.

Tipo: stringa

Valori validi: qualsiasi stringa Unicode con lunghezza compresa tra 1 e 255 caratteri.

Impostazione predefinita: n/d

Campo obbligatorio: no

--comparison-operator VALUE

L'operatore di confronto utilizzato per paragonare un punto dati alla soglia.

Tipo: enumerazione

Valori validi: uno tra,, o GreaterThanOrEqualToThreshold GreaterThanThreshold LessThanThreshold LessThanOrEqualToThreshold

Impostazione predefinita: n/d

Campo obbligatorio: sì

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

Le dimensioni del parametro per il quale si desidera creare un allarme. 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"

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

--evaluation-periods VALUE

Il numero di periodi consecutivi per i quali il valore del parametro viene paragonato alla soglia per determinare lo stato dell'allarme.

Tipo: integer

Valori validi: un numero maggiore di zero.

Impostazione predefinita: n/d

Campo obbligatorio: sì

--metric-name VALUE

Il nome del parametro su cui attivare l'allarme.

Tipo: argomento

Valori validi: una stringa ANSI di lunghezza compresa tra 1 e 250 caratteri.

Impostazione predefinita: n/d

Campo obbligatorio: sì

--namespace VALUE

Lo spazio dei nomi del parametro su cui attivare l'allarme. 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ì

--ok-actions VALUE1,VALUE2,VALUE3...

Le operazioni (fino a cinque) da eseguire quando questo allarme passa a uno stato OK da qualsiasi altro stato. Ogni operazione è specificata come Amazon Resource Name (ARN).

Tipo: stringa

Valori validi: un identificatore ARN valido.

Impostazione predefinita: n/d

Campo obbligatorio: no

--period VALUE

Il periodo di parametro su cui attivare l'allarme (in secondi).

Tipo: argomento

Valori validi: un numero, in secondi, che è un multiplo di 60 secondi.

Impostazione predefinita: n/d

Campo obbligatorio: sì

--statistic VALUE

Le statistiche del parametro su cui attivare l'allarme.

Tipo: enumerazione

Valori validi: SampleCount, Media, Somma, Minimo o Massimo

Impostazione predefinita: n/d

Obbligatorio: è necessario specificare --statistic o --extendedstatistic.

--extendedstatistic VALUE

Le statistiche dei percentili su cui attivare l'allarme.

Tipo: stringa

Valori validi: qualsiasi percentile, fino a due posizioni decimali (ad esempio, p95.45).

Impostazione predefinita: n/d

Obbligatorio: è necessario specificare --statistic o --extendedstatistic.

--threshold VALUE

La soglia con cui vengono confrontati i punti dati per determinare lo stato dell'allarme.

Tipo: double

Valori validi: un valore doppio. Tutti i valori devono essere un numero compreso tra 1E-130 e 1E130.

Impostazione predefinita: n/d

Campo obbligatorio: sì

--unit VALUE

L'unità del parametro su cui attivare l'allarme.

Tipo: enumerazione

Valori validi: uno dei seguenti:

  • Secondi

  • Microsecondi

  • Millisecondi

  • Byte

  • Kilobyte

  • Megabyte

  • Gigabyte

  • Terabyte

  • Bit

  • Kilobit

  • Megabit

  • Gigabit

  • Terabit

  • Percentuale

  • Conteggio

  • Byte/secondo

  • Kilobyte/secondo

  • Megabyte/secondo

  • Gigabyte/secondo

  • Terabyte/secondo

  • Bit/secondo

  • Kilobit/secondo

  • Megabit/secondo

  • Gigabit/secondo

  • Terabit/secondo

  • Numero/secondo

  • Nessuno

Impostazione predefinita: n/d

Campo obbligatorio: no

--insufficient-data-actions VALUE1,VALUE2,VALUE3...

Le operazioni (fino a cinque) da eseguire quando questo allarme passa a uno stato INSUFFICIENT_DATA da qualsiasi altro stato. Ogni operazione è specificata come Amazon Resource Name (ARN).

Tipo: stringa

Valori validi: un identificatore ARN valido.

Impostazione predefinita: n/d

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

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: 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 crea o aggiorna un allarme associato al parametro specificato.

L'Amazon CloudWatch CLI mostra gli errori su stderr.

Esempi

Richiesta di esempio

Questo esempio crea un allarme che pubblica un messaggio su un argomento quando l'utilizzo della CPU di un' EC2 istanza supera il 90% per tre periodi consecutivi di un minuto.

mon-put-metric-alarm --alarm-name my-alarm --alarm-description "some desc" \
--metric-name CPUUtilization --namespace AWS/EC2 --statistic Average  --period 60 --threshold 90 \
--comparison-operator GreaterThanThreshold  --dimensions InstanceId=i-abcdef --evaluation-periods 3  \
--unit Percent --alarm-actions arn:aws:sns:us-east-1:1234567890:my-topic

Argomenti correlati

Scarica

Operazione correlata

Comando correlato