Jak posílat upozornění z HostTracker do Slacku

Jak integrace funguje

Když v HostTracker přidáte nový kontakt a ve výběru typu kontaktu zvolíte Slack, nevytváříte na pozadí jiný druh kontaktu. Ukládá se jako HTTP kontakt a HostTracker ho rozpozná jako cíl ve Slacku podle toho, že vložená adresa začíná na https://hooks.slack.com/. Právě tento jeden detail přepne formát zprávy z obecného JSON payloadu na zprávu kompatibilní se Slackem, a proto nastavení potřebuje jen URL a nic víc k nastavování.

Nastavte Slack upozornění krok za krokem

1. Ve Slacku otevřete api.slack.com/apps a zvolte Create New App, pak From scratch. Pojmenujte ji například "HostTracker alerts" a vyberte workspace, do kterého mají upozornění chodit.
2. V nastavení aplikace otevřete Incoming Webhooks a zapněte je.
3. Klikněte na Add New Webhook to Workspace, vyberte kanál, který má upozornění z HostTracker dostávat, a klikněte na Allow.
4. Slack vygeneruje URL webhooku začínající na https://hooks.slack.com/services/. Zkopírujte ji.
5. V HostTracker přidejte nový kontakt, ze seznamu typů kontaktu vyberte Slack a do pole adresy vložte URL webhooku.
6. Kontakt uložte a pak přes Send test ověřte, že testovací zpráva do kanálu skutečně dorazí, než se na něj spolehnete.

Pokud už máte webhook vytvořený přes starší, dnes už nepoužívaný postup se slackovým adresářem aplikací, jeho URL pořád funguje beze změny; vložte ji stejným způsobem. Zbrusu nový webhook musí projít výše popsaným postupem přes aplikaci, protože Slack ten klasický postup pro nová nastavení už zrušil.

Jak upozornění v kanálu vypadá

Každé upozornění přistane jako krátká zpráva v prostém textu, ne jako formátovaná karta. Upozornění Down pojmenuje web, čas a popis selhání, například timeout spojení nebo chybový kód HTTP. Upozornění Up pojmenuje web, čas, kdy se zotavil, a jak dlouho byl nedostupný. Připomínka o pokračujícím výpadku znovu uvede délku výpadku a chybu, takže poznáte, jestli se něco změnilo, aniž byste museli otevírat HostTracker.

Pokud vám v krátkém okně selže víc monitorů najednou, HostTracker je může spojit do jedné zprávy místo posílání jedné za druhou. Je to volba "Group events" u kontaktu. Pokročilejší uživatelé mohou výchozí zprávu nahradit i vlastní šablonou, pokud zůstane platným Slack webhook JSON s polem text.

Výběr, které události se do kanálu dostanou

Kontakt Slack se, stejně jako jakýkoli jiný kontakt, přihlašuje ke konkrétním monitorům a konkrétním typům událostí, ne k celému vašemu účtu. Na výběr jsou tři události: Down (web právě spadl), Up (web se zotavil) a Repeat (připomínka, že je pořád nedostupný). Běžný postup je směrovat Down a Up do sdíleného týmového kanálu, aby všichni viděli začátek i konec incidentu, a nechat Repeat vypnutý, pokud by připomínky byly jen šum, nebo ho zapnout pro kanál vyhrazený incidentu, který potřebuje nepřetržitou pozornost, dokud se nevyřeší.

Řešení problémů

Pár věcí dokáže integraci se Slackem rozbít bez jakéhokoli viditelného znamení, protože Slack HostTracker nedá chybu, kterou by mu aplikace mohla ukázat:

• Odvolaný nebo smazaný webhook. Pokud byla aplikace Slack odstraněna nebo byl webhook znovu vygenerovaný, stará URL přestane přijímat příspěvky. HostTracker na ni dál posílá, doručení selže, a uvnitř HostTracker nic neoznámí, že kanál ztichl. Spusťte Send test znovu vždy, když se někdo dotkne nastavení aplikace Slack, nebo tak čiňte pravidelně jako zvyk.
• Špatný kanál. Incoming Webhook je svázaný s kanálem, který jste vybrali při jeho vytváření, a dodatečně ho přesměrovat nejde. Pokud upozornění chodí na špatné místo, vytvořte ve Slacku nový webhook pro správný kanál a novou URL vložte do kontaktu.
• Archivovaný kanál. Jakmile je cílový kanál archivovaný, Slack přestane příspěvky z webhooku přijímat. Zrušte archivaci, nebo vytvořte nový webhook mířící na jiný, aktivní kanál a kontakt aktualizujte.
• Chybí oprávnění přidávat aplikace. Některé workspacy Slacku omezují, kdo smí instalovat nové aplikace nebo schvalovat přístup přes webhook. Pokud je krok 1 nebo krok 3 výše šedý nebo zablokovaný, požádejte administrátora workspace, aby webhook vytvořil za vás, nebo aby vám udělil oprávnění spravovat aplikace.

Nic z toho se uvnitř samotného HostTracker nezobrazí jako chyba. Kontakt pořád vypadá uložený a aktivní, protože HostTracker nemá jak zjistit, že Slack na své straně doručení odmítl. Send test po jakékoli změně na straně Slacku je jediný spolehlivý způsob, jak potvrdit, že kanál upozornění pořád přijímá.

Související čtení

Slack funguje nejlépe jako jeden kanál v širším nastavení notifikací, ne jako jediný. Úplný seznam kanálů a jak sestavit jednoduchý eskalační řetězec najdete v návodu jak dostávat upozornění z HostTracker. Co HostTracker kontroluje, než rozhodne, že je váš web nedostupný, najdete na stránce funkce HostTracker a v návodu distribuovaný monitoring dostupnosti.

• Všechny návody k monitoringu - centrální stránka pro každý typ kontroly, která umí posílat do Slacku.
• Je web nedostupný pro všechny, nebo jen pro mě - co udělat jako první, když do kanálu přistane zpráva Down.
• Funkce HostTracker
• Distribuovaný monitoring dostupnosti
• Jak dostávat upozornění z HostTracker