PagerDuty verbinden

Roep je on-call team op via PagerDuty zodra een monitor down gaat — deze handleiding is voor iedereen die InfraNest instelt om het team automatisch te waarschuwen.

Overzicht

• InfraNest roept PagerDuty op wanneer een monitor down gaat, met behulp van een PagerDuty Integration Key (ook wel routing key genoemd).
• Zodra de monitor herstelt, lost InfraNest het bijbehorende PagerDuty-incident automatisch op.
• Erkennen (acknowledge) of oplossen in de ene tool kan de andere tool bijwerken, zodra je een optionele instelstap hebt voltooid.

Je Integration Key ophalen uit PagerDuty

1. Ga in PagerDuty naar Services en open de service waarvoor je opgeroepen wilt worden (of maak een nieuwe aan).
2. Open het tabblad Integrations van de service en kies Add integration.
3. Zoek naar Events API v2 en voeg deze toe.
4. Kopieer de weergegeven Integration Key — een sleutel van 32 tekens. Dit is de waarde die InfraNest nodig heeft.

WarningGebruik niet de API Access Key van de pagina Integrations → API Access Keys van PagerDuty (sleutels zoals PSOJL90…). Die is voor de REST API van PagerDuty en InfraNest zal deze weigeren. Gebruik altijd de Events API v2 Integration Key van het tabblad Integrations van een service.

PagerDuty verbinden in InfraNest

1. Ga naar Meldingen → Bestemmingen.
2. Selecteer Nieuwe bestemming verbinden en kies PagerDuty.
3. Plak de Integratiesleutel (routing key).
4. Selecteer Test versturen om een testoproep te versturen en te bevestigen dat er een incident verschijnt in PagerDuty. Je kunt dit incident daarna oplossen.
5. Selecteer Opslaan.

Meldingen naar PagerDuty versturen

1. Zodra de bestemming is opgeslagen, kies je PagerDuty wanneer je bepaalt welke meldingen waar naartoe gaan, onder Waarschuw mij wanneer….
2. Wanneer een monitor down gaat, activeert dit een PagerDuty-incident dat als kritiek is gemarkeerd.
3. Zodra de monitor herstelt, lost InfraNest datzelfde PagerDuty-incident automatisch op.

Erkennen en oplossen — beide kanten

• Erkennen of oplossen in InfraNest → het gekoppelde PagerDuty-incident wordt ook erkend of opgelost.
• Erkennen of oplossen in PagerDuty → het InfraNest-incident wordt bijgewerkt om overeen te komen.

De tweede richting (PagerDuty → InfraNest) vereist een optionele, eenmalige instelling bij je PagerDuty-bestemming — zie Tweerichtingssync (optioneel). Oproepen en uitgaande updates werken direct met alleen de Integration Key.

Tips

• Één bestemming roept één PagerDuty-service op. Voeg een andere bestemming toe als je een andere service of team moet oproepen.
• Automatiseringen kunnen PagerDuty oproepen voor zaken die een monitor nooit ziet — zoals een verlopend certificaat of een mislukte taak.

NoteDe Integration Key wordt veilig opgeslagen en verborgen na het opslaan. Je hebt geen PagerDuty REST API-sleutel of OAuth nodig voor het oproepen of tweerichtingssync — alleen de Integration Key.

Probleemoplossing

Test mislukt met "invalid routing key". Je hebt waarschijnlijk een REST API Access Key geplakt in plaats van een Events API v2 Integration Key. Verwijder deze, volg de bovenstaande stappen om de juiste sleutel op te halen uit het tabblad Integrations van je service en plak die in plaats daarvan.

Er komt niets binnen. Controleer of de bestemming Ingeschakeld is en of de meldingen van de monitor hiernaar worden gerouteerd. Selecteer opnieuw Test versturen om te bevestigen dat de sleutel werkt.

Een echte melding heeft geen nieuw PagerDuty-incident aangemaakt. PagerDuty groepeert herhaalde meldingen voor hetzelfde probleem in één open incident totdat het is opgelost, dus een monitor die op en neer gaat (flapping) werkt het bestaande incident bij in plaats van opnieuw op te roepen. Dit is verwacht gedrag — los het incident op, of wacht op herstel, en de volgende keer wordt er weer opgeroepen.