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
Description
Crea o aggiorna un avviso 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 StateValue appropriato. Tutte le azioni associate al 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 | Description |
|---|---|
|
|
Il nome dell'allarme da aggiornare o creare. Il nome deve essere univoco all'interno del tuo AWS account. Puoi anche impostare questo valore utilizzando Tipo: argomento Valori validi: una UTF-8 stringa. Predefinito: n/a Obbligatorio: sì |
|
|
Indica se le operazioni devono essere eseguite quando lo stato dell'allarme cambia. Tipo: Booleano Valori validi: True o False Impostazione predefinita: True Obbligatorio: no |
|
|
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 un argomento Amazon SNS, attivare una policy Amazon EC2 Auto Scaling o arrestare, terminare o ripristinare un'istanza di Amazon EC2. NotaSe utilizzi un account AWS Identity and Access Management (IAM) per creare o modificare un allarme, devi disporre delle seguenti autorizzazioni Amazon EC2:
Se disponi read/write delle autorizzazioni per Amazon CloudWatch ma non per Amazon EC2, puoi comunque creare un allarme ma le azioni di arresto o terminazione non verranno eseguite sull'istanza Amazon EC2. Tuttavia, se successivamente riceverai l'autorizzazione per utilizzare le API Amazon EC2, le operazioni di allarme create in precedenza verranno eseguite. Per ulteriori informazioni generali sulle autorizzazioni IAM, consulta la sezione relativa ad autorizzazioni e policy nella Guida per l'utente di IAM. Se stai utilizzando un ruolo IAM (ad esempio, un'profilo dell'istanza Amazon EC2), non puoi arrestare né terminare l'istanza utilizzando operazioni di allarme. Tuttavia, puoi ancora visualizzare lo stato dell'allarme ed eseguire qualsiasi altra operazione, come le notifiche Amazon SNS o le policy Amazon EC2 Auto Scaling. Se utilizzi credenziali di sicurezza temporanee concesse utilizzando Servizio di token di sicurezza AWS (AWS STS), non puoi interrompere o terminare un'istanza Amazon EC2 utilizzando azioni di allarme. Tipo: String Valori validi: un ARN per un argomento Amazon SNS, una policy di Auto Scaling o un ARN per arrestare, terminare o ripristinare un'istanza Amazon EC2. Predefinito: n/a Obbligatorio: no |
|
|
La descrizione dell'allarme. Tipo: String Valori validi: qualsiasi stringa Unicode con lunghezza compresa tra 1 e 255 caratteri. Predefinito: n/a Obbligatorio: no |
|
|
L'operatore di confronto utilizzato per paragonare un punto dati alla soglia. Tipo: enumerazione Valori validi: uno tra GreaterThanOrEqualToThreshold GreaterThanThreshold, LessThanThreshold, o LessThanOrEqualToThreshold Predefinito: n/a Obbligatorio: sì |
|
|
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:
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 |
|
|
Il numero di periodi consecutivi per i quali il valore del parametro viene paragonato alla soglia per determinare lo stato dell'allarme. Tipo: numero intero Valori validi: un numero maggiore di zero. Predefinito: n/a Obbligatorio: sì |
|
|
Il nome del parametro su cui attivare l'allarme. Tipo: argomento Valori validi: una stringa ANSI di lunghezza compresa tra 1 e 250 caratteri. Predefinito: n/a Obbligatorio: sì |
|
|
Lo spazio dei nomi del parametro su cui attivare l'allarme. Per ulteriori informazioni sugli spazi dei nomi, consulta Spazi dei nomi AWS. Tipo: String Valori validi: una stringa ANSI di lunghezza compresa tra 1 e 250 caratteri. Predefinito: n/a Obbligatorio: sì |
|
|
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: String Valori validi: un identificatore ARN valido. Predefinito: n/a Obbligatorio: no |
|
|
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. Predefinito: n/a Obbligatorio: sì |
|
|
Le statistiche del parametro su cui attivare l'allarme. Tipo: enumerazione Valori validi: Media SampleCount, Somma, Minimo o Massimo Predefinito: n/a Obbligatorio: è necessario specificare --statistic o --extendedstatistic. |
|
|
Le statistiche dei percentili su cui attivare l'allarme. Tipo: String Valori validi: qualsiasi percentile, fino a due posizioni decimali (ad esempio, p95.45). Predefinito: n/a Obbligatorio: è necessario specificare --statistic o --extendedstatistic. |
|
|
La soglia con cui vengono confrontati i punti dati per determinare lo stato dell'allarme. Tipo: numero a doppia precisione Valori validi: un valore doppio. Tutti i valori devono essere un numero compreso tra 1 E-130 e 1E130. Predefinito: n/a Obbligatorio: sì |
|
|
L'unità del parametro su cui attivare l'allarme. Tipo: enumerazione Valori validi: uno dei seguenti:
Predefinito: n/a Obbligatorio: no |
|
|
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: String Valori validi: un identificatore ARN valido. Predefinito: n/a Obbligatorio: no |
Opzioni comuni
| Nome | Description |
|---|---|
|
|
La posizione del file con le tue AWS credenziali. È possibile impostare questo valore utilizzando la variabile di ambiente 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 |
|
|
Il percorso del file di certificato EC2 per le richieste di firma. Puoi usare la variabile di ambiente 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 |
|
|
Il valore del tempo di connessione (in secondi). Tipo: numero intero Valori validi: qualsiasi numero positivo. Impostazione predefinita: 30 |
|
|
Il delimitatore da utilizzare quando si visualizzano risultati (lunghi) delimitati. Tipo: String 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: String Valori validi: un ID chiave di accesso valido. Impostazione predefinita: nessuna |
|
|
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 Tipo: String Valori validi: il percorso di una chiave ASN.1 privata valida. Impostazione predefinita: nessuna |
|
|
La regione a cui sono indirizzate le richieste. Per specificare il valore è possibile utilizzare la variabile di ambiente 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 |
|
|
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: String 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: String Valori validi: un URL HTTP o HTTPS valido. Impostazione predefinita: utilizza il valore specificato in |
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 consente di pubblicare un messaggio in un argomento quando l'utilizzo della CPU di un'istanza EC2 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
