Integrazione Upptime - Avvisi di monitoraggio uptime

Puoi inoltrare gli eventi di disservizio e di ripristino di Upptime direttamente a Echobell, così il tuo team riceve avvisi push urgenti o chiamate senza dover costruire una pipeline separata. Questa guida si concentra sulla parte Echobell della configurazione e usa le variabili di notifica native di Upptime. Per le opzioni specifiche di Upptime, consulta la documentazione ufficiale sulle notifiche.

Perché usare Echobell per gli avvisi di Upptime

Escalation con chiamata per i disservizi critici, mentre i controlli di routine restano notifiche push normali o urgenti
Modelli e variabili per mostrare in ogni avviso il sito coinvolto, lo stato, il codice di risposta e il link alla issue su GitHub
Nessuna infrastruttura aggiuntiva: basta un URL webhook sicuro per ogni canale Echobell

Prerequisiti

Un repository Upptime già esistente con GitHub Actions attivo
I permessi per aggiungere secret al repository GitHub
Un canale Echobell con un URL webhook (nell'app apri il canale → copia il suo URL webhook)

Prepara un canale Echobell

Crea o apri un canale in Echobell e scegli lo stile di notifica che preferisci (normale, urgente o chiamata).
Copia l'URL webhook del canale: ha questa forma https://hook.echobell.one/t/<channel-token>.
(Facoltativo) Imposta un modello che usi variabili come {{site}}, {{status}}, {{code}}, {{url}} e {{issue}}, così i tuoi avvisi restano strutturati.

Aggiungi i secret di Upptime per Echobell

Nel tuo repository Upptime vai su Settings → Secrets and variables → Actions e aggiungi:

NOTIFICATION_CUSTOM_WEBHOOK=true
NOTIFICATION_CUSTOM_WEBHOOK_URL=https://hook.echobell.one/t/<channel-token>?site=$SITE_NAME&status=$STATUS&url=$SITE_URL&issue=$ISSUE_URL&code=$RESPONSE_CODE&emoji=$EMOJI
(Facoltativo) NOTIFICATIONS_DOWN_MESSAGE=$EMOJI $SITE_NAME is $STATUS ($RESPONSE_CODE) – $ISSUE_URL
(Facoltativo) NOTIFICATIONS_UP_MESSAGE=$EMOJI $SITE_NAME is back up – $SITE_URL

Note:

I parametri di query portano i dati strutturati dentro Echobell. Upptime aggiunge le variabili ed Echobell le conserva come variabili del modello (site, status, url, issue, code, emoji).
Mantieni l'URL codificato (se personalizzi i testi, sostituisci gli spazi con %20) per non rompere la richiesta.
Gli altri provider di notifica e le altre strategie continui a gestirli in Upptime: qui aggiungi solo ciò che serve a Echobell e lascia il resto nell'interfaccia dei secret di GitHub.

Mappa le variabili in Echobell

Usa un modello conciso per mantenere leggibili gli avvisi:

Title: {{emoji}} Upptime: {{site}} is {{status}}
Body: Response {{code}} · {{url}}
External link: {{issue}}

Per i siti ad alta priorità puoi impostare lo stile di notifica del canale su "Urgente" o "Chiamata", lasciando gli altri sulle push normali.

Testa l'integrazione

Fai puntare temporaneamente un URL monitorato a un endpoint inesistente oppure metti in pausa un servizio per provocare un errore.
Verifica che l'avviso arrivi in Echobell con i campi del modello valorizzati.
Ripristina il servizio e controlla il messaggio di ripristino.

Risoluzione dei problemi

Assicurati che NOTIFICATION_CUSTOM_WEBHOOK e NOTIFICATION_CUSTOM_WEBHOOK_URL siano scritti esattamente come nell'elenco dei secret.
Se cambi il token del canale Echobell, aggiorna il secret.
Per errori lato Upptime o per aggiungere altri provider, consulta la documentazione ufficiale e i log di GitHub Actions.