Automatiseren met PagerDuty

Dit artikel is voor iedereen die InfraNest automatisch wil laten communiceren met PagerDuty — de dienst oproepen voor meer dan alleen een uitgevallen monitor, en reageren wanneer een responder actie ondernemen op een incident. Het is voor jou als je je eigen regels bouwt in Automatiseringen.

Overzicht

• Laat je automatiseringen PagerDuty-incidenten triggeren, bevestigen of oplossen, en reageren wanneer incidenten van status veranderen in PagerDuty.
• Werkt naast, maar los van, monitor-gebaseerde oproepen.
• Vereist een eenmalige PagerDuty-verbinding die je instelt in de automatiseringsbouwer.

NoteDe dienst oproepen vanuit een monitor heeft niets van dit nodig — dat gebruikt de PagerDuty-alertbestemming. Zie Connect PagerDuty voor die instelling. Dit artikel gaat over automatiseringen die je zelf bouwt in Automatiseringen.

PagerDuty koppelen aan een automatisering

1. Open je automatisering in Automations en voeg een PagerDuty-actie of -trigger toe.
2. Wanneer je om een verbinding wordt gevraagd, kies Verbinding toevoegen.
3. Kies een van de twee manieren om te verbinden:
   • of gebruik een token — plak dezelfde 32-tekens Events API v2 Integration Key die de alertbestemming gebruikt, afkomstig van een PagerDuty-service. Dit is de eenvoudigste optie, en de te gebruiken optie als je self-hostet.
   • Verbinden met {provider} — meld je aan bij PagerDuty en gebruik daarna Kies een PagerDuty-service om de service te kiezen die je wilt oproepen. InfraNest leest de key van die service voor je, dus er is niets om te kopiëren.
4. Sla de verbinding op. Totdat er een service is gekozen, worden acties met deze verbinding niet uitgevoerd, en de bouwer laat je dat weten.

NoteÉén verbinding roept één PagerDuty-service op. Voeg een extra verbinding toe als je een andere service of team wilt oproepen.

Reageren op PagerDuty (triggers)

1. Stel in je automatisering Wanneer dit gebeurt in en kies een van de PagerDuty-triggers:
   • PagerDuty-incident getriggerd
   • PagerDuty-incident bevestigd — een responder heeft het opgepakt
   • PagerDuty-incident opgelost
   • PagerDuty-incident geëscaleerd — het is doorgeschoven naar de volgende responder of niveau
   • PagerDuty-incident heropend
2. Gebruik de gegevens die de trigger je geeft — de titel van het incident, de service, urgentie, de responder die actie ondernam, een link naar het incident, en het PagerDuty-incident-ID — in je latere stappen.

3. Zorg dat de webhook is ingesteld in PagerDuty (dit is dezelfde die wordt gebruikt voor tweerichtingssynchronisatie — zie Set up PagerDuty two-way sync). Abonneer deze bij het aanmaken op incident.triggered, incident.escalated en incident.reopened, naast het bevestigd/opgelost-paar dat tweerichtingssynchronisatie al gebruikt.

PagerDuty oproepen (acties)

1. Kies in je automatisering onder Doe dit de optie Actie toevoegen.
2. Voeg een of meer van de volgende acties toe:
   • PagerDuty-incident triggeren — vul een samenvatting in, kies een Ernst (critical, error, warning of info), en stel eventueel een groeperingssleutel in.
   • PagerDuty-incident bevestigen — voer de groeperingssleutel in van het incident dat je wilt bevestigen.
   • PagerDuty-incident oplossen — voer de groeperingssleutel in van het incident dat je wilt oplossen.

Over de groeperingssleutel

PagerDuty groepeert herhaalde oproepen over hetzelfde probleem onder één incident, met wat het een dedup key noemt. Dit is het aangrijpingspunt voor alles wat na de oproep gebeurt:

• Laat deze leeg bij het triggeren, en InfraNest genereert er een — latere stappen in dezelfde regel kunnen dan dat exacte incident bevestigen of oplossen.
• Stel deze zelf in (een placeholder uit de trigger werkt prima — een monitor-ID, een domeinnaam, een taaknaam) wanneer een latere, afzonderlijke regel het incident moet oplossen dat een eerdere regel opende.

TipTrigger dezelfde groeperingssleutel twee keer en PagerDuty werkt het open incident bij in plaats van opnieuw op te roepen — handig om dubbele oproepen over hetzelfde probleem te voorkomen.

Voorbeelden

• Een certificaat verloopt binnen 3 dagen → PagerDuty-incident triggeren met ernst warning, gekoppeld aan het domein — zodat de verlengactie een eigenaar heeft.
• Een back-uptaak is mislukt → roep de dienst op; wanneer de volgende run slaagt, PagerDuty-incident oplossen met dezelfde sleutel.
• Een PagerDuty-incident is bevestigd → Statuspagina-aankondiging plaatsen dat iemand ermee bezig is.
• Een PagerDuty-incident is geëscaleerd → Melding sturen naar je teamkanaal, zodat het bredere team het ziet voordat het verder escaleert.
• Een domein staat op het punt te verlopen en automatisch verlengen staat uit → roep de dienst op in plaats van nog een e-mail te sturen die niemand opent.

Tips

• Ernst kies je per actie zelf. Monitor-gedreven oproepen leiden de ernst juist af van de status van de monitor.
• Automatiseringen roepen op via dezelfde Events API v2-key als de alertbestemming — het oproeppad heeft nooit een PagerDuty REST-key nodig. Verbinden met PagerDuty is er alleen om je het kopiëren van een key te besparen.

Problemen oplossen

• Een PagerDuty-trigger gaat nooit af — controleer of de webhook in PagerDuty is geabonneerd op dat event-type.
• Een actie wordt niet uitgevoerd — als je hebt verbonden met PagerDuty, zorg dan dat je een service hebt gekozen onder Kies een PagerDuty-service; acties worden niet uitgevoerd totdat er een is gekozen.
• Een actie toont een Pro-badge — sommige PagerDuty-acties kunnen een hoger abonnement vereisen.