Indice
- Perché le notifiche push non bastano per i servizi critici
- Come funzionano gli avvisi con chiamata in Echobell
- Configurare gli avvisi con chiamata dal tuo strumento di monitoraggio
- Usare l'health check che hai già
- Cosa includere nell'avviso
- Scegliere il livello di urgenza giusto
- Scalare su più servizi
- Il vero vantaggio
- Correlati
Che la tua API cada alle 3 di notte non è il problema. Il problema è scoprirlo alle 9 del mattino, quando i tuoi utenti hanno già inondato la casella del supporto.
Quasi tutti gli strumenti di monitoraggio rilevano benissimo i guasti. Sono pessimi, invece, nel garantire che qualcuno veda davvero l'avviso al momento giusto. Una normale notifica push resta sulla schermata di blocco finché qualcuno non prende in mano il telefono. Un messaggio su Slack finisce sepolto in un canale che di notte non guarda nessuno. Un'email rimane non letta fino a lunedì mattina.
Gli avvisi con chiamata cambiano l'equazione. Quando l'health check della tua API fallisce, il telefono squilla davvero — esattamente come squillerebbe per qualsiasi altra questione urgente. Rispondi, senti qual è il problema e puoi iniziare a risolverlo subito, invece che ore dopo.
Perché le notifiche push non bastano per i servizi critici
Uno smartphone medio riceve dalle 50 alle 100 notifiche push al giorno. L'avviso di guasto della tua API compete con aggiornamenti delle app, notifiche dei social, notizie e ogni altra app installata sul dispositivo. Quando tutto è urgente, niente sembra urgente.
Si crea così uno schema pericoloso:
- Il tuo strumento di monitoraggio rileva che l'API restituisce errori 500
- Invia una notifica push al tuo telefono
- Il telefono è sulla scrivania, a faccia in giù, con la Full Immersion attiva
- L'avviso resta lì in silenzio finché qualcuno non se ne accorge — ore dopo
Per un microservizio non critico quel ritardo è solo fastidioso. Per un'API di pagamento, un servizio di autenticazione o il backend del tuo prodotto principale, costa soldi veri e fiducia.
Come funzionano gli avvisi con chiamata in Echobell
Echobell recapita le notifiche su tre livelli di urgenza:
- Normale (attiva): notifica push standard
- Urgente: attraversa la Full Immersion di iOS, ma non fa squillare il telefono
- Chiamata: fa squillare il telefono come una normale telefonata
Per i guasti delle API che ricadono sugli utenti, il livello chiamata è quello giusto. Rispecchia il modo in cui gestiresti qualsiasi altra telefonata urgente — rispondi perché il telefono sta squillando.
La configurazione è semplice:
- Crea un canale in Echobell
- Imposta il tipo di notifica su Chiamata
- Collega il tuo strumento di monitoraggio tramite webhook
- Quando l'health check fallisce, Echobell ti chiama
Configurare gli avvisi con chiamata dal tuo strumento di monitoraggio
Quasi tutte le piattaforme di monitoraggio possono inviare un webhook quando un controllo fallisce. Ecco come collegarle.
Usare l'health check che hai già
Se hai già un endpoint di health (come /health o /status), configura il monitor perché lo interroghi a intervalli regolari. Quando la risposta non è 200, attiva il webhook.
Echobell accetta payload webhook con titolo e corpo:
curl -X POST https://hook.echobell.one/t/<channel-token> \
-H "Content-Type: application/json" \
-d '{
"title": "API DOWN: payment-service",
"body": "Health check failed - 500 error at 03:42 UTC",
"notificationType": "calling",
"externalLink": "https://your-dashboard.example.com/incidents/123"
}'È il campo notificationType: calling a far squillare il telefono.
Cosa includere nell'avviso
Mantieni il contenuto dell'avviso leggibile a colpo d'occhio. Quando rispondi a una chiamata alle 3 di notte, devi capire il problema all'istante:
- Nome del servizio — quale API o microservizio è caduto
- Tipo di errore — timeout, 5xx, connessione rifiutata
- Timestamp — quando è iniziato il guasto
- Link — dove andare a indagare subito
Non è il posto per messaggi prolissi. L'obiettivo è avere il contesto immediato per decidere se svegliarti del tutto o limitarti a prenderne atto e tornare a dormire.
Scegliere il livello di urgenza giusto
Non ogni guasto di un'API merita una telefonata. Usa gli avvisi con chiamata per:
- Servizi di pagamento e fatturazione
- Endpoint di autenticazione e login
- Le API principali del prodotto con cui gli utenti interagiscono direttamente
- Servizi da cui dipendono altri sistemi critici
Usa le notifiche urgenti per:
- Servizi secondari importanti, ma non critici per il fatturato
- Ambienti di sviluppo o di staging
- Segnali di allarme (tassi di errore elevati che non sono ancora guasti veri e propri)
Usa le notifiche normali per:
- Job in background non critici
- Metriche informative che non richiedono alcun intervento
Questo approccio graduale ti tiene avvisato senza generare alert fatigue.
Scalare su più servizi
Se gestisci più di un'API, crea canali separati per ogni servizio o gruppo di servizi:
production-payment-api— livello chiamataproduction-user-api— livello chiamataproduction-analytics-api— urgentestaging-all— urgente
Così puoi calibrare l'urgenza servizio per servizio. La tua API di pagamento merita una telefonata; la pipeline di analytics probabilmente no.
Il vero vantaggio
Il valore degli avvisi con chiamata non sta nello squillo in sé, ma nel cambiamento di abitudini che porta con sé:
- Risolvi i problemi più in fretta perché li scopri all'istante
- Dormi meglio, sapendo che se qualcosa si rompe verrai davvero svegliato
- I tuoi utenti subiscono downtime più brevi perché intervieni in pochi minuti invece che in ore
Per i servizi critici, è tutta lì la differenza che conta.