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

# Configurare gli avvisi
<a name="v10-alerting-configure"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)  
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)

Configura le funzionalità e le integrazioni di cui hai bisogno per creare e gestire i tuoi avvisi.

**Topics**
+ [Configura le regole di avviso gestite da Grafana](v10-alerting-configure-grafanamanaged.md)
+ [Configurazione delle regole di avviso gestite dall'origine dati](v10-alerting-configure-datasourcemanaged.md)
+ [Configurare le regole di registrazione](v10-alerting-configure-recordingrules.md)
+ [Configurare i punti di contatto](v10-alerting-configure-contactpoints.md)
+ [Configurazione delle politiche di notifica](v10-alerting-configure-notification-policies.md)

# Configura le regole di avviso gestite da Grafana
<a name="v10-alerting-configure-grafanamanaged"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)  
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)

Le regole gestite da Grafana sono il tipo di regola di avviso più flessibile. Ti consentono di creare avvisi che possono agire sui dati provenienti da qualsiasi delle nostre fonti di dati supportate. Oltre a supportare più fonti di dati, puoi anche aggiungere espressioni per trasformare i dati e impostare condizioni di avviso. È supportato anche l'utilizzo di immagini nelle notifiche di avviso. Questo è l'unico tipo di regola che consente l'invio di avvisi da più fonti di dati in un'unica definizione di regola.

È possibile creare più istanze di avviso come risultato di un'unica regola di avviso (nota anche come avviso multidimensionale).

Le regole di avviso gestite da Grafana possono essere modificate o eliminate solo dagli utenti con autorizzazioni di modifica per la cartella in cui sono archiviate le regole.

Se elimini una risorsa di avviso creata nell'interfaccia utente, non puoi più recuperarla. Per eseguire un backup della configurazione e poter ripristinare le risorse di avviso eliminate, crea le risorse di avviso utilizzando Terraform o l'API Alerting.

Nelle seguenti procedure, esamineremo il processo di creazione delle regole di avviso gestite da Grafana.

Per creare una regola di avviso gestita da Grafana, utilizza il flusso di creazione degli avvisi in-workspace e segui questi passaggi per aiutarti.

**Imposta il nome della regola di avviso**

1. Scegli **Avvisi** -> **Regole di avviso** -> **\$1 Nuova regola di avviso**.

1. Inserisci un nome per identificare la tua regola di avviso.

   Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'`alertname`etichetta per ogni istanza di avviso creata da questa regola.

Quindi, definisci una query per ottenere i dati che desideri misurare e una condizione da soddisfare prima che venga attivata una regola di avviso.

**Per definire l'interrogazione e la condizione**

1. Seleziona una fonte di dati.

1. Dal menu a discesa **Opzioni**, specifica un [intervallo di tempo](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range).
**Nota**  
Grafana Alerting supporta solo intervalli di tempo relativi fissi, ad esempio. `now-24hr: now`  
Non supporta intervalli di tempo assoluti: `2021-12-02 00:00:00 to 2021-12-05 23:59:592` o intervalli di tempo semi-relativi:. `now/d to: now`

1. Aggiungi una query.

   Per aggiungere più [interrogazioni](v10-panels-query-xform.md#v10-panels-query-xform-add), scegli **Aggiungi interrogazione**.

   Tutte le regole di avviso sono gestite da Grafana per impostazione predefinita. Se desideri passare a una regola di avviso gestita dall'origine dati, fai clic su **Passa a una regola di avviso gestita dall'origine dati**.

1. [Aggiungi una o più espressioni.](v10-panels-query-xform-expressions.md)

   1. Per ogni espressione, seleziona una **condizione classica** per creare una singola regola di avviso oppure scegli tra le opzioni **Math**, **Reduce** e **Resample** per generare un avviso separato per ogni serie.
**Nota**  
Quando si utilizza Prometheus, è possibile utilizzare un vettore istantaneo e funzioni integrate, quindi non è necessario aggiungere espressioni aggiuntive.

   1. Scegliete **Anteprima** per verificare che l'espressione abbia esito positivo.

1. [Facoltativo] Per aggiungere una soglia di ripristino, attiva l'opzione **Soglia di ripristino personalizzata** e inserisci un valore per indicare quando la regola di avviso deve smettere di funzionare.

   È possibile aggiungere solo una soglia di ripristino in una query e deve essere la condizione di avviso.

1. Scegli **Imposta come condizione di avviso** sulla query o sull'espressione che desideri impostare come condizione di avviso.

Utilizza la valutazione delle regole di avviso per determinare la frequenza con cui una regola di avviso deve essere valutata e la velocità con cui deve cambiare il suo stato.

A tale scopo, è necessario assicurarsi che la regola di avviso rientri nel gruppo di valutazione corretto e impostare un periodo di attesa più adatto al caso d'uso.

**Per impostare il comportamento di valutazione degli avvisi**

1. Seleziona una cartella o scegli **\$1 Nuova cartella**.

1. Seleziona un gruppo di valutazione o fai clic su **\$1 Nuovo gruppo di valutazione**.

   Se state creando un nuovo gruppo di valutazione, specificate l'intervallo per il gruppo.

   Tutte le regole all'interno dello stesso gruppo vengono valutate contemporaneamente nello stesso intervallo di tempo.

1. Inserisci un periodo in sospeso.

   Il periodo in sospeso è il periodo in cui una regola di avviso può violare la condizione finché non viene attivata.

   **Una volta soddisfatta una condizione, l'avviso passa allo stato In sospeso.** **Se la condizione rimane attiva per la durata specificata, l'avviso passa allo stato **Attivo**, altrimenti torna allo stato Normale.**

1. Attiva le notifiche di avviso di pausa, se necessario.
**Nota**  
Metti in pausa la valutazione delle regole di avviso per evitare allarmi rumorosi durante l'ottimizzazione degli avvisi. La pausa interrompe la valutazione delle regole di avviso e non crea alcuna istanza di avviso. Ciò è diverso dagli orari di silenziamento, che impediscono l'invio delle notifiche, ma consentono comunque la valutazione delle regole di avviso e la creazione di istanze di avviso.  
È possibile sospendere la valutazione delle regole di avviso per evitare allarmi rumorosi durante l'ottimizzazione degli avvisi. La pausa interrompe la valutazione delle regole di avviso e non crea alcuna istanza di avviso. Ciò è diverso dagli orari di silenziamento, che impediscono l'invio delle notifiche, ma consentono comunque la valutazione delle regole di avviso e la creazione di istanze di avviso.

1. In **Configure no data and error handling**, configura il comportamento di avviso in assenza di dati.

   Utilizza le linee guida riportate più avanti in questa sezione.

Aggiungi etichette alle regole di avviso per impostare quale politica di notifica deve gestire le istanze di allarme di licenziamento.

Tutte le regole e le istanze di avviso, indipendentemente dalle relative etichette, corrispondono alla politica di notifica predefinita. Se non ci sono politiche nidificate o nessuna politica nidificata corrisponde alle etichette nella regola di avviso o nell'istanza di avviso, la politica di notifica predefinita è la politica corrispondente.

**Per configurare le notifiche**

1. Aggiungi etichette se desideri modificare il modo in cui vengono instradate le notifiche.

   Aggiungi etichette personalizzate selezionando le coppie chiave-valore esistenti dal menu a discesa oppure aggiungi nuove etichette inserendo la nuova chiave o il nuovo valore.

1. Visualizza l'anteprima della configurazione del routing delle istanze di avviso.

   In base alle etichette aggiunte, le istanze di avviso vengono indirizzate alle politiche di notifica visualizzate.

   Espandi ogni politica di notifica per visualizzare ulteriori dettagli.

1. Scegli **Visualizza dettagli** per visualizzare i dettagli sul routing degli avvisi e un'anteprima.

Aggiungi [annotazioni](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) per fornire più contesto sull'avviso nel tuo messaggio di notifica di avviso.

Le annotazioni aggiungono metadati per fornire ulteriori informazioni sull'avviso nel messaggio di notifica di avviso. Ad esempio, aggiungi un'annotazione di **riepilogo** per indicare quale valore ha causato l'attivazione dell'avviso o su quale server è avvenuto.

**Per aggiungere annotazioni**

1. [Facoltativo] Aggiungi un riepilogo.

   Breve riassunto di quello che è successo e perché.

1. [Facoltativo] Aggiungi una descrizione.

   Descrizione del funzionamento della regola di avviso.

1. [Facoltativo] Aggiungi un URL del Runbook.

   Pagina web in cui conservi il runbook per l'avviso

1. [Facoltativo] Aggiungi un'annotazione personalizzata

1. [Facoltativo] Aggiungi un link alla dashboard e al pannello.

   Collega gli avvisi ai pannelli di una dashboard.

1. Scegli **Salva regola**.

**Regola singola e multidimensionale**

Per gli avvisi gestiti da Grafana, puoi creare una regola con una condizione classica oppure puoi creare una regola multidimensionale.
+ **Regola con condizione classica**

  Usa l'espressione di condizione classica per creare una regola che attiva un singolo avviso quando viene soddisfatta la relativa condizione. Per una query che restituisce più serie, Grafana non tiene traccia dello stato di avviso di ciascuna serie. Di conseguenza, Grafana invia un solo avviso anche quando le condizioni di allarme sono soddisfatte per più serie.
+ **Regola multidimensionale**

  Per generare un avviso separato per ogni serie, crea una regola multidimensionale. Usa `Math``Reduce`, o `Resample` espressioni per creare una regola multidimensionale. Esempio:
  + Aggiungi un'`Reduce`espressione per ogni query per aggregare i valori nell'intervallo di tempo selezionato in un unico valore (non necessario per [le regole che utilizzano dati numerici)](v10-alerting-overview-numeric.md).
  + Aggiungi un'`Math`espressione con la condizione per la regola. Non necessario nel caso in cui una query o un'espressione di riduzione restituisca già `0` se la regola non deve attivarsi o un numero positivo se deve attivarsi. Alcuni esempi: `$B > 70` se dovesse attivarsi nel caso in cui il valore di B query/expression sia superiore a 70. `$B < $C * 100`nel caso in cui si attivasse se il valore di B è inferiore al valore di C moltiplicato per 100. Se le query confrontate hanno più serie nei risultati, le serie di query diverse vengono abbinate se hanno le stesse etichette o una è un sottoinsieme dell'altra.

**Nota**  
Grafana non supporta le interrogazioni di avviso con variabili modello. Ulteriori informazioni sono disponibili all'indirizzo [https://comtemplate-variables-are-notmunity.grafana.com/t/](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) - - /2514. supported-in-alert-queries while-setting-up-alert

**Nessuna configurazione per la gestione dei dati e degli errori**

Configura il comportamento di avviso quando la valutazione della regola di avviso non restituisce dati o restituisce errori.

**Nota**  
Le regole di avviso configurate per essere attivate quando una valutazione non restituisce dati o errori vengono attivate solo al termine dell'intera durata del periodo di valutazione. **Ciò significa che anziché essere attivata immediatamente quando viene violata la condizione della regola di avviso, la regola di avviso attende il termine del periodo impostato come campo For e quindi viene attivata, riducendo il rumore di avviso e consentendo problemi temporanei di disponibilità dei dati.**

Se la valutazione della regola di avviso non restituisce dati, è possibile impostare lo stato della regola di avviso in modo che appaia come segue:


| Nessun dato | Description | 
| --- | --- | 
| Nessun dato | Crea un nuovo avviso DatasourceNoData con il nome e l'UID della regola di avviso e l'UID dell'origine dati che non ha restituito dati come etichette. | 
| Avviso | Imposta lo stato della regola di avviso su. Alerting La regola di avviso attende il termine del tempo impostato nel campo For prima di essere attivata. | 
| Ok | Imposta lo stato della regola di avviso su. Normal | 

Se la valutazione restituisce un errore, puoi impostare lo stato della regola di avviso in modo che appaia come segue:


| Errore | Description | 
| --- | --- | 
| Errore | Crea un'istanza di avviso DatasourceError con il nome e l'UID della regola di avviso e l'UID dell'origine dati che non ha restituito dati come etichette. | 
| Avviso | Imposta lo stato della regola di avviso su. Alerting La regola di avviso attende il termine del tempo impostato nel campo For prima di essere attivata. | 
| Ok | Imposta lo stato della regola di avviso su. Normal | 

**Risolve le istanze di avviso obsolete**

Un'istanza di avviso è considerata obsoleta se la sua dimensione o serie è scomparsa completamente dai risultati della query per due intervalli di valutazione.

Le istanze di avviso non aggiornate che si trovano negli `Error` stati`Alerting`/`NoData`/vengono contrassegnate automaticamente come `Resolved` e l'`grafana_state_reason`annotazione viene aggiunta all'istanza di avviso con il motivo. `MissingSeries`

**Crea avvisi dai pannelli**

Crea avvisi da qualsiasi tipo di pannello. Ciò significa che puoi riutilizzare le interrogazioni nel pannello e creare avvisi basati su di esse.

1. **Accedi a una dashboard nella sezione Dashboard.**

1. Nell'angolo in alto a destra del pannello, scegli i tre punti (ellissi).

1. **Dal menu a discesa, seleziona **Altro...**, quindi scegli Nuova regola di avviso.**

Si aprirà il modulo delle regole di avviso, che ti consentirà di configurare e creare l'avviso in base alla query del pannello corrente.

# Configurazione delle regole di avviso gestite dall'origine dati
<a name="v10-alerting-configure-datasourcemanaged"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)  
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)

Crea regole di avviso per un'istanza Grafana Mimir o Loki esterna con l'API dei righelli abilitata; queste sono chiamate regole di avviso gestite dall'origine dei dati.

**Nota**  
Le regole di avviso per un'istanza Grafana Mimir o Loki esterna possono essere modificate o eliminate dagli utenti con ruoli di Editor o Amministratore.  
Se elimini una risorsa di avviso creata nell'interfaccia utente, non puoi più recuperarla. Per eseguire un backup della configurazione e poter ripristinare le risorse di avviso eliminate, crea le risorse di avviso utilizzando Terraform o l'API Alerting.

**Prerequisiti**
+ Verifica di disporre dell'autorizzazione di scrittura per l'origine dati Prometheus o Loki. In caso contrario, non sarà possibile creare o aggiornare le regole di avviso gestite di Grafana Mimir.
+ Per le sorgenti dati Grafana Mimir e Loki, abilita l'API Ruler configurando i rispettivi servizi.
  + **Loki** - Il tipo di archiviazione delle `local` regole, predefinito per l'origine dati Loki, supporta solo la visualizzazione delle regole. Per modificare le regole, configura uno degli altri tipi di archiviazione delle regole.
  + **Grafana Mimir**: usa il prefisso. `/prometheus` [https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) Non è possibile fornire un URL separato per l'API Ruler.

**Nota**  
**Se non desideri gestire le regole di avviso per una particolare origine dati Loki o Prometheus, vai alle relative impostazioni e deseleziona la casella di controllo Gestisci avvisi tramite interfaccia utente di avviso.**

Nelle seguenti procedure, ti guideremo attraverso il processo di creazione delle regole di avviso gestite dalle origini dati.

Per creare una regola di avviso gestita dall'origine dati, utilizza il flusso di creazione di avvisi in-workspace e segui questi passaggi per aiutarti.

**Per impostare il nome della regola di avviso**

1. Scegli **Avvisi** -> **Regole di avviso** -> **\$1 Nuova regola di avviso**.

1. Inserisci un nome per identificare la tua regola di avviso.

   Questo nome viene visualizzato nell'elenco delle regole di avviso. È anche l'`alertname`etichetta per ogni istanza di avviso creata da questa regola.

Definisci una query per ottenere i dati che desideri misurare e una condizione da soddisfare prima che venga attivata una regola di avviso.

**Per definire l'interrogazione e la condizione**

1. Tutte le regole di avviso sono gestite da Grafana per impostazione predefinita. Per passare a una regola di avviso gestita dall'origine dati, scegli **Passa a una regola di avviso gestita dall'origine dati**.

1. Seleziona una fonte di dati dall'elenco a discesa.

   Puoi anche scegliere **Apri selettore avanzato di sorgenti dati** per visualizzare altre opzioni, inclusa l'aggiunta di un'origine dati (solo amministratori).

1. Inserisci una query PromQL o LogQL.

1. Scegli **Anteprima** avvisi.

Utilizza la valutazione delle regole di avviso per determinare la frequenza con cui una regola di avviso deve essere valutata e la velocità con cui deve cambiare il suo stato.

**Per impostare il comportamento di valutazione degli avvisi**

1. Seleziona uno spazio dei nomi o scegli **\$1 Nuovo** spazio dei nomi.

1. Seleziona un gruppo di valutazione o scegli **\$1** Nuovo gruppo di valutazione.

   Se state creando un nuovo gruppo di valutazione, specificate l'intervallo per il gruppo.

   Tutte le regole all'interno dello stesso gruppo vengono valutate in sequenza nello stesso intervallo di tempo.

1. Inserisci un periodo in sospeso.

   Il periodo in sospeso è il periodo in cui una regola di avviso può violare la condizione finché non viene attivata.

   Una volta soddisfatta una condizione, l'avviso entra nello stato. `Pending` Se la condizione rimane attiva per la durata specificata, l'avviso passa allo `Firing` stato, altrimenti torna allo `Normal` stato.

Aggiungi etichette alle regole di avviso per impostare quale politica di notifica deve gestire le istanze di allarme di licenziamento.

Tutte le regole e le istanze di avviso, indipendentemente dalle relative etichette, corrispondono alla politica di notifica predefinita. Se non ci sono politiche nidificate o nessuna politica nidificata corrisponde alle etichette nella regola di avviso o nell'istanza di avviso, la politica di notifica predefinita è la politica corrispondente.

**Per configurare le notifiche**
+ Aggiungi etichette se desideri modificare il modo in cui vengono instradate le notifiche.

  Aggiungi etichette personalizzate selezionando le coppie chiave-valore esistenti dal menu a discesa oppure aggiungi nuove etichette inserendo la nuova chiave o il nuovo valore.

Aggiungi [annotazioni](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations) per fornire più contesto all'avviso nelle notifiche di avviso.

Le annotazioni aggiungono metadati per fornire ulteriori informazioni sull'avviso nelle notifiche di avviso. Ad esempio, aggiungi un'`Summary`annotazione per indicare quale valore ha causato l'attivazione dell'avviso o su quale server è avvenuto.

**Per aggiungere annotazioni**

1. [Facoltativo] Aggiungi un riepilogo.

   Breve riassunto di quello che è successo e perché.

1. [Facoltativo] Aggiungi una descrizione.

   Descrizione del funzionamento della regola di avviso.

1. [Facoltativo] Aggiungi un URL del Runbook.

   Pagina web in cui conservi il runbook per l'avviso

1. [Opzionale] Aggiungi un'annotazione personalizzata

1. [Facoltativo] Aggiungi un link alla dashboard e al pannello.

   Collega gli avvisi ai pannelli di una dashboard.

1. Scegli **Salva regola**.

# Configurare le regole di registrazione
<a name="v10-alerting-configure-recordingrules"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)  
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)

È possibile creare e gestire regole di registrazione per un'istanza Grafana Mimir o Loki esterna. Le regole di registrazione calcolano in anticipo le espressioni più richieste o quelle più dispendiose dal punto di vista computazionale e salvano il risultato come una nuova serie temporale. L'interrogazione di questa nuova serie temporale è più veloce, soprattutto per le dashboard, poiché interrogano la stessa espressione ogni volta che le dashboard si aggiornano.

**Nota**  
Le regole di registrazione vengono eseguite come regole di istanza e vengono eseguite ogni 10 secondi.

**Prerequisiti**
+ Verifica di disporre delle autorizzazioni di scrittura per l'origine dati Prometheus o Loki. Creerai o aggiornerai le regole di avviso nella tua fonte di dati.
+ Per le sorgenti dati Grafana Mimir e Loki, abilita l'API ruler configurando i rispettivi servizi.
  + **Loki** — Il tipo di archiviazione delle `local` regole, predefinito per l'origine dati Loki, supporta solo la visualizzazione delle regole. Per modificare le regole, configura uno degli altri tipi di archiviazione.
  + **Grafana Mimir** — Usa il prefisso. `/prometheus` L'origine dati Prometheus supporta sia Grafana Mimir che Prometheus e Grafana prevede che sia l'API Query che l'API Ruler si trovino nello stesso URL. Non è possibile fornire un URL separato per l'API Ruler.

**Nota**  
**Se non desideri gestire le regole di avviso per una particolare origine dati Loki o Prometheus, vai alle relative impostazioni e deseleziona la casella di controllo Gestisci avvisi tramite interfaccia utente di avviso.**

**Per creare regole di registrazione**

1. **Dalla console Grafana, nel menu Grafana, scegli **Avvisi, Regole di avviso**.**

1. Scegli **Nuova** regola di registrazione.

1. Imposta il nome della regola.

   Il nome della regola di registrazione deve essere un nome metrico di Prometheus e non contenere spazi bianchi.

1. Definisci l'interrogazione
   + Seleziona la tua fonte di dati Loki o Prometheus.
   + Inserisci una query.

1. Aggiungi namespace e gruppo.
   + Dal menu a discesa **Namespace**, seleziona uno spazio dei nomi di regole esistente o aggiungine uno nuovo. I namespace possono contenere uno o più gruppi di regole e avere solo uno scopo organizzativo.
   + Dal menu a discesa **Gruppo**, seleziona un gruppo esistente all'interno del namespace selezionato o aggiungine uno nuovo. Le regole appena create vengono aggiunte alla fine del gruppo. Le regole all'interno di un gruppo vengono eseguite in sequenza a intervalli regolari, con lo stesso tempo di valutazione.

1. Aggiungi etichette.
   + Aggiungi etichette personalizzate selezionando le coppie chiave-valore esistenti dal menu a discesa o aggiungi nuove etichette inserendo la nuova chiave o il nuovo valore.

1. Scegli **Salva regola** per salvare la regola o **Salva regola ed esci** per salvare la regola e tornare alla pagina Avvisi.

# Configurare i punti di contatto
<a name="v10-alerting-configure-contactpoints"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)  
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)

Utilizza i punti di contatto per definire in che modo i tuoi contatti vengono avvisati quando viene attivata una regola di avviso.

**Nota**  
Puoi creare e modificare punti di contatto per gli avvisi gestiti da Grafana. I punti di contatto per gli avvisi gestiti dall'origine dati sono di sola lettura.

## Lavorare con i punti di contatto
<a name="v10-alerting-configure-contactpoints-working"></a>

Le seguenti procedure mostrano come aggiungere, modificare, eliminare e testare un punto di contatto.

**Per aggiungere un punto di contatto**

1. **Nel menu a sinistra, scegli Avvisi.**

1. **Scegli Punti di contatto.**

1. Dal menu a discesa **Scegli Alertmanager**, seleziona un Alertmanager. Il Grafana Alertmanager è selezionato per impostazione predefinita.

1. Nella scheda **Punti di contatto**, scegli **\$1 Aggiungi** punto di contatto.

1. Inserisci un **nome** per il punto di contatto.

1. Da **Integrazione**, scegli un tipo e compila i campi obbligatori in base a quel tipo. Ad esempio, se scegli Slack, inserisci i canali Slack e gli utenti che devono essere contattati.

1. Se disponibile per il punto di contatto selezionato, scegli le **impostazioni opzionali desiderate per specificare impostazioni** aggiuntive.

1. In **Impostazioni di notifica**, seleziona facoltativamente **Disabilita messaggio risolto** se non desideri ricevere una notifica quando si risolve un avviso.

1. Per aggiungere un'altra integrazione con i punti di contatto, scegli **Aggiungi integrazione con i punti di contatto** e ripeti i passaggi per ogni tipo di punto di contatto necessario.

1. Salvare le modifiche.

**Per modificare un punto di contatto**

1. **Nel menu a sinistra, scegli Avvisi.**

1. Scegli **Punti di contatto** per visualizzare un elenco di punti di contatto esistenti.

1. Seleziona il punto di contatto da modificare, quindi scegli **Modifica**.

1. Aggiorna il punto di contatto, quindi salva le modifiche.

È possibile eliminare i punti di contatto che non sono utilizzati in base a una politica di notifica.

**Per eliminare un punto di contatto**

1. **Nel menu a sinistra, scegli Avvisi.**

1. Scegli **Punti di contatto** per aprire l'elenco dei punti di contatto esistenti.

1. In **Punti di contatto**, seleziona il punto di contatto da eliminare, quindi scegli **Altro**, **Elimina**.

1. Nella finestra di dialogo di conferma, scegli **Sì, elimina**.

**Nota**  
Se il punto di contatto è utilizzato in base a una politica di notifica, è necessario eliminare la politica di notifica o modificarla per utilizzare un punto di contatto diverso prima di eliminare il punto di contatto.

Dopo aver creato il punto di contatto, puoi inviare una notifica di prova per verificare che sia configurato correttamente.

**Per inviare una notifica di prova**

1. **Nel menu a sinistra, scegli Avvisi.**

1. Scegli **Punti di contatto** per aprire l'elenco dei punti di contatto esistenti.

1. In **Punti di contatto**, seleziona il punto di contatto da testare, quindi scegli **Modifica**. Se necessario, puoi anche creare un nuovo punto di contatto.

1. Scegli **Test** per aprire la finestra di dialogo per il test dei punti di contatto.

1. Scegli se inviare una notifica di test predefinita o scegli **Personalizzato** per aggiungere annotazioni ed etichette personalizzate nella notifica di test.

1. Scegli **Invia notifica di test** per testare l'avviso con i punti di contatto indicati.

## Configura le integrazioni dei punti di contatto
<a name="v10-alerting-configure-contactpoints-integration"></a>

Configura le integrazioni dei punti di contatto in Grafana per selezionare il tuo canale di comunicazione preferito per ricevere notifiche quando le tue regole di avviso sono attive. Ogni integrazione ha le proprie opzioni di configurazione e il proprio processo di configurazione. Nella maggior parte dei casi, ciò comporta la fornitura di una chiave API o di un URL Webhook.

Una volta configurato, puoi utilizzare le integrazioni come parte dei tuoi punti di contatto per ricevere notifiche ogni volta che l'avviso cambia stato. In questa sezione, illustreremo i passaggi di base per configurare un'integrazione, ad esempio, in modo da poter iniziare a ricevere avvisi in tempo reale e rimanere aggiornato sui dati di monitoraggio. PagerDuty 

**Elenco delle integrazioni supportate**

La tabella seguente elenca i tipi di punti di contatto supportati da Grafana.


| Name | Tipo | 
| --- | --- | 
| Amazon SNS | `sns` | 
| OpsGenie | `opsgenie` | 
| Pager Duty | `pagerduty` | 
| Slack | `slack` | 
| VictorOps | `victorops` | 

**Configurazione PagerDuty per gli avvisi**

Per eseguire la configurazione PagerDuty, è necessario fornire una chiave di integrazione. Fornisci i seguenti dettagli.


| Impostazione | Description | 
| --- | --- | 
| Chiave di integrazione | Chiave di integrazione per PagerDuty | 
| Gravità | Livello per notifiche dinamiche. Il valore predefinito è “critical”. | 
| Dettagli personalizzati | Dettagli aggiuntivi sull'evento | 

Il `CustomDetails` campo è un oggetto contenente coppie chiave-valore arbitrarie. I dettagli definiti dall'utente vengono uniti a quelli utilizzati di default.

I valori predefiniti per `CustomDetails` sono:

```
{
	"firing":       `{{ template "__text_alert_list" .Alerts.Firing }}`,
	"resolved":     `{{ template "__text_alert_list" .Alerts.Resolved }}`,
	"num_firing":   `{{ .Alerts.Firing | len }}`,
	"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```

In caso di chiavi duplicate, i dettagli definiti dall'utente sovrascrivono quelli predefiniti.

# Configurazione delle politiche di notifica
<a name="v10-alerting-configure-notification-policies"></a>

****  
**Questo argomento della documentazione è progettato per le aree di lavoro Grafana che supportano la versione 10.x di Grafana.**  
Per le aree di lavoro Grafana che supportano la versione 9.x di Grafana, vedere. [Lavorare nella versione 9 di Grafana](using-grafana-v9.md)  
Per le aree di lavoro Grafana che supportano la versione 8.x di Grafana, vedere. [Funzionamento in Grafana versione 8](using-grafana-v8.md)

Le politiche di notifica determinano il modo in cui gli avvisi vengono indirizzati ai punti di contatto.

Le politiche hanno una struttura ad albero, in cui ciascuna politica può avere una o più politiche annidate. Ogni politica, ad eccezione della politica predefinita, può anche corrispondere a etichette di avviso specifiche.

Ogni avviso viene valutato in base alla politica predefinita e successivamente in base a ciascuna politica annidata.

Se abiliti l'`Continue matching subsequent sibling nodes`opzione per una politica annidata, la valutazione continua anche dopo una o più corrispondenze. Le impostazioni di configurazione e le informazioni sui punti di contatto di una politica principale regolano il comportamento di un avviso che non corrisponde a nessuna delle politiche secondarie. Un criterio predefinito regola qualsiasi avviso che non corrisponde a un criterio annidato.

Per ulteriori informazioni sulle politiche di notifica, vedere. [Notifications](v10-alerting-explore-notifications.md)

Le seguenti procedure mostrano come creare e gestire le politiche di notifica.

**Per modificare la politica di notifica predefinita**

1. **Nel menu a sinistra, scegli Avvisi.**

1. **Scegli Politiche di notifica.**

1. Dal menu a discesa **Scegli Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. **Nella sezione Politica **predefinita, scegli**...** , **Modifica**.

1. In **Punto di contatto predefinito**, aggiorna il punto di contatto a cui devono essere inviate le notifiche relative alle regole quando le regole di avviso non corrispondono a nessuna politica specifica.

1. In **Raggruppa per**, scegli le etichette in base alle quali raggruppare gli avvisi. Se per questa politica corrispondono più avvisi, questi vengono raggruppati in base a queste etichette. Viene inviata una notifica per gruppo. Se il campo è vuoto (impostazione predefinita), tutte le notifiche vengono inviate in un unico gruppo. Utilizza un'etichetta speciale `...` per raggruppare gli avvisi in base a tutte le etichette (il che di fatto disabilita il raggruppamento).

1. Nelle **opzioni di temporizzazione, seleziona una delle seguenti opzioni**.
   + **Attesa di gruppo**: tempo necessario per memorizzare nel buffer gli avvisi dello stesso gruppo prima di inviare una notifica iniziale. Il valore predefinito è 30 secondi.
   + Intervallo di **gruppo: intervallo** di tempo minimo tra due notifiche per un gruppo. Il valore predefinito è 5 minuti.
   + Intervallo di **ripetizione: intervallo** di tempo minimo prima di inviare nuovamente una notifica se non sono stati aggiunti nuovi avvisi al gruppo. L'impostazione predefinita è 4 ore.

1. Scegli **Salva** per salvare le modifiche.

Per creare una nuova politica di notifica, è necessario seguirne la struttura ad albero. Le nuove politiche create sul tronco dell'albero (la politica predefinita) sono i rami degli alberi. Ogni ramo può avere le proprie politiche annidate. Questo è il motivo per cui aggiungerai sempre una nuova politica **annidata**, in base alla politica predefinita o in base a una politica già annidata.

**Per aggiungere una nuova politica annidata**

1. **Nel menu a sinistra, scegli Avvisi.**

1. **Scegli Politiche di notifica.**

1. Dal menu a discesa **Scegli Alertmanager**, seleziona il gestore degli avvisi che desideri modificare.

1. **Per aggiungere una politica specifica di primo livello, vai alla sezione Routing specifico (alla politica predefinita o a un'altra politica esistente in cui desideri aggiungere una nuova politica annidata) e scegli \$1 Nuova politica nidificata.**

1. Nella sezione delle etichette corrispondenti, aggiungi una o più regole per abbinare le etichette degli avvisi.

1. Nel menu a discesa **Punto di contatto**, seleziona il punto di contatto a cui inviare notifiche se un avviso corrisponde solo a questa politica specifica e non a nessuna delle politiche annidate.

1. Facoltativamente, abilita **Continua ad abbinare i nodi di pari livello successivi** per continuare a far corrispondere le politiche di pari livello anche dopo che l'avviso corrisponde alla politica corrente. Quando questa opzione è abilitata, puoi ricevere più di una notifica per ogni avviso.

1. Facoltativamente, abilita il **raggruppamento Override** per specificare lo stesso raggruppamento della politica predefinita. Se l'opzione non è abilitata, viene utilizzato il raggruppamento di criteri predefinito.

1. Facoltativamente, abilita **Ignora gli orari generali per sovrascrivere le** opzioni di temporizzazione configurate nella politica di notifica di gruppo.

1. Scegli **Salva** per salvare le modifiche.

**Per modificare una politica annidata**

1. **Nel menu a sinistra, scegli Avvisi.**

1. **Scegli Politiche di notifica.**

1. Seleziona la politica che desideri modificare, quindi scegli**...** , **Modifica**.

1. Apporta eventuali modifiche (come quando aggiungi una politica annidata).

1. Salvare le modifiche.

**Ricerca di politiche**

Puoi cercare nell'albero delle politiche per *Label Matchers* o per *punti di contatto*.
+ Per effettuare la ricerca per punto di contatto, inserisci un nome parziale o completo di un punto di contatto nel campo **Cerca per punto di contatto**. Le politiche che utilizzano quel punto di contatto verranno evidenziate nell'interfaccia utente.
+ Per effettuare la ricerca per etichetta, inserisci un abbinatore di etichette valido nel campo di immissione **Cerca per abbinatori**. È possibile inserire più abbinatori, separati da una virgola. Ad esempio, un input matcher valido potrebbe essere. `severity=high, region=~EMEA|NA`
**Nota**  
Durante la ricerca per etichetta, tutte le politiche corrispondenti corrisponderanno esattamente. Le corrispondenze parziali e le corrispondenze in stile regex non sono supportate.