OpsCanary
awsiamPractitioner

Accelerate Incident Resolution with PagerDuty and AWS DevOps Agent

5 min read AWS DevOps BlogJun 19, 2026Reviewed for accuracy
Share
PractitionerHands-on experience recommended

In today's fast-paced DevOps environment, the ability to resolve incidents quickly can mean the difference between a minor hiccup and a major outage. The integration of AWS DevOps Agent with PagerDuty addresses this critical need by providing engineering teams with tools to investigate and resolve production incidents faster. By utilizing a native connection, teams can access vital information and historical context that accelerates troubleshooting efforts.

The AWS DevOps Agent operates by authenticating with PagerDuty using OAuth 2.0 Scoped OAuth. You register PagerDuty at the AWS account level as a Capability Provider, which allows you to add it to specific Agent Spaces. Once an incident is triggered in PagerDuty, the AWS DevOps Agent picks up the event and begins its investigation. It receives the incident details, including service, severity, and initial context. If configured correctly, it queries PagerDuty for related historical incidents and resolution patterns, examines AWS resource topology, reviews CloudTrail logs for recent changes, and cross-references deployment events from your CI/CD tools against the incident timeline. This comprehensive approach synthesizes potential root causes from all gathered evidence, enabling faster resolution.

In production, ensure you have an active AWS account with the necessary permissions and that your AWS DevOps Agent is enabled in a supported region. You'll need to create an Agent Space with two IAM roles for operations and web app functionality. Be aware of the OAuth 2.0 Scoped OAuth requirements, as only specific scopes are supported, and ensure you are using V3 webhooks for inbound events from PagerDuty. The integration is powerful, but misconfiguration can lead to missed alerts or incomplete investigations.

Key takeaways

  • Authenticate using OAuth 2.0 Scoped OAuth for secure communication between AWS DevOps Agent and PagerDuty.
  • Register PagerDuty as a Capability Provider at the AWS account level for streamlined incident management.
  • Configure Agent Spaces with the necessary IAM roles to enable full functionality.
  • Utilize the AWS DevOps Agent's ability to query historical incidents and diagnostics for enriched investigations.
  • Ensure V3 webhooks are in place for inbound events from PagerDuty to avoid integration issues.

Why it matters

This integration significantly reduces the time to resolution for incidents, allowing teams to maintain service reliability and improve overall operational efficiency. Quick access to historical data and resource relationships can prevent recurring issues and enhance team responsiveness.

When NOT to use this

The official docs don't call out specific anti-patterns here. Use your judgment based on your scale and requirements.

Want the complete reference?

Read official docs

Test what you just learned

Quiz questions written from this article

Take the quiz →
DigitalOceanSponsor

Simple, affordable cloud — VMs, Kubernetes, and managed databases in minutes. Trusted by 600,000+ developers. Spin up a Droplet in 60 seconds.

Try DigitalOcean →

Get the daily digest

One email. 5 articles. Every morning.

No spam. Unsubscribe anytime.