Amazon DevOps Guru Integration Guide

Harness the power of ML to deliver operational insights to your on-call team with Amazon DevOps Guru with PagerDuty

Amazon DevOps Guru is an ML-powered cloud operations service that assists you in improving application availability. DevOps Guru continuously analyzes streams of disparate data and monitors thousands of metrics to establish normal bounds for application behavior. DevOps Guru automatically identifies deviations from normal conditions in your application metrics, logs, events, and traces within your account and surfaces high severity issues to alert you of downtime quickly, giving you the ability to react quickly to operational issues.

PagerDuty, an AWS Partner Network (APN) Advanced Technology Partner, is an incident management platform. PagerDuty provides features such as reliable notifications, automatic escalations, and on-call scheduling. Using PagerDuty’s DevOps Guru integration, you will be able to detect and fix infrastructure problems quickly.

Architecture

Here is the architecture you will be creating.

You will perform the following:

1. Configure the Amazon DevOps Guru Integration in PagerDuty.
2. Create an AWS SNS topic to forward insights from Amazon DevOps Guru to PagerDuty.
3. Enable DevOps Guru in your AWS account.

In PagerDuty

1. Go to the Services menu and select Service Directory.
2. On the Service Directory page:
   • If you are creating a new service for your integration, click +New Service and follow the steps outlined, selecting this integration in step 4.
   • If you are adding your integration to an existing service, click the name of the service you want to add the integration to. Then click the Integrations tab and click Add a new integration.
3. Under Select the integration(s) you use to send alerts to this service search and select this integration.
4. Click the Add Service or Add Integration button to save your new integration. You will be redirected to the Integrations page for your service.
5. Find the integration in the list, copy the Integration Key and keep it in a safe place for later use.

In Amazon SNS

1. Navigate to the Amazon SNS topics console and click Create topic.
2. Choose the Standard topic type and give your topic a name like operational-insights. Leave the default settings as they are or configure them to suit your needs, then click Create topic.
3. After the topic has been created, scroll down to the subscriptions panel and click Create subscription
4. Select HTTPS protocol and paste the integration URL you copied from the previous step. Leave the remaining options as the defaults, configure them to meet your needs, and click Create subscription.

Amazon SNS sends a confirmation message to your PagerDuty integration. PagerDuty automatically approves this subscription.

PagerDuty can now receive notifications from DevOps Guru.

In Amazon DevOps Guru

When you first browse to the DevOps Guru console, your presented with a getting started page to configure and enable the service.

1. Navigate to the Amazon DevOps Guru Console
2. Select the Resources you wish to monitor.
3. Select the Amazon SNS Topic that you just created from the list of topics, then click on the Enable button

Using the Integration

At this point, Amazon DevOps Guru will start monitoring your resources and learning what’s normal behavior for your applications.

When an operational issue occurs, it generates insights with a summary of related anomalies, contextual information about the problem, and when possible actionable recommendations for remediation.

Amazon SNS forwards insight into PagerDuty, and PagerDuty creates an incident. In PagerDuty, you route the incident to on-call personnel to quickly triage the issue.

Support

If you need help with this integration, please contact the Support Center for AWS.