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
<a name="Create_PromQL_Alarm"></a>

È 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](alarm-promql.md)

## Creazione di un allarme PromQL utilizzando Console di gestione AWS
<a name="promql-alarm-create-console"></a>

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/](https://console.aws.amazon.com/cloudwatch/).

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

1. Scegli **Crea allarme**.

1. Scegli **PromQL** per il tipo di metrica.

1. In modalità **Editor**, inserisci la query PromQL:

   ```
   my_gauge_metric < 20
   ```

1. In **Conditions** (Condizioni), specifica quanto segue:
   + Per **Intervallo di valutazione**, scegliete**1 minute**, per definire la frequenza con cui viene valutata la query PromQL.
   + Per **Periodo in sospeso**, immettere**120**, la durata in secondi che un collaboratore deve violare prima di entrare nello stato ALARM.
   + Per **Periodo di recupero****300**, inserisci la durata in secondi che un collaboratore non deve violare prima di entrare nello stato OK.

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

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

1. Scegli **Next (Successivo)**.

1. Scegli **Crea allarme**.

## Creazione di un allarme ProMQL ()AWS CLI
<a name="promql-alarm-create-cli"></a>

Usa l'azione [PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)API per creare un allarme ProMQL.

**Example 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
```

**Example 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
```

**Example 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
<a name="promql-alarm-create-query-studio"></a>

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/](https://console.aws.amazon.com/cloudwatch/).

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

1. Seleziona **PromQL** dal menu a discesa del linguaggio di interrogazione.

1. 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
     ```

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

1. Scegli **Crea allarme** dal menu delle azioni.

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

1. In **Conditions** (Condizioni), specifica quanto segue:
   + Per **Intervallo di valutazione**, scegli**1 minute**, per definire la frequenza con cui viene valutata la query PromQL.
   + Per **Periodo in sospeso****60**, 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 ripristino****120**, 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.

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

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

1. Scegli **Next (Successivo)**.

1. 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 `sum``avg`, o `topk` per ridurre il risultato a una singola serie prima di creare l'allarme.