Come inviare gli avvisi HostTracker a Slack

Come funziona l'integrazione

Quando aggiungi un nuovo contatto in HostTracker e scegli Slack dal selettore del tipo di contatto, dietro le quinte non stai creando un tipo di contatto diverso. Viene memorizzato come contatto HTTP, e HostTracker lo riconosce come destinazione Slack perché l'indirizzo che hai incollato inizia con https://hooks.slack.com/. Questo singolo dettaglio è ciò che cambia il formato del messaggio da un payload JSON generico a un messaggio compatibile con Slack, motivo per cui la configurazione richiede solo un URL e nient'altro.

Configurare gli avvisi Slack passo passo

1. In Slack, apri api.slack.com/apps e scegli Create New App, poi From scratch. Dagli un nome come "HostTracker alerts" e scegli il workspace in cui vuoi che arrivino gli avvisi.
2. Nelle impostazioni dell'app, apri Incoming Webhooks e attivalo.
3. Clicca Add New Webhook to Workspace, scegli il canale che deve ricevere gli avvisi di HostTracker, e clicca Allow.
4. Slack genera un URL webhook che inizia con https://hooks.slack.com/services/. Copialo.
5. In HostTracker, aggiungi un nuovo contatto e scegli Slack dall'elenco dei tipi di contatto, poi incolla l'URL del webhook nel campo indirizzo.
6. Salva il contatto, poi usa Send test per confermare che un messaggio di prova arrivi nel canale prima di farci affidamento.

Se hai già un webhook creato tramite il vecchio flusso di app-directory di Slack, ora deprecato, il suo URL funziona ancora così com'è; incollalo allo stesso modo. Un webhook nuovo di zecca deve invece passare dal flusso basato su app descritto sopra, dato che Slack ha ritirato quello classico per le nuove configurazioni.

Come appare un avviso nel canale

Ogni avviso arriva come un breve messaggio in testo semplice, non come una scheda formattata. Un avviso Down nomina il sito, l'orario, e una descrizione del guasto, per esempio un timeout di connessione o un codice di errore HTTP. Un avviso Up nomina il sito, l'orario in cui si è ripristinato, e per quanto tempo era rimasto giù. Un promemoria di stato ancora down ripete la durata dell'interruzione e l'errore, così puoi vedere se qualcosa è cambiato senza aprire HostTracker.

Se più dei tuoi monitor falliscono in una finestra temporale breve, HostTracker può combinarli in un singolo messaggio invece di pubblicarli uno dopo l'altro. È l'opzione "Group events" sul contatto. Gli utenti più avanzati possono anche sostituire il messaggio predefinito con un template personalizzato, purché resti un JSON valido per webhook Slack con un campo text.

Scegliere quali eventi raggiungono il canale

Un contatto Slack, come qualsiasi altro contatto, si abbona a monitor specifici e a tipi di evento specifici invece che all'intero account. Ci sono tre eventi tra cui scegliere: Down (il sito è appena andato giù), Up (il sito si è ripristinato), e Repeat (un promemoria che è ancora giù). Uno schema comune è instradare Down e Up verso un canale di team condiviso così tutti vedono l'inizio e la fine di un incidente, e lasciare Repeat spento se i promemoria sarebbero rumore, oppure acceso per un canale dedicato a un incidente che richiede attenzione costante finché non viene risolto.

Risoluzione dei problemi

Alcune cose rompono un'integrazione Slack senza alcun segno visibile, perché Slack non fornisce a HostTracker un errore che possa mostrarti dentro l'app:

• Un webhook revocato o eliminato. Se l'app Slack è stata rimossa o il webhook è stato rigenerato, il vecchio URL smette di accettare invii. HostTracker continua a inviare a esso e la consegna fallisce, senza alcun avviso dentro HostTracker che il canale sia rimasto silenzioso. Esegui di nuovo Send test ogni volta che qualcuno tocca le impostazioni dell'app Slack, o periodicamente per abitudine.
• Il canale sbagliato. Un Incoming Webhook è legato al canale che hai scelto quando l'hai creato e non può essere reindirizzato in seguito. Se gli avvisi stanno arrivando nel posto sbagliato, crea un nuovo webhook per il canale giusto in Slack e incolla il nuovo URL nel contatto.
• Un canale archiviato. Slack smette di accettare invii webhook una volta che il canale di destinazione viene archiviato. Ripristinalo, oppure crea un nuovo webhook puntato su un canale diverso e attivo e aggiorna il contatto.
• Nessun permesso di aggiungere app. Alcuni workspace Slack limitano chi può installare nuove app o approvare l'accesso ai webhook. Se il passo 1 o il passo 3 sopra è disattivato o bloccato, chiedi a un amministratore del workspace di creare il webhook al posto tuo o di concederti il permesso di gestire le app.

Nessuno di questi problemi compare come un errore dentro HostTracker stesso. Il contatto continua ad apparire salvato e attivo, dato che HostTracker non ha modo di sapere che Slack ha rifiutato una consegna dal suo lato. Eseguire Send test dopo qualsiasi modifica lato Slack è l'unico modo affidabile per confermare che il canale stia ancora ricevendo avvisi.

Letture correlate

Slack funziona meglio come un canale in una configurazione di notifica più ampia piuttosto che come l'unico. Vedi l'elenco completo dei canali e come costruire una semplice catena di escalation in come ricevere avvisi da HostTracker. Per cosa controlla HostTracker prima di decidere che il tuo sito è giù, vedi funzionalità HostTracker e monitoraggio della disponibilità distribuito.

• Tutte le guide al monitoraggio - l'hub per ogni tipo di controllo che può pubblicare su Slack.
• Il sito web è giù per tutti o solo per me - cosa fare per primo quando un messaggio Down arriva nel canale.
• Funzionalità HostTracker
• Monitoraggio della disponibilità distribuito
• Come ricevere avvisi da HostTracker