Documentazione

Notifiche: chi, quando e con quale canale

Pingsured ti invia una notifica quando cambia qualcosa in un ping: quando va giù, quando torna su, quando un certificato viene sostituito. Chi lo viene a sapere, per quali eventi e con quale canale lo stabiliscono le iscrizioni. Un’iscrizione collega un destinatario — un membro dell’account o un webhook — a un canale e agli eventi per cui riceve una notifica.

Le iscrizioni si trovano in due punti. Le predefinite dell’account valgono per tutti i ping; le impostano i proprietari e i gestori in Impostazioni → Notifiche. La pagina di ogni ping ha una sezione Notifiche che mostra i destinatari effettivi e permette di aggiungere iscrizioni solo per quel ping.

Chi riceve una notifica

Ricevono una notifica i membri dell’account, ciascuno tramite un’iscrizione propria, e i webhook dell’account. Nessuno viene notificato in base al ruolo: un gestore senza iscrizione non viene a sapere nulla. Un nuovo account parte con un’iscrizione, quella del proprietario, via email, per tutti i ping.

Destinatari effettivi, nella pagina di un ping, mostra chi riceve le notifiche di quel ping, con quale canale e se tramite la predefinita dell’account o tramite un’iscrizione sul ping stesso.

  • Le predefinite dell’account valgono per tutti i ping dell’account. Le impostano i proprietari e i gestori, per qualsiasi membro.
  • Un’iscrizione su un ping sostituisce, per quel ping, la predefinita di quel membro su quel canale, per esempio per sapere di ogni controllo fallito di un ping critico. Agli altri membri continuano ad applicarsi le loro predefinite.
  • Chi può iscrivere chi. Ogni membro, osservatori compresi, può iscriversi a un ping con Iscrivimi via email e modificare le proprie iscrizioni. I proprietari e i gestori possono iscrivere altri membri e aggiungere webhook.
  • Le persone esterne all’account non possono essere iscritte via email, e nemmeno chi è stato invitato ma non ha ancora accettato. Per raggiungere un turno di reperibilità, una casella condivisa o un canale di chat, usa un webhook.
  • Chi fa parte di più account vede il nome dell’account nell’oggetto di ogni email di allarme, e il suo pulsante apre il ping nell’account giusto.

Quando ricevi una notifica

Un’iscrizione elenca gli eventi per cui invia una notifica, i suoi trigger:

TriggerNotifica quando
Primo erroreil ping inizia a fallire
Primo avvisoil ping inizia a mostrare un avviso
Primo OKil ping torna OK dopo un errore o un avviso
Certificato cambiatoun controllo TLS vede un certificato diverso
Qualsiasi errore, Qualsiasi avviso, Qualsiasi OKa ogni controllo con quel risultato
Primo sconosciuto, Qualsiasi sconosciutonon siamo riusciti a controllare il ping

La selezione consigliata è Primo errore, Primo OK e Certificato cambiato: sai quando qualcosa si rompe, quando viene sistemato e quando un certificato viene sostituito. L’iscrizione del proprietario in un nuovo account parte proprio con questi.

Un cambio di stato viene inviato subito. I trigger Qualsiasi inviano una notifica a ogni controllo corrispondente, non solo a un cambiamento, e quindi possono essere rumorosi: le notifiche ripetute per lo stesso ping e canale vengono trattenute per 15 minuti. «Sconosciuto» dice qualcosa del nostro lato più che del tuo sito, ed è per questo che non fa parte della selezione consigliata.

Quando un ping è considerato in errore

Se un ping «inizia a fallire» lo decide la soglia di allarme: «attiva dopo M controlli falliti sugli ultimi N». Con 1 su 1, il valore predefinito, basta un solo controllo fallito. Con 3 su 5 non basta una singola risposta lenta o persa, e un’interruzione viene comunque notificata non appena tre controlli su cinque l’hanno vista. Entrambi i numeri arrivano fino a 50.

La pagina mostra che cosa significa in termini di tempo. Per un ping controllato ogni 5 minuti, 3 su 5 invia la notifica tra 15 e 25 minuti dopo l’inizio di un guasto, a seconda di quanto è continuo.

La soglia di ripristino funziona allo stesso modo per i controlli riusciti. Coincide con la soglia di allarme finché Come l’allarme è attivo. Una soglia di ripristino di 2 su 2, per esempio, evita che un sito che torna per un controllo e poi cade di nuovo ti mandi nel frattempo una notifica di cessato allarme.

Che cosa conta:

  • Un controllo che fallisce è un errore. Un avviso arriva solo dai controlli TLS: un certificato entrato nel suo periodo di avviso o un rilievo sulla sua configurazione. Entrambi contano come fallimento, e un ping passa da avviso a errore, o viceversa, secondo la soglia di allarme.
  • I controlli si contano per intervallo di controllo. Un risultato che non siamo riusciti a ottenere — il controllo è andato in timeout dal nostro lato oppure non è partito — è sconosciuto: non conta né come fallito né come riuscito e da solo non cambia mai lo stato di un ping.
  • Ogni località viene valutata per conto suo, con la soglia del ping, e un ping fallisce quando fallisce da una qualsiasi delle sue località. Basta che una località perda la strada verso il tuo sito perché tu riceva una notifica; le altre, che lo raggiungono ancora, non lo nascondono.
  • Un ping le cui località si alternano non ha soglia: decide l’ultimo risultato di ciascuna località.

La soglia appartiene al ping, non a un’iscrizione: tutte le persone iscritte a un ping ricevono la notifica nello stesso momento. Un ping senza iscrizioni proprie usa la soglia dell’account. Un ping con iscrizioni proprie ha una sua soglia, mostrata e modificata nella sua sezione Notifiche; alla prima iscrizione riprende quella dell’account. Possono cambiarla i proprietari e i gestori.

Con quale canale

CanalePianiDove arriva la notifica
Emailtutti i pianiall’indirizzo email del membro
Sul webtutti i pianiin Notifiche, nel menu utente dell’app, contato sul suo badge e aggiornato in tempo reale mentre l’app è aperta
Webhookda Team in sua un indirizzo HTTPS di tua scelta; vedi la pagina sugli avvisi via webhook

Un webhook lo aggiunge un proprietario o un gestore, per l’account o per un singolo ping, e Invia test gli manda subito una notifica di prova. Un account può avere più webhook — per esempio uno strumento per gli incidenti e un canale di chat, ciascuno con i propri trigger — e i webhook di un ping si aggiungono a quelli dell’account. Un webhook del ping con lo stesso indirizzo di un webhook dell’account lo sostituisce per quel ping.

Smettere di ricevere notifiche

Ogni email di allarme termina con Annulla l’iscrizione alle notifiche di questo ping. Il link ferma le tue email di allarme per quel ping, e solo per quello: la tua predefinita dell’account continua a coprire gli altri. Per iscriverti di nuovo, usa la pagina del ping. Non avrei dovuto ricevere questo ci segnala che un’email non era destinata a te.

Per fermare tutte le email di allarme di un account, disattiva Email di allarme in Le mie preferenze email (Notifiche, nel menu utente). Le notifiche sul web continuano ad arrivare lì.

Quando un membro lascia l’account, le sue iscrizioni se ne vanno con lui.

Non ancora disponibile

  • Notifiche via SMS e notifiche inviate direttamente in uno strumento di chat. Per le seconde, oggi basta una piattaforma di automazione tra un webhook e lo strumento.