DEVOPS

PagerDuty Incident to GitHub Issue with Runbook Link

When a PagerDuty incident is triggered, it auto-creates a tracking GitHub issue in the owning service's repo, attaches the runbook link.

CategoryDevOps
Enginesim
Difficultyintermediate
Triggerevent
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerPagerDuty incident triggeredPagerDutyPagerDuty
  • LogicMap affected service to GitHub repo
  • ActionFind matching runbook in repoGitHubGitHub
  • ActionCreate labeled tracking GitHub issueGitHubGitHub
  • OutputPost issue URL and runbook to PagerDuty incidentPagerDutyPagerDuty

What it does

This workflow turns a freshly triggered PagerDuty incident into a durable engineering artifact. It maps the alerting service to its GitHub repository, opens a labeled tracking issue, finds the matching runbook, and links everything back into PagerDuty so the responder lands on actionable context instead of a bare alert.

When to use it

Use it when on-call engineers waste the first minutes of an incident hunting for the right repo, runbook, and a place to track follow-up work. Best for teams with a clear service-to-repo mapping who want every page to leave a paper trail.

How it works

  1. 1A PagerDuty incident is triggered and fires the workflow.
  2. 2The workflow looks up the service-to-repo mapping for the affected service.
  3. 3It searches the repo for a `RUNBOOK.md` or matching runbook path.
  4. 4It creates a GitHub issue titled with the incident summary, labeled `incident`, including the alert details and runbook link.
  5. 5It posts the issue URL and runbook link as a note on the PagerDuty incident.
  6. 6The final step confirms the linkage so responders see the issue from the incident timeline.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect PagerDutyIncidents, on-call, escalations.
  2. 2
    Connect GitHubRepos, issues, pull requests, actions.
  3. 3
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  4. 4
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  5. 5
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.