Hoe u HostTracker-waarschuwingen naar Slack stuurt

Hoe de integratie werkt

Wanneer u een nieuw contact toevoegt in HostTracker en Slack kiest uit de contacttypekiezer, maakt u achter de schermen geen ander soort contact aan. Het wordt opgeslagen als een HTTP-contact, en HostTracker herkent het als een Slack-bestemming omdat het adres dat u plakte begint met https://hooks.slack.com/. Dat ene detail is wat het berichtformaat omschakelt van een generieke JSON-payload naar een Slack-compatibel bericht, en dat is waarom het opzetten alleen een URL vergt en verder niets om te configureren.

Slack-waarschuwingen stap voor stap opzetten

1. Open in Slack api.slack.com/apps en kies Create New App, dan From scratch. Geef het een naam zoals "HostTracker alerts" en kies de workspace waar de waarschuwingen naartoe moeten.
2. Open in de instellingen van de app Incoming Webhooks en zet het aan.
3. Klik op Add New Webhook to Workspace, kies het kanaal dat HostTracker-waarschuwingen moet ontvangen, en klik op Allow.
4. Slack genereert een webhook-URL die begint met https://hooks.slack.com/services/. Kopieer hem.
5. Voeg in HostTracker een nieuw contact toe en kies Slack uit de lijst met contacttypen, en plak dan de webhook-URL in het adresveld.
6. Sla het contact op, en gebruik dan Send test om te bevestigen dat een testbericht in het kanaal aankomt voordat u erop vertrouwt.

Heeft u al een webhook aangemaakt via de oudere, nu afgeschafte app-directory-flow van Slack, dan werkt die URL nog steeds zoals hij is; plak hem op dezelfde manier. Een gloednieuwe webhook moet via de app-gebaseerde flow hierboven, aangezien Slack de klassieke voor nieuwe opzetten heeft uitgefaseerd.

Hoe een waarschuwing in het kanaal eruitziet

Elke waarschuwing komt binnen als een kort, platte-tekstbericht, geen opgemaakte kaart. Een Down-waarschuwing noemt de site, het tijdstip, en een beschrijving van de storing, bijvoorbeeld een verbindingstime-out of een HTTP-foutcode. Een Up-waarschuwing noemt de site, het tijdstip van herstel, en hoe lang hij down was geweest. Een nog-steeds-down-herinnering herhaalt de duur van de storing en de fout, zodat u kunt zien of er iets veranderd is zonder HostTracker te openen.

Falen verscheidene van uw monitors in een kort tijdsvenster, dan kan HostTracker ze combineren tot één bericht in plaats van er een na de ander te plaatsen. Dat is de optie "Gebeurtenissen groeperen" op het contact. Meer gevorderde gebruikers kunnen het standaardbericht ook vervangen door een aangepaste template, zolang die geldige Slack-webhook-JSON blijft met een text-veld.

Kiezen welke gebeurtenissen het kanaal bereiken

Een Slack-contact abonneert zich, net als elk ander contact, op specifieke monitors en specifieke gebeurtenistypen in plaats van op uw hele account. Er zijn drie te kiezen gebeurtenissen: Down (de site ging net down), Up (de site herstelde), en Repeat (een herinnering dat hij nog steeds down is). Een gangbaar patroon is Down en Up naar een gedeeld teamkanaal te routeren zodat iedereen het begin en het einde van een incident ziet, en Repeat uit te laten staan als herinneringen ruis zouden zijn, of aan voor een kanaal gewijd aan een incident dat constante aandacht nodig heeft totdat het is opgelost.

Probleemoplossing

Een paar dingen breken een Slack-integratie zonder enig zichtbaar teken, omdat Slack HostTracker geen fout geeft die het binnen de app kan tonen:

• Een ingetrokken of verwijderde webhook. Is de Slack-app verwijderd of de webhook opnieuw gegenereerd, dan stopt de oude URL met het accepteren van posts. HostTracker blijft ernaar sturen en de bezorging faalt, zonder melding binnen HostTracker dat het kanaal stil is gevallen. Voer Send test opnieuw uit telkens wanneer iemand de instellingen van de Slack-app aanraakt, of periodiek als gewoonte.
• Het verkeerde kanaal. Een Incoming Webhook is gebonden aan het kanaal dat u koos toen u hem aanmaakte en kan daarna niet worden omgeleid. Komen waarschuwingen op de verkeerde plek aan, maak dan een nieuwe webhook voor het juiste kanaal in Slack en plak de nieuwe URL in het contact.
• Een gearchiveerd kanaal. Slack accepteert geen webhookposts meer zodra het doelkanaal is gearchiveerd. Dearchiveer het, of maak een nieuwe webhook gericht op een ander, actief kanaal en werk het contact bij.
• Geen toestemming om apps toe te voegen. Sommige Slack-workspaces beperken wie nieuwe apps mag installeren of webhooktoegang mag goedkeuren. Is stap 1 of stap 3 hierboven grijs of geblokkeerd, vraag dan een workspace-beheerder om de webhook voor u te maken of u toestemming te geven om apps te beheren.

Niets hiervan verschijnt als fout binnen HostTracker zelf. Het contact ziet er nog steeds opgeslagen en actief uit, aangezien HostTracker geen manier heeft om te weten dat Slack aan zijn kant een bezorging weigerde. Send test na elke wijziging aan de Slack-kant is de enige betrouwbare manier om te bevestigen dat het kanaal nog steeds waarschuwingen ontvangt.

Gerelateerde leesstof

Slack werkt het best als één kanaal in een bredere meldingsopzet in plaats van het enige. Zie de volledige kanaallijst en hoe u een simpele escalatieketen bouwt in hoe u waarschuwingen van HostTracker krijgt. Voor wat HostTracker controleert voordat het beslist dat uw site down is, zie HostTracker-functies en gedistribueerde beschikbaarheidsmonitoring.

• Alle monitoringhandleidingen - de hub voor elk checktype dat naar Slack kan posten.
• Is de website voor iedereen down of alleen voor mij - wat u als eerste doet wanneer een Down-bericht in het kanaal verschijnt.
• HostTracker-functies
• Gedistribueerde beschikbaarheidsmonitoring
• Hoe u waarschuwingen van HostTracker krijgt