Configurazione delle notifiche di monitoraggio

Ci sono diversi avvisi predefiniti nelle dashboard di monitoraggio. Quando un avviso cambia stato, invia delle notifiche. Per ricevere avvisi da Grafana, devi configurare un canale di notifica.

Grafana supporta vari tipi di notifiche (e-mail, Slack, webhook ecc.). Consulta la documentazione di Grafana per assistenza su ulteriori tipi di notifica.

Questo documento riguarda la configurazione di canali di notifica comuni come: e-mail, Slack, PagerDuty e webhook.

Prima di configurare una notifica, assicurati che i contenitori di monitoraggio siano attivi e in esecuzione.

E-mail

1. Configura le impostazioni SMTP nel file monitoring-compose.yml.

   services:
     ...
     grafana:
     ...
       environment:
         GF_SECURITY_ADMIN_PASSWORD: ${GF_SECURITY_ADMIN_PASSWORD:?Missing env GF_SECURITY_ADMIN_PASSWORD for Grafana admin password}
         WA_PROMETHEUS_ENDPOINT: ${WA_PROMETHEUS_ENDPOINT:-http://prometheus:9090}
         GF_SERVER_ROOT_URL: your-grafana-public-endpoint #(ex. https://foo.bar.com:3000)
         GF_SMTP_ENABLED: 1
         GF_SMTP_HOST: your-smtp-host #(ex. smtp.gmail.com:465)
         GF_SMTP_USER: your-smtp-auth-user #(ex. you@email.com)
         GF_SMTP_PASSWORD: your-smtp-auth-password
         GF_SMTP_SKIP_VERIFY: 1
       depends_on:
         - 'prometheus'
   

2. Riavvia Grafana.

   docker-compose -f monitoring-compose.yml up -d

3. Accedi a Notification channels (Canali di notifica) nel pannello Alerting (Avvisi).
   

   Canali di notifica
4. Inserisci il tuo indirizzo e-mail e verifica la configurazione cliccando sul pulsante Send Test (Invia test).
   

   Invio test
   Se la configurazione è stata eseguita correttamente, dovresti ricevere un'e-mail come questa:
   

   E-mail di Grafana
   In caso contrario, controlla i registri del contenitore Grafana per eseguire il debug.
5. Clicca su Save (Salva) per salvare la configurazione. A questo punto, riceverai avvisi da Grafana. Consulta la documentazione sulle notifiche e-mail di Grafana per maggiori dettagli.

Slack

1. Crea un'app Slack inserendo un nome (ad esempio, "avviso") e scegliendo uno spazio di lavoro dove installare l'app.
2. Clicca sul pulsante Incoming Webhooks (Webhook in ingresso) per aggiungere questa funzione alla tua app.
   

   Webhook in ingresso
3. Clicca sul pulsante Activate Incoming Webhooks (Attiva webhook in ingresso) per abilitarlo, quindi clicca su Add New Webhook to Workspace (Aggiungi nuovo webhook allo spazio di lavoro).
   

   Aggiunta di un nuovo webhook allo spazio di lavoro
4. Scegli un canale su cui l'app pubblicherà e clicca sul pulsante Authorize (Autorizza) per autorizzare la tua app.
5. Copia l'URL del webhook (ad es. https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX) per configurare la notifica di Slack in Grafana. Testa la tua configurazione cliccando sul pulsante Send Test (Invia test). Se la configurazione è stata eseguita correttamente, dovresti ricevere un messaggio sul canale configurato come questo:
   

   Notifica di Slack
   In caso contrario, controlla i registri del contenitore Grafana per eseguire il debug.
6. Clicca su Save (Salva) per salvare la configurazione. A questo punto, riceverai avvisi da Grafana. Per ulteriori informazioni, consulta la documentazione sulle notifiche di Slack.

PagerDuty

1. Aggiungi un nuovo servizio (ad es. https://XXXX.pagerduty.com/services/new) e seleziona Use our API directly (Utilizza direttamente la nostra API) come Integration Type (Tipo di integrazione).
   

   Aggiunta di un servizio
2. Copia la chiave di integrazione (ad es. de7439f367354513b9e1ba4042f0e3b8) per configurare una notifica di PagerDuty in Grafana. Testa la tua configurazione cliccando sul pulsante Send Test (Invia test). Se la configurazione è stata eseguita correttamente, dovresti ricevere un avviso sulla pagina degli avvisi PagerDuty come questo:
   

   Notifica di PagerDuty
   In caso contrario, controlla i registri del contenitore Grafana per eseguire il debug.
3. Clicca su Save (Salva) per salvare la configurazione. A questo punto, riceverai avvisi da Grafana. Per ulteriori informazioni, consulta la documentazione sulle notifiche di PagerDuty.

Webhook

Puoi anche configurare un server webhook per ricevere avvisi.

1. Configura le notifiche webhook in Grafana. Testa la tua configurazione cliccando sul pulsante Send Test (Invia test). Se la configurazione è stata eseguita correttamente, dovresti ricevere un payload JSON come questo:

   {
       "evalMatches": [
           {
               "metric": "High value",
               "tags": null,
               "value": 100
           },
           {
               "metric": "Higher Value",
               "tags": null,
               "value": 200
           }
       ],
       "message": "Someone is testing the alert notification within grafana.",
       "ruleId": 0,
       "ruleName": "Test notification",
       "ruleUrl": "http://localhost:3000/",
       "state": "alerting",
       "title": "[Alerting] Test notification"
   }
   

   In caso contrario, controlla i registri del contenitore Grafana per eseguire il debug.
2. Clicca su Save (Salva) per salvare la configurazione. A questo punto, riceverai avvisi da Grafana. Per ulteriori informazioni, consulta la documentazione sulle notifiche webhook.