Slack koppelen

Stuur InfraNest-meldingen rechtstreeks naar een Slack-kanaal, zodat je hele team incidenten, verlopende zaken en statuswijzigingen ziet precies waar ze al werken.

#Overzicht

• Meldingen worden gepost in het Slack-kanaal dat je kiest, en werken zichzelf bij zodra een probleem is opgelost — het herstel verschijnt als antwoord in dezelfde thread.
• Jij en je team kunnen direct vanuit Slack op een melding reageren: bevestigen, stilzetten, een statusupdate posten, of een issue aanmaken in je tracker.
• Je kunt ook je eigen meldingen als privé Slack-directberichten ontvangen, los van wat het gedeelde kanaal hoort.

#Koppel het in InfraNest

1. Ga naar Integraties → Slack en selecteer Verbinden.
2. Slack vraagt je om InfraNest aan je werkruimte toe te voegen. Controleer de werkruimte rechtsboven en selecteer dan Toestaan.
3. Terug in InfraNest kies je het kanaal waar de meldingen naartoe moeten gaan. Je kunt later meer kanalen aan dezelfde werkruimte toevoegen met Add channel.
4. Selecteer Send a test naast de nieuwe bestemming om te controleren of er een melding aankomt in het kanaal dat je verwacht.

Nadat je dit hebt toegestaan, stuurt InfraNest je een welkomstbericht in Slack. Je bent meteen gekoppeld aan je InfraNest-account en je kunt het eerste kanaal kiezen en een testmelding versturen vanuit dat bericht, zonder hier terug te hoeven keren. Zodra een kanaal meldingen begint te ontvangen, stelt InfraNest zich daar eenmalig voor, zodat je team weet wat de berichten en knoppen betekenen.

TipJe kunt ook /invite @InfraNest typen in elk Slack-kanaal. InfraNest vraagt je dan privé of je je meldingen daarheen wilt sturen.

Een privékanaal verschijnt pas in de kanalenlijst van InfraNest zodra je @InfraNest ervoor uitnodigt in Slack (typ /invite @InfraNest in het kanaal). Openbare kanalen werken zonder uitnodiging.

#Reageer op een melding vanuit Slack

Meldingen die via de InfraNest-app worden gepost, hebben knoppen: Acknowledge zolang niemand ermee bezig is, Silence 1 h zolang het probleem open staat, en Open in InfraNest. Zodra iemand op een knop drukt, wordt de melding voor iedereen in het kanaal bijgewerkt, bijvoorbeeld Acknowledged by Sam at 02:16.

Zodra iemand ermee bezig is, biedt de melding ook Add a note en, als de monitor op een van je statuspagina's staat, Post a status update:

• Add a note slaat een notitie op bij het incident voor je team. Deze wordt gepost in de thread van de melding en is nooit openbaar.
• Post a status update laat je de status kiezen (Investigating, Identified, Monitoring of Resolved), het bericht schrijven, en kiezen of abonnees worden geïnformeerd. Je ziet altijd eerst een controlestap, omdat de update openbaar is: hij verschijnt meteen op je statuspagina en wordt daarna aangekondigd in de thread van de melding.

De knoppen handelen namens jou, met de rol die jij hebt in InfraNest. De eerste keer dat je op een knop drukt, stuurt InfraNest je een privébericht met een knop Link my account. Open dit terwijl je bent ingelogd bij InfraNest, en druk dan opnieuw op de knop in Slack. Dit hoef je maar één keer per Slack-werkruimte te doen.

Create issue verschijnt onder een melding wanneer je werkruimte Jira, Linear of GitHub heeft gekoppeld bij Integraties en het incident nog geen issue heeft. Als je erop drukt, wordt het incident vastgelegd in je tracker en wordt de sleutel en link van het issue gepost in de thread van de melding. De knop verandert dan in die sleutel, zodat iedereen het issue kan openen vanuit de melding. Twee keer drukken, of twee mensen die tegelijk drukken, levert nog steeds maar één issue op. Als meerdere trackers of projecten het zouden kunnen ontvangen en er geen standaard is ingesteld, krijg je in plaats daarvan een privébericht met Open the incident, waar je dan kiest.

Zolang een incident open staat, heeft de melding ook Ask Claude, dat Claude opent met het onderzoek van het incident al klaar (op abonnementen die incidenten omvatten).

Als een automatisering op goedkeuring wacht en haar verzoek naar een Slack-kanaal stuurt, bevat het bericht Approve en Reject…. Reject vraagt je eerst om bevestiging.

Een bericht opslaan als notitie: kies Add to incident as note in het menu van elk bericht (⋯ › More message shortcuts). In de thread van een melding komt het bij dat incident terecht; elders kies je zelf het incident. Post status update staat ook in het snelkoppelingenmenu van Slack (de knop ⚡ of + naast waar je typt).

#Gebruik /infranest

Typ /infranest in elk kanaal of directbericht. Alleen jij ziet het antwoord.

1. /infranest status toont wat nu je aandacht nodig heeft.
2. /infranest status api.example.com toont hoe één monitor, domein of server ervoor staat. Je kunt een naam, URL of ID gebruiken.
3. /infranest update toont de open incidenten waarop jij een openbare statusupdate kunt posten, elk met een knop Post status update.
4. /infranest pause pauzeert je eigen meldingen voor een uur. Gebruik /infranest pause tomorrow tot de ochtend, of /infranest pause week. /infranest back zet ze weer aan.
5. /infranest run toont de handmatige automatiseringen die jij mag uitvoeren, elk met een knop Run die eerst om bevestiging vraagt. /infranest run backup beperkt de lijst.
6. /infranest link koppelt je Slack aan je InfraNest-account, als dat nog niet is gebeurd.
7. /infranest help toont al deze opdrachten.

De InfraNest-app in Slack heeft ook een tabblad Home. Dit toont of je meldingen gepauzeerd zijn (met knoppen om dat te wijzigen), wat er open staat, wie dienst heeft wanneer PagerDuty is gekoppeld, en welk kanaal de meldingen van welke werkruimte ontvangt.

#Stuur iemand een bericht wanneer er iets uitvalt

1. Open de pagina van de Slack-bestemming.
2. Kies onder Mention on an outage wie de melding een bericht stuurt: niemand, @here, een van je Slack-gebruikersgroepen (zoals @oncall), of wie PagerDuty als dienstdoend aangeeft voor die monitor.

Het bericht verschijnt alleen bij de melding die een storing opent, nooit bij updates of bij herstel. De optie voor dienstdoende persoon vereist dat die persoon zijn of haar Slack heeft gekoppeld.

#Kies wat een kanaal hoort, en wanneer

1. Gebruik op de pagina van de Slack-bestemming What should this destination hear? om All events of Urgent only te kiezen.
2. Stel Hours (optional) in op de uren (en dagen) waarin het alles moet horen; daarbuiten hoort het alleen urgente gebeurtenissen, zodat een storing toch doorkomt.
3. Schakel de "Needs you" digest in om dezelfde lijst als de "heeft je nodig"-e-mail in het kanaal te posten — Daily, of Weekly, on Monday — 's ochtends, en alleen wanneer er iets nieuws verschijnt.

Onder Meldingen → Bestemmingen stuurt Monthly test eenmaal per maand een testmelding naar het kanaal, zodat een kanaal dat niet meer werkt opvalt voordat er een storing optreedt.

#Plak een InfraNest-link

Plak een link naar een monitor, domein of server uit InfraNest in een kanaal, en Slack toont de naam, hoe het ermee staat, en wie erop zit, met een knop Open. Deze preview verschijnt alleen voor items van je eigen werkruimte, in een Slack-werkruimte waar InfraNest is geïnstalleerd.

Als je InfraNest aan Slack hebt toegevoegd voordat deze functie beschikbaar kwam, voeg het dan eenmalig opnieuw toe aan Slack: selecteer onder Integraties → Slack Add account en kies dezelfde werkruimte op het scherm van Slack.

#Ontvang je eigen meldingen als Slack-directberichten

1. Zorg dat je Slack gekoppeld is.
2. Ga naar My account › Notifications.
3. Selecteer Add Telegram or Slack, en kies dan Slack.

Je eigen meldingen komen dan binnen als directberichten van InfraNest, en werken zichzelf bij zodra een probleem is opgelost. Elk bericht heeft je eigen knoppen eronder, zoals Acknowledge, Silence 1 h, Remind me in 7 days of Approve voor een aanvraag om deel te nemen. Ze werken alleen voor jou, en alles wat niet ongedaan kan worden gemaakt, vraagt eerst om bevestiging. Er is niets te plakken. Als je team InfraNest nog niet aan Slack heeft toegevoegd, wordt je in plaats daarvan om een webhooklink gevraagd.

Kanaal wijzigen: open de bestemming onder Integraties → Slack en selecteer Change channel. De naam, meldingen en instellingen blijven hetzelfde.

Gebruik je al een webhook? Open de bestemming en selecteer Move to the InfraNest app, en kies dan het kanaal. De naam, meldingen en instellingen blijven hetzelfde, en vanaf dat moment werken de meldingen zichzelf bij zodra een probleem is opgelost.

Meer dan één werkruimte: verbind opnieuw en kies de andere werkruimte op het scherm van Slack. Elke werkruimte staat apart vermeld onder Slack workspaces.

#Verbind in plaats daarvan met een webhook

Als je de InfraNest-app liever niet aan je werkruimte toevoegt, kun je in plaats daarvan een Incoming webhook URL plakken. Meldingen komen op dezelfde manier binnen, maar kunnen zichzelf niet bijwerken zodra een probleem is opgelost: het herstel wordt gepost als een nieuw bericht dat de melding noemt die het afsluit.

1. Voeg in Slack een Incoming Webhooks-app toe aan je werkruimte (of open de bestaande), kies het kanaal, en kopieer de webhook-URL. Behandel deze als een wachtwoord.
2. Ga in InfraNest naar Integraties → Slack, open Verbinden en kies de webhookoptie.
3. Plak de Slack webhook-URL, en selecteer dan Send a test.

#Stuur meldingen naar Slack

Zodra de bestemming is opgeslagen, kies je Slack wanneer je bepaalt welke meldingen waarheen gaan — bijvoorbeeld een monitor die uitvalt, een domein dat bijna verloopt, of een certificaatwaarschuwing.

#Tips

TipZolang je meldingen alleen naar e-mail gaan, eindigt elke meldings-e-mail met Get this in Slack next time. Dit opent Slack in InfraNest, klaar om te verbinden.

• Elke monitorpagina (op het tabblad Alerts & Dependencies) en serverpagina toont Who hears about this?: de bestemmingen en personen die de meldingen bereiken, met Add Slack ernaast.
• Selecteer direct nadat je Slack hebt toegevoegd Send a test om te controleren of er een melding aankomt in het kanaal dat je verwacht. Een bestemming die nog niets heeft ontvangen, blijft de test aanbieden onder Meldingen → Bestemmingen.

#Problemen oplossen

• InfraNest is uit Slack verwijderd, of het kanaal is gearchiveerd: de bestemming wordt meteen gemarkeerd als iets dat aandacht nodig heeft en je wordt per e-mail geïnformeerd. Voeg InfraNest opnieuw toe aan Slack, of kies een ander kanaal.
• Niet zeker of het nog werkt? Open het ⋯-menu van een werkruimte onder Slack workspaces en selecteer Check connection. Dit vraagt Slack of InfraNest nog in elk kanaal kan posten, en biedt de oplossing — Add to Slack again, Pick another channel, of het uitnodigen van @InfraNest voor een privékanaal.
• Een werkruimte verwijderen: verwijder eerst de Slack-bestemmingen die deze gebruiken. Remove workspace verschijnt dan in het ⋯-menu van de werkruimte.

InfraNest post alleen naar de kanalen die jij kiest en leest nooit je berichten. Elk kanaal dat je kiest is één bestemming — voeg een ander kanaal toe voor een ander team.