Werk samen aan incidenten in PagerDuty en InfraNest

Blijf een incident afhandelen in PagerDuty of InfraNest, wat je ook open hebt staan — updates stromen automatisch beide kanten op. Dit artikel is voor teams die op incidenten reageren en willen dat PagerDuty en InfraNest synchroon blijven lopen.

Overzicht

• Bevestigen, oplossen of notities schrijven in de ene tool verschijnt in de andere.
• Eén storing over meerdere monitors wordt één PagerDuty-incident, en actie ondernemen hierop werkt alle gekoppelde InfraNest-incidenten bij.
• Je kunt zien wie er on-call is, en kiezen of de statusupdates van PagerDuty op je statuspagina worden gepubliceerd.

NoteJe hebt een PagerDuty-account nodig dat gekoppeld is onder Integraties → PagerDuty. Als je met één klik hebt verbonden, staat tweerichtingssync al aan. Als je een integratiesleutel hebt geplakt, moet je de webhook zelf instellen — zie de stappen hieronder.

Bevestig en los op in beide tools

1. Bevestig of los het incident in PagerDuty zoals gebruikelijk op. Binnen enkele seconden toont het bijbehorende InfraNest-incident de update, 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 op, en PagerDuty volgt automatisch.
3. Zodra het onderliggende probleem hersteld is, lost InfraNest het PagerDuty-incident automatisch op. Als jouw team incidenten liever handmatig sluit, kun je dit uitschakelen in je PagerDuty-paginginstellingen.

Eén storing, één oproep. Wanneer meerdere monitors op dezelfde server tegelijk uitvallen, maakt PagerDuty één incident aan voor de hele storing. Het bevestigen of oplossen ervan is van toepassing op elk InfraNest-incident dat aan die storing gekoppeld is.

Samenvoegen in PagerDuty. Als je incidenten samenvoegt in PagerDuty, volgen de gekoppelde InfraNest-incidenten het incident waarmee je hebt 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 gemarkeerd als bevestigd. Een automatisering kan nog steeds reageren op de nieuwe oproep.

Incidentnotities lezen en schrijven

1. Schrijf een notitie in PagerDuty — deze verschijnt op de tijdlijn van het InfraNest-incident, bijvoorbeeld met het label "Dana in PagerDuty". Alleen jouw team ziet dit; het bereikt nooit je statuspagina of de abonnees daarvan.
2. Plaats een update in InfraNest — deze wordt een PagerDuty-notitie die begint met From InfraNest, samen met je naam en de status van de update. Hiervoor is een account nodig dat met één klik is verbonden.

Elke notitie wordt eenmalig gekopieerd en nooit opnieuw bijgewerkt. Notities worden alleen gedeeld voor incidenten die InfraNest heeft aangemaakt, en alleen voor services waarbij Sync notes is ingeschakeld.

Om het delen van notities voor een service te stoppen:

1. Ga naar Integraties → PagerDuty.
2. Zoek de service.
3. Schakel Sync notes uit.

Zie wie er on-call is

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). Dit zie je:

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

De getoonde namen zijn maximaal enkele minuten oud. De eerste keer dat je een pagina opent, kan het even niets tonen — open de pagina opnieuw en de namen zouden moeten verschijnen.

NoteEen account dat is verbonden met een integratiesleutel toont geen on-call-namen, omdat een sleutel geen schema's kan lezen.

Publiceer PagerDuty-statusupdates op je statuspagina

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

Dit staat standaard uit voor elke service, omdat een statusupdate vaak klanten of interne systemen noemt, terwijl een statuspagina openbaar is en je abonnees een e-mail stuurt.

1. Ga naar Integraties → PagerDuty.
2. Zoek de service.
3. Schakel Publish PagerDuty status updates on the status page in.

Zodra dit is ingeschakeld:

• Verschijnt de update op de statuspagina van het bijbehorende incident, en worden abonnees per e-mail op de hoogte gebracht — net als wanneer je zelf een update 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 met een integratiesleutel hebt verbonden

Een geplakte sleutel kan oproepen doen, maar kan niet de webhook aanmaken die PagerDuty gebruikt om terug te koppelen naar InfraNest. Je moet deze zelf aanmaken:

1. Ga in InfraNest naar Integraties → PagerDuty en kopieer het webhook-adres dat bij het account wordt getoond. Behandel dit als een wachtwoord.
2. Ga in PagerDuty naar Integrations → Generic Webhooks (v3) en selecteer New Webhook.
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 het geheim terug in InfraNest bij Signing secret en selecteer Opslaan. De rij Inbound updates van het account zou Ready moeten tonen.

Als je geen PagerDuty-beheerder bent

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

1. Selecteer op het account in Integraties → PagerDuty de optie 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 eenmalig, gedurende drie dagen, en alleen voor jouw PagerDuty-account. Je ontvangt een melding zodra tweerichtingssync is ingeschakeld.

Goed om te weten

• Oudere configuraties. Als jouw organisatie tweerichtingssync heeft ingesteld voordat elk PagerDuty-account zijn eigen webhook had, toont de PagerDuty-pagina een melding. Selecteer Move to my account en InfraNest verplaatst je en verwijdert de oude webhook. Als InfraNest de oude niet kan vinden, verwijder je deze zelf onder Integrations → Generic Webhooks (v3) in PagerDuty.
• Alleen jouw PagerDuty-account kan je incidenten bijwerken. Elke update moet de handtekening van PagerDuty bevatten, 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 precies overeenkomt met wat InfraNest toont, en of het geheim overeenkomt met wat PagerDuty voor die specifieke webhook heeft gegeven. Het activiteitenlogboek op de PagerDuty-pagina vermeldt elke update die PagerDuty heeft verzonden en, wanneer er een niet is toegepast, waarom.

Een handmatig aangemaakt incident in PagerDuty verscheen niet in InfraNest. Dat is normaal — alleen incidenten die InfraNest heeft aangemaakt, zijn gekoppeld. Het kan nog steeds 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 is ingeschakeld voor de service, dat het account met één klik is verbonden, en dat er niet wordt aangegeven dat PagerDuty de aanmelding niet langer accepteert. Als dat wel zo is, selecteer dan Connect again.

Je kunt niet vinden waar je een geheim instelt in PagerDuty. Er is er geen om handmatig in te stellen: PagerDuty maakt dit zelf aan en toont het eenmalig, wanneer je de webhook aanmaakt. Als je dit hebt gemist, verwijder de webhook en maak deze opnieuw aan.