Werk samen aan incidenten in PagerDuty en InfraNest

Werk een incident af vanuit PagerDuty of InfraNest, wat je ook open hebt staan — dit is voor teams die PagerDuty hebben gekoppeld en willen dat updates synchroon blijven lopen.

#Overzicht

• Bevestigen, oplossen en notities toevoegen in de ene tool verschijnt ook in de andere.
• Werkt automatisch als je met één klik hebt verbonden; vereist één extra installatiestap als je met een integratiesleutel hebt verbonden.
• Houdt je statuspagina en de notities van je responseteam netjes gescheiden.

#Voordat je begint

Je hebt een PagerDuty-account nodig dat gekoppeld is onder Integraties. Als je met één klik hebt verbonden, staat tweerichtingssync al aan. Als je een integratiesleutel hebt geplakt, lees dan eerst het gedeelte “Als je verbonden hebt met een integratiesleutel” hieronder voordat je verdergaat.

#Bevestigen en oplossen in beide tools

1. Bevestig of los het incident in PagerDuty zoals gebruikelijk af. Binnen enkele seconden toont het bijbehorende InfraNest-incident dezelfde status, samen met de naam van de responder (als diens PagerDuty-e-mailadres overeenkomt met het InfraNest-adres).
2. Bevestig of los het incident in plaats daarvan in InfraNest af, als je dat liever doet — PagerDuty volgt automatisch.
3. Zodra het onderliggende probleem hersteld is, lost InfraNest het PagerDuty-incident voor je op. Teams die incidenten liever handmatig sluiten, kunnen dit uitschakelen in de pagingsinstellingen van PagerDuty.

NoteEén storing, één oproep. Wanneer meerdere monitors op dezelfde server tegelijk uitvallen, krijgt PagerDuty één incident voor de hele storing. Het bevestigen of oplossen ervan geldt voor elk InfraNest-incident binnen die storing.

Een paar bijzondere gevallen om te weten:

• Samenvoegen in PagerDuty: als je daar incidenten samenvoegt, volgen de InfraNest-incidenten het incident waarin ze zijn samengevoegd, en blijven ze open totdat dat incident is opgelost of het probleem hersteld is.
• Opnieuw onbevestigd: als een bevestiging in PagerDuty verloopt en er opnieuw wordt opgeroepen, houdt InfraNest zijn eigen incident als bevestigd. Een automatisering kan nog steeds reageren op de nieuwe oproep.

#Incidentnotities

1. Notities die in PagerDuty zijn geschreven, verschijnen op de tijdlijn van het InfraNest-incident, met vermelding van wie ze heeft geschreven en PagerDuty — bijvoorbeeld “Dana · PagerDuty.” Alleen je team ziet dit; het verschijnt nooit op je statuspagina en bereikt nooit abonnees.
2. Updates die je in InfraNest plaatst, worden een PagerDuty-notitie die begint met From InfraNest, met jouw naam en de status van de update. Hiervoor is een met één klik gekoppeld account nodig.

Elke notitie wordt één keer gekopieerd en komt nooit terug. Notities worden alleen gedeeld voor incidenten die InfraNest heeft aangemaakt, en alleen voor services waarbij Sync notes aanstaat. Om dit voor een service te stoppen, ga je naar Integraties, zoek je PagerDuty op, zoek je de service en zet je Sync notes uit.

#Bekijk wie dienst heeft

Als je met één klik hebt verbonden, toont InfraNest wie PagerDuty op dit moment zou oproepen — bijvoorbeeld “On call: Dana Reyes (level 1) · Sam Ito (level 2)”:

• op het PagerDuty-account, onder elke service;
• op de pagina van een monitor, voor elke service waarvan de meldingen die monitor bereiken;
• op een incident, zodra PagerDuty hierover heeft gerapporteerd.

De namen zijn hooguit een paar minuten oud. De eerste keer dat je een pagina opent, kan het even niets tonen — open de pagina opnieuw en de namen verschijnen. Een account dat met een integratiesleutel is verbonden, toont geen namen van dienstdoenden, omdat een sleutel geen roosters kan lezen.

#Publiceer PagerDuty-statusupdates op je statuspagina

Een statusupdate in PagerDuty is het bericht dat je schrijft voor mensen buiten het responseteam. InfraNest kan dit automatisch op je statuspagina plaatsen, zodat je het niet twee keer hoeft te schrijven.

1. Ga naar Integraties, zoek PagerDuty op en zoek de service.
2. Zet Publiceer PagerDuty-statusupdates op de statuspagina aan. Dit staat standaard voor elke service uit, omdat een statusupdate vaak klanten of interne systemen noemt, terwijl een statuspagina openbaar is en je abonnees e-mailt.

Zodra het aanstaat:

• Verschijnt de update op de statuspagina van het bijbehorende incident, en worden abonnees per e-mail op de hoogte gebracht, net als wanneer je er zelf een plaatst.
• Verandert de status van het incident niet.
• Wordt er niets geplaatst voor een incident dat niet op een statuspagina staat, of al is opgelost.
• Wordt een lange update die PagerDuty heeft ingekort, ook ingekort geplaatst, eindigend op “…”

Updates die je in InfraNest schrijft, gaan naar PagerDuty als notities, niet als statusupdates.

#Als je verbonden hebt met een integratiesleutel

Een geplakte sleutel kan oproepen versturen, maar kan niet de webhook aanmaken die PagerDuty gebruikt om terug te rapporteren. Maak deze zelf aan:

1. Ga in InfraNest naar Integraties, zoek PagerDuty op en kopieer het webhookadres dat bij het account wordt getoond. Behandel het als een wachtwoord.

2. Ga in PagerDuty naar Integrations → Generic Webhooks (v3) en selecteer New.

3. Plak het adres en abonneer je op minimaal incident.acknowledged en incident.resolved. Voeg incident.annotated toe voor notities en incident.status_update_published voor statusupdates.

4. Sla op. PagerDuty toont eenmalig een signing secret — kopieer deze meteen.

   

5. Plak deze terug in InfraNest bij Signing secret en selecteer Opslaan. De rij Inbound updates van het account toont nu Ready.

#Als je geen PagerDuty-beheerder bent

Alleen een PagerDuty Admin of Account Owner kan de webhook aanmaken. Al het andere werkt ook zonder, dus stel de rest zelf in en vraag een beheerder om deze ene stap:

1. Selecteer op het account in Integraties, onder PagerDuty, Ask a PagerDuty admin.
2. Kopieer de link, of typ het e-mailadres van de beheerder en selecteer Email it.
3. De beheerder opent de link en logt in bij PagerDuty. Diegene heeft geen InfraNest-account nodig, en de link toont verder niets.

TipDe link werkt één keer, gedurende drie dagen, en alleen voor jouw PagerDuty-account. InfraNest gebruikt de inlogsessie van de beheerder eenmalig en vergeet deze daarna. Je ontvangt een melding zodra tweerichtingssync aanstaat.

#Goed om te weten

• Oudere opzetten. Als je werkruimte tweerichtingssync had ingesteld voordat elk PagerDuty-account zijn eigen webhook had, toont de PagerDuty-pagina een melding. Selecteer Move to my account en InfraNest zet je over en verwijdert de oude webhook. Kan InfraNest de oude niet vinden, verwijder deze dan zelf onder Integrations → Generic Webhooks (v3) in PagerDuty.
• Alleen jouw PagerDuty-account kan je incidenten bijwerken. Elke update moet de handtekening van PagerDuty dragen, en elk PagerDuty-account heeft zijn eigen webhook en geheim.
• Het pauzeren van het account stopt updates in beide richtingen totdat je het hervat.

#Problemen oplossen

PagerDuty-acties werken InfraNest niet bij. Controleer of de rij Inbound updates van het account Ready toont. Als je met één klik hebt verbonden en dit niet het geval is, selecteer dan Enable inbound synchronization. Controleer bij een integratiesleutel of de webhook geabonneerd is op incident.acknowledged en incident.resolved, of het adres exact overeenkomt met wat InfraNest toont, en of het geheim overeenkomt met wat PagerDuty voor die webhook heeft gegeven. De activiteit op de PagerDuty-pagina geeft elke update weer die PagerDuty heeft verstuurd en, wanneer er een niet is toegepast, waarom.

Een incident dat handmatig in PagerDuty is aangemaakt, verscheen niet in InfraNest. Dat is normaal — alleen incidenten die InfraNest heeft aangemaakt, zijn gekoppeld. Het kan nog wel een automatisering starten.

Een melding opende geen nieuw PagerDuty-incident. PagerDuty groepeert herhaalde meldingen voor hetzelfde probleem in het incident dat al open staat, zodat een wisselvallige monitor dit bijwerkt in plaats van opnieuw op te roepen.

Een update verscheen niet als notitie in PagerDuty. Controleer of Sync notes aanstaat voor de service, of het account met één klik is verbonden, en of er niet staat dat PagerDuty de inlogsessie niet meer accepteert. Is dat wel zo, selecteer dan Connect again.

Je kunt niet vinden waar je een geheim instelt in PagerDuty. Dat bestaat niet: PagerDuty maakt het aan en toont het eenmalig, wanneer je de webhook aanmaakt. Ben je dit misgelopen, verwijder dan de webhook en maak deze opnieuw aan.