PagerDuty koppelen

Roep je on-call team op via PagerDuty zodra een monitor down gaat, rechtstreeks vanuit InfraNest.

Overzicht

• Wanneer een monitor down gaat, wordt automatisch een PagerDuty-incident geactiveerd; zodra deze herstelt, lost InfraNest datzelfde incident op.
• Bevestigen of oplossen in de ene tool werkt door in de andere, zodra je verbonden bent.
• Je hebt alleen een PagerDuty Integratiesleutel nodig — geen REST API-sleutel of OAuth vereist.

Voordat je begint

Je hebt een PagerDuty-integratiesleutel nodig (ook wel routing key genoemd). Deze komt van een Events API v2-integratie op een van je PagerDuty-services — het is geen "API Access Key".

1. Ga in PagerDuty naar Services en open de service waarvoor je opgeroepen wilt worden (of maak er een 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. Dat is de waarde die InfraNest nodig heeft.

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

PagerDuty koppelen

1. Ga naar Meldingen, dan Bestemmingen.
2. Selecteer Bestemming toevoegen en kies PagerDuty.
3. Plak de sleutel in Integratiesleutel (routing key). InfraNest controleert deze bij het opslaan: een PagerDuty-integratiesleutel bestaat uit 32 letters en cijfers, en al het andere wordt direct geweigerd in plaats van opgeslagen en later te falen.
4. Selecteer Test versturen om een testoproep te versturen en te bevestigen dat er een incident verschijnt in PagerDuty (je kunt het daarna oplossen).
5. Selecteer Opslaan en testen.

Meldingen naar PagerDuty versturen

Zodra de bestemming is opgeslagen, kies je PagerDuty wanneer je bepaalt welke meldingen waar naartoe gaan. Wanneer een monitor down gaat, wordt een PagerDuty-incident (kritiek) geactiveerd; zodra deze herstelt, lost InfraNest datzelfde incident op.

Bevestigen en oplossen — beide richtingen

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

De tweede richting (PagerDuty → InfraNest) is een optionele eenmalige instelling op je PagerDuty-bestemming — zoek naar Tweerichtingssync instellen op de bestemming. Oproepen en uitgaande updates werken direct met alleen de Integratiesleutel.

Tips

• De Integratiesleutel wordt veilig opgeslagen en verborgen na het opslaan.
• Eén bestemming roept één PagerDuty-service op. Voeg een andere bestemming toe om een andere service of team op te roepen.
• Automatiseringen kunnen ook PagerDuty oproepen, voor zaken die een monitor nooit ziet — een verlopend certificaat, een mislukte taak.

NoteJe hebt geen PagerDuty REST API-sleutel of OAuth nodig voor oproepen of tweerichtingssync — alleen de Integratiesleutel.

Probleemoplossing

InfraNest accepteert de sleutel niet. De sleutel die je hebt geplakt heeft niet de juiste vorm voor een Integratiesleutel, die altijd 32 letters en cijfers bevat. Meestal is het een REST API Access Key (deze zien eruit als PSOJL90… en zijn veel korter) of een sleutel met een streepje erin. Volg Voordat je begint hierboven om de Integratiesleutel te verkrijgen via het tabblad Integrations van je service, en plak die in plaats daarvan.

Test mislukt met een melding "invalid routing key". Dit is hetzelfde probleem van de andere kant — een bestemming die is opgeslagen voordat InfraNest de sleutel begon te controleren. Open de bestemming, plak de Events API v2 Integration Key van je service, en sla op.

Test versturen meldt Test succesvol verzonden, maar er komt niets aan in PagerDuty. Een sleutel die de juiste vorm heeft maar bij een verwijderde integratie hoort, wordt door PagerDuty geaccepteerd en leidt vervolgens nergens toe — PagerDuty antwoordt in beide gevallen "received", waardoor niets aan onze kant dit kan detecteren. Open het tabblad Integrations van de service in PagerDuty, bevestig dat de Events API v2-integratie er nog staat, en kopieer de sleutel opnieuw.

Er komt niets door. Controleer of de bestemming Ingeschakeld is en of de meldingen van de monitor hiernaartoe 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 heen en weer schakelt werkt het bestaande incident bij in plaats van opnieuw op te roepen. Dat is normaal gedrag; los het incident op (of wacht op herstel) en de volgende gebeurtenis roept opnieuw op.