Documentazione

Avvisi su Slack: invia gli avvisi di Pingsured a un canale

Pingsured può pubblicare un avviso in un canale Slack quando un ping inizia a non funzionare, quando si ripristina e quando il suo certificato viene sostituito. È un webhook che parla Slack: dai a Pingsured l’URL di un webhook Slack e ogni avviso arriva in quel canale come messaggio leggibile. Gli avvisi su Slack sono disponibili negli stessi piani dei webhook, cioè ogni piano a pagamento. Li configura un proprietario o un gestore dell’account, per un singolo ping o come predefinito di tutti i ping dell’account.

Cosa ti serve

  • Un workspace Slack in cui puoi aggiungere un’app, oppure un amministratore che la approvi.
  • Il canale in cui devono arrivare gli avvisi. Un webhook pubblica in un solo canale; per avvisare un secondo canale, crea un secondo webhook.

Creare il webhook in Slack

Crea il webhook da un’app Slack, non dalla vecchia integrazione «Incoming WebHooks» della directory delle app di Slack. Slack non la consiglia più e potrebbe rimuoverla.

  • Apri api.slack.com/apps e scegli Create New App, poi From scratch. Dagli un nome, per esempio Pingsured, e scegli il tuo workspace.
  • Nelle impostazioni dell’app apri Incoming Webhooks e attivalo.
  • Scegli Add New Webhook to Workspace, seleziona il canale e consenti l’accesso.
  • Copia la Webhook URL. Inizia con https://hooks.slack.com/services/.

Tratta l’URL come un segreto: chi lo possiede può pubblicare in quel canale. Pingsured lo mostra per intero solo a proprietari e gestori.

Aggiungerlo in Pingsured

  • Per tutti i ping, apri Impostazioni → Notifiche, vai a Integrazioni in Notifiche predefinite e scegli la scheda Slack.
  • Per un ping, apri il ping, vai alla sua sezione Notifiche, scegli Aggiungi iscrizione e poi Slack.

Incolla l’URL del webhook. Pingsured accetta solo indirizzi di Slack, quindi l’URL di un altro servizio viene rifiutato al salvataggio. Poi scegli i trigger. La scelta consigliata è Primo errore e Primo OK, più Certificato cambiato se controlli i certificati: sai quando qualcosa si rompe e quando è risolto.

Invia test, accanto al canale, pubblica un messaggio contrassegnato come prova. È il modo più rapido per verificare che l’URL e il canale siano giusti prima che un avviso ci faccia affidamento.

Com’è fatto un messaggio

  • Un titolo con il nome del ping e un punto colorato: rosso se non funziona, giallo se è degradato, verde quando si è ripristinato.
  • Il motivo, se c’è: lo stato HTTP, l’errore o perché un controllo del contenuto è fallito.
  • Dove è stato rilevato: la località, come Da de, oppure, per un ping controllato da più località, quali sono in errore, come In errore da de, sg (2 su 3 località).
  • Un link, Visualizza il ping in Pingsured, che apre il ping.

Un cambio di certificato si legge Certificato cambiato su il ping, o Certificato inatteso su di esso quando il cambio non sembra un rinnovo, con i motivi sotto.

La lingua dei messaggi

I messaggi sono scritti nella lingua delle notifiche dell’account, che un proprietario imposta in Impostazioni → Account. Esistono in inglese, tedesco, spagnolo, francese e italiano. Finché non è impostata, sono in inglese. La stessa impostazione è la lingua di riserva delle e-mail di avviso per i membri che non ne hanno scelta una propria. La riga del motivo è mostrata come l’ha riportata il servizio controllato, nella sua lingua.

Quando vengono inviati i messaggi

Un canale Slack segue le stesse regole di ogni altro canale di avviso: quali cambiamenti, quanti errori prima, con che frequenza e da dove sono descritti nella pagina delle notifiche. Un cambio di stato viene sempre inviato subito, e gli avvisi ripetuti per lo stesso ping e canale vengono trattenuti per 15 minuti.

Se un messaggio non arriva

Quando Slack non è raggiungibile o risponde con un errore che può passare, l’invio viene ritentato, 5 tentativi in tutto, a distanza di 30 secondi, 5 minuti, 30 minuti e 2 ore. Ogni altra risposta di Slack è definitiva. Slack risponde con un breve motivo, per esempio no_service quando il webhook è stato rimosso o channel_is_archived quando il canale è stato archiviato, e Pingsured mostra ciò che ha detto Slack passando il mouse sul badge di stato accanto al canale in Impostazioni → Notifiche. Di solito la soluzione è un nuovo webhook: crealo nell’app Slack, aggiungilo in Pingsured e rimuovi il vecchio.

Limiti

  • I canali Slack contano insieme ai webhook per gli stessi limiti: 50 per l’intero account e 20 su un ping.
  • I messaggi vanno nel canale per cui è stato creato il webhook. Menzioni, messaggi diretti e thread non sono ancora disponibili.