Notifiche con chiamata per gli avvisi di Grafana con Echobell

Configura notifiche con chiamata telefonica per gli avvisi di Grafana usando i webhook di Echobell: configurazione passo dopo passo, buone pratiche e risoluzione dei problemi.

Indice

Durante un incidente le notifiche via email e chat passano facilmente inosservate. Per gli avvisi critici, Echobell trasforma le notifiche webhook di Grafana in vere telefonate, con escalation e tentativi ripetuti. Questa guida ti accompagna nell'intera configurazione.

Documentazione utile:

Prerequisiti

  1. Un account Echobell con un canale attivo e il relativo URL webhook (vedi /docs/webhook)
  2. Accesso da amministratore alla tua istanza Grafana
  3. Almeno una regola di avviso configurata

Configurazione

Passaggio 1 — Crea un contact point Webhook in Grafana

  1. Vai su Alerting → Contact points
  2. Clicca su New contact point e scegli Webhook
  3. Dagli un nome riconoscibile, ad esempio "Echobell Phone Calls"

Passaggio 2 — Inserisci l'URL webhook di Echobell

Come URL indica il webhook del tuo canale:

https://hook.echobell.one/t/<channel-token>

Lo trovi nelle impostazioni del canale in Echobell (dettagli su /docs/webhook). Trattalo come un segreto e sostituiscilo se viene divulgato.

Passaggio 3 — Prova l'integrazione

Clicca su Test in Grafana per inviare un avviso di prova. Nel giro di pochi secondi dovresti ricevere una chiamata da Echobell.

Passaggio 4 — Collegalo alle notification policy

  1. Vai su Alerting → Notification policies
  2. Crea o modifica una policy che intercetti i tuoi avvisi critici
  3. Aggiungi il contact point "Echobell Phone Calls"

Da questo momento Grafana instrada verso Echobell tutti gli avvisi corrispondenti.

Buone pratiche

  • Riserva le chiamate agli avvisi ad alta priorità; per le gravità minori usa la chat o l'email
  • Configura tentativi ripetuti e timeout in Echobell per contenere l'alert fatigue (/docs/notification)
  • Imposta un'escalation verso i colleghi quando la prima chiamata resta senza risposta
  • Usa gli orari di silenzio per non farti svegliare da avvisi poco urgenti
  • Condividi il canale con il team di reperibilità e tieni aggiornati i turni

Opzioni avanzate

  • Condividi i canali con i colleghi per una copertura più ampia
  • Personalizza il contenuto vocale per tipo di avviso usando i modelli
  • Configura i tentativi di richiamata e i percorsi di escalation
  • Imposta contatti di riserva per maggiore resilienza

Riferimento completo: /docs/developer/grafana

Risoluzione dei problemi

  • Nessuna chiamata ricevuta: controlla che la notification policy instradi verso il contact point di Echobell
  • Errore 4xx sul webhook: verifica che l'URL webhook sia esatto e che il canale sia attivo
  • Troppe chiamate: restringi l'ambito della policy o alza le soglie di gravità degli avvisi
  • Troppo poche chiamate: aumenta la gravità o aggiungi filtri sulle label, così gli avvisi critici rientrano nella policy

Articoli correlati

Articoli correlati