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:
- Che cos'è Echobell → /docs/what-is-echobell
- Tipi di notifica e tentativi ripetuti → /docs/notification
- Panoramica sui webhook → /docs/webhook
- Riferimento dell'integrazione con Grafana → /docs/developer/grafana
Prerequisiti
- Un account Echobell con un canale attivo e il relativo URL webhook (vedi /docs/webhook)
- Accesso da amministratore alla tua istanza Grafana
- Almeno una regola di avviso configurata
Configurazione
Passaggio 1 — Crea un contact point Webhook in Grafana
- Vai su Alerting → Contact points
- Clicca su New contact point e scegli Webhook
- 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
- Vai su Alerting → Notification policies
- Crea o modifica una policy che intercetti i tuoi avvisi critici
- 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
- Avvisi webhook per sistemi personalizzati → /blog/get-notified-with-webhook-mcp
- Notifiche per gli errori di GitHub Actions → /blog/github-actions-notifications
- Documentazione per sviluppatori su Grafana → /docs/developer/grafana