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à.
Configurazione dei punti di contatto
Questo argomento della documentazione è progettato per gli spazi di lavoro Grafana che supportano la versione 10.x di Grafana.
Per gli spazi di lavoro Grafana che supportano la versione 12.x di Grafana, vedi. Funzionamento nella versione 12 di Grafana
Per gli spazi di lavoro di Grafana che supportano la versione 9.x di Grafana, vedi. Funzionamento in Grafana versione 9
Per gli spazi di lavoro Grafana che supportano la versione 8.x di Grafana, vedi. Funzionamento in Grafana versione 8
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 da fonti di dati sono di sola lettura.
Lavorare con i punti di contatto
Le procedure seguenti mostrano come aggiungere, modificare, eliminare e testare un punto di contatto.
Per aggiungere un punto di contatto
-
Nel menu a sinistra, scegli Avvisi.
-
Scegli Punti di contatto.
-
Dal menu a discesa Scegli Alertmanager, seleziona un Alertmanager. L'Alertmanager Grafana è selezionato per impostazione predefinita.
-
Nella scheda Punti di contatto, scegli + Aggiungi punto di contatto.
-
Inserisci un nome per il punto di contatto.
-
In 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.
-
Se disponibile per il punto di contatto selezionato, scegli le impostazioni opzionali desiderate per specificare le impostazioni aggiuntive.
-
In Impostazioni di notifica, seleziona facoltativamente Disabilita messaggio risolto se non desideri ricevere una notifica quando un avviso si risolve.
-
Per aggiungere un'altra integrazione con un punto di contatto, scegli Aggiungi integrazione con un punto di contatto e ripeti i passaggi per ogni tipo di punto di contatto necessario.
-
Salvare le modifiche.
Per modificare un punto di contatto
-
Nel menu a sinistra, scegli Avvisi.
-
Scegli Punti di contatto per visualizzare un elenco dei punti di contatto esistenti.
-
Seleziona il punto di contatto da modificare, quindi scegli Modifica.
-
Aggiorna il punto di contatto, quindi salva le modifiche.
È possibile eliminare i punti di contatto che non sono utilizzati da una politica di notifica.
Per eliminare un punto di contatto
-
Nel menu a sinistra, scegli Avvisi.
-
Scegli Punti di contatto per aprire l'elenco dei punti di contatto esistenti.
-
Nei Punti di contatto, seleziona il punto di contatto da eliminare, quindi scegli Altro, Elimina.
-
Nella finestra di dialogo di conferma, scegli Sì, elimina.
Nota
Se il punto di contatto è utilizzato da un criterio di notifica, è necessario eliminare il criterio di notifica o modificarlo per utilizzare un altro punto di contatto prima di eliminare il punto di contatto.
Dopo aver creato il punto di contatto, è possibile inviare una notifica di prova per verificare che sia configurato correttamente.
Per inviare una notifica di prova
-
Nel menu a sinistra, scegli Avvisi.
-
Scegli Punti di contatto per aprire l'elenco dei punti di contatto esistenti.
-
Nei Punti di contatto, seleziona il punto di contatto da testare, quindi scegli Modifica. Puoi anche creare un nuovo punto di contatto, se necessario.
-
Scegli Test per aprire la finestra di dialogo per il test del punto di contatto.
-
Scegli se inviare una notifica di test predefinita o scegli Personalizzata per aggiungere le tue annotazioni ed etichette personalizzate nella notifica di test.
-
Scegli Invia notifica di prova per testare l'avviso con i punti di contatto indicati.
Configura le integrazioni dei punti di contatto
Configura le integrazioni dei punti di contatto in Grafana per selezionare il canale di comunicazione preferito per ricevere notifiche quando le regole di avviso vengono attivate. 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, utilizzando PagerDuty come esempio, in modo da poter iniziare a ricevere avvisi in tempo reale e rimanere aggiornato sui dati di monitoraggio.
Elenco delle integrazioni supportate
La tabella seguente elenca i tipi di punti di contatto supportati da Grafana.
| Nome | Tipo |
|---|---|
Amazon SNS |
|
OpsGenie |
|
PagerDuty |
|
Slack |
|
VictorOps |
|
Configurazione PagerDuty per l'invio di avvisi
Per configurare 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 | Ulteriori dettagli 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.
