Creare un allarme utilizzando una query PromQL - Amazon CloudWatch
Creazione di un allarme PromQL utilizzando Console di gestione AWSCreazione di un allarme ProMQL ()AWS CLICreazione di un allarme ProMQL da Query Studio

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à.

Creare un allarme utilizzando una query PromQL

È possibile creare un CloudWatch allarme che utilizza una query istantanea PromQL per monitorare le metriche inserite tramite l'endpoint OTLP. CloudWatch Tutte le serie temporali corrispondenti restituite dalla query sono considerate violazioni e l'allarme tiene traccia di ogni serie temporale che viola come contributore. Per ulteriori informazioni sul funzionamento degli allarmi ProMQL, vedere. Allarmi ProMQL

Creazione di un allarme PromQL utilizzando Console di gestione AWS

Questo esempio mostra come creare un allarme che monitora una metrica dell'indicatore e avvisa l'utente quando il suo valore scende al di sotto di 20.

Per creare un allarme ProMQL

  1. Apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

  2. Nel pannello di navigazione, scegli Alarms (Allarmi), All Alarms (Tutti gli allarmi).

  3. Scegli Crea allarme.

  4. Scegli PromQL per il tipo di metrica.

  5. In modalità Editor, inserisci la query PromQL:

    my_gauge_metric < 20

  6. In Conditions (Condizioni), specifica quanto segue:

    • Per Intervallo di valutazione, scegliete1 minute, per definire la frequenza con cui viene valutata la query PromQL.

    • Per Periodo in sospeso, immettere120, la durata in secondi che un collaboratore deve violare prima di entrare nello stato ALARM.

    • Per Periodo di recupero300, inserisci la durata in secondi che un collaboratore non deve violare prima di entrare nello stato OK.

  7. Configura le notifiche e le operazioni in base alle tue necessità.

  8. Aggiungi un nome e una descrizione per l'allarme.

  9. Scegli Next (Successivo).

  10. Scegli Crea allarme.

Creazione di un allarme ProMQL ()AWS CLI

Usa l'azione PutMetricAlarmAPI per creare un allarme ProMQL.

Esempio Crea un allarme ProMQL che si attiva quando una metrica dell'indicatore scende al di sotto di 20
aws cloudwatch put-metric-alarm \
  --alarm-name MyPromQLAlarm \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20"}}' \
  --evaluation-interval 60
Esempio Crea un allarme PromQL con un periodo in sospeso

Questo allarme attende 300 secondi (5 minuti) prima di passare allo ALARM stato e attende 600 secondi (10 minuti) prima di riattivarsi.

aws cloudwatch put-metric-alarm \
  --alarm-name HighLatencyAlarm \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m])) > 0.5","PendingPeriod":300,"RecoveryPeriod":600}}' \
  --evaluation-interval 60
Esempio Crea un allarme PromQL con un'azione di notifica SNS
aws cloudwatch put-metric-alarm \
  --alarm-name MyPromQLAlarmWithAction \
  --evaluation-criteria '{"PromQLCriteria":{"Query":"my_gauge_metric < 20","PendingPeriod":0,"RecoveryPeriod":0}}' \
  --evaluation-interval 60 \
  --alarm-actions arn:aws:sns:us-east-1:123456789012:MyTopic

Creazione di un allarme ProMQL da Query Studio

Questo esempio mostra come creare un allarme PromQL da Query Studio che avvisa l'utente quando la durata media della richiesta HTTP per un servizio supera i 500 millisecondi.

A differenza degli CloudWatch allarmi standard in cui la soglia è configurata come un passaggio separato, gli allarmi PromQL definiscono la condizione di allarme (soglia) come parte della query stessa. Ad esempio, l'operatore di confronto (>) e il valore di soglia (0.5) sono incorporati direttamente nell'espressione PromQL.

Per creare un allarme ProMQL da Query Studio

  1. Apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

  2. Nel riquadro di navigazione sotto Metriche, scegli Query Studio (anteprima).

  3. Seleziona PromQL dal menu a discesa del linguaggio di interrogazione.

  4. Crea la tua query utilizzando una delle seguenti modalità:

    • In modalità Builder, selezionate il nome di una metrica dal campo Metrica (ad esempio,). http.server.request.duration Aggiungi filtri di etichette in base alle esigenze (ad esempio, @resource.service.name =). my-api Per definire la soglia di allarme, selezionate un'operazione di base (ad esempio,>) e immettete un numero (ad esempio,0.5).

    • In modalità Codice, inserisci direttamente l'espressione PromQL, ad esempio:

      histogram_avg({"http.server.request.duration", "@resource.service.name"="my-api"}) > 0.5

  5. Scegliete Esegui per eseguire la query e verificare che restituisca i risultati previsti.

  6. Scegli Crea allarme dal menu delle azioni.

  7. Verrai reindirizzato alla pagina di creazione dell' CloudWatch allarme con la tua query ProMQL precompilata.

  8. In Conditions (Condizioni), specifica quanto segue:

    • Per Intervallo di valutazione, scegli1 minute, per definire la frequenza con cui viene valutata la query PromQL.

    • Per Periodo in sospeso60, immettete la durata in secondi della quale la query deve essere violata prima di entrare nello stato ALARM. Ciò significa che la latenza deve superare la soglia per almeno 60 secondi prima che venga attivato l'allarme.

    • Per Periodo di ripristino120, immettere la durata in secondi della query prima di entrare nello stato OK. Ciò significa che la latenza deve rimanere al di sotto della soglia per almeno 120 secondi prima che l'allarme si riattivi.

  9. Configura le notifiche e le operazioni in base alle tue necessità.

  10. Aggiungi un nome e una descrizione per l'allarme.

  11. Scegli Next (Successivo).

  12. Scegli Crea allarme.

Nota

La query PromQL deve restituire una singola serie temporale per creare un allarme. Se la query restituisce più serie temporali, utilizza funzioni di aggregazione come sumavg, o topk per ridurre il risultato a una singola serie prima di creare l'allarme.