Notifiche che puoi verificare

Canali

• E-mail — cosa è accaduto, da quando, quali regioni di probe l'hanno confermato, e un link diretto al controllo.
• Telegram — tramite un bot gestito da okokumo, così la configurazione è premere Connetti e poi Start invece di registrare un bot tuo.
• Slack — un incoming webhook che incolli, recapitato come blocchi formattati, con un invio di prova dall'interfaccia.
• Discord — un incoming webhook che crei nel tuo server (Canale → Modifica canale → Integrazioni → Webhook) e incolli allo stesso modo. Le notifiche arrivano come embed — rosso se giù, verde al ripristino, grigio se in pausa — con il cambio di stato, l'ora, il motivo e il bersaglio, e il titolo rimanda al controllo. Niente da installare e nessun bot da invitare.
• Webhook — JSON firmato su HTTPS verso qualsiasi endpoint, ritentato con backoff, con payload documentato. Ogni consegna porta una firma HMAC così il destinatario può verificare che venga da noi.

Non ci sono SMS né chiamate telefoniche. Entrambi sono nell'elenco di ciò che questo prodotto non fa.

Un canale non riceve nulla finché non è confermato

Aggiungere un canale sono due passaggi, non uno. L'e-mail si valida quando clicchi il link inviato a quell'indirizzo; webhook, Slack e Discord si validano nel momento in cui una consegna di prova riesce. Fino a quel momento il canale esiste ma è in attesa, e i canali in attesa non ricevono nulla.

È voluto, e vale la pena capirlo invece di aggirarlo: garantisce che una notifica non arrivi mai a una destinazione che nessuno ha confermato — un indirizzo con un errore di battitura, un webhook mai raggiungibile, un canale Slack cancellato. Il prezzo è che un controllo può andare giù senza avvisarti se il suo unico canale non è mai stato confermato, ed è esattamente per questo che il registro delle consegne qui sotto esiste e lo dice.

Instradamento

I canali possono essere collegati a controlli specifici, o lasciati come predefinito dell'organizzazione che copre tutto. Così l'API rivolta ai clienti può svegliare un telefono via Telegram mentre un job batch notturno scrive in una stanza Slack che alle 3 nessuno guarda.

Un incidente, una notifica

Un passaggio a giù invia una volta. Mentre lo stato resta invariato, nulla rinotifica — un servizio giù per sei ore non produce sei ore di messaggi, perché un canale che grida al lupo viene silenziato, e un canale silenziato è peggio di nessun monitoraggio. Il ripristino invia la propria notifica, così il silenzio non va mai interpretato.

Sotto tutto questo, un guasto deve essere confermato da una seconda regione di probe UE indipendente prima che qualcosa inizi. Come funziona →

La parte che nessun altro ti mostra

app.okokumo.com/checks/api

Ogni controllo tiene un registro delle consegne: cosa è stato inviato, a quale canale, quando — e cosa è stato saltato, con il motivo. Deduplicato perché lo stato non era cambiato. Saltato perché il canale era ancora in attesa. Fallito perché l'endpoint ha restituito un 500.

Ogni prodotto di monitoraggio sostiene di avvisarti. Questa è l'affermazione che si può verificare, ed è il motivo per cui il registro è una funzionalità e non una tabella interna.

Tramite l'API

Le notifiche di un controllo sono leggibili attraverso l'API REST versionata con una chiave dell'organizzazione, insieme a controlli, stati e risultati. Documentazione →