AWS Health Dashboard + PagerDuty Benefits

• The AWS Health Dashboard integration allows you to automate response workflows for infrastructure problems that may be impacting your AWS services.
• Send issues and scheduled changes from AWS to PagerDuty.

Requirements

To Configure the Integration:

• In PagerDuty: Managers, Admins, Global Admins and Account Owners can configure the integration.
• In AWS: Users who set up and manage AWS Config must have full-access permissions. Please read Amazon’s
  AWS Config documentation for more information about managing permissions in AWS.

How it Works

• When AWS is experiencing problems, Amazon EventBridge sends AWS Health Dashboard events to PagerDuty.
• These events then generate PagerDuty incidents and notify responders.

Version

This guide details configuration of the AWS Health Dashboard V1 integration.

Integration Walkthrough

In PagerDuty

There are three ways to integrate AWS Health Dashboard with PagerDuty:

• Integrate With Event Orchestration: Integrating with Event Orchestration may be beneficial if you want to build nested rules based on the payload coming from AWS.
• Integrate With Rulesets: Integrating with global or service-level event rules may be beneficial if you want to build different rules based on the payload coming from AWS.
• Integrate With a PagerDuty Service: Integrating with a PagerDuty service directly can be beneficial if you don’t need to route alerts from AWS to different responders based on the event payload. You can still use service-level Event Orchestration to perform actions such as suppressing.

Integrate With Event Orchestration

Integrate With Rulesets

Integrate With a PagerDuty Service

In the AWS Management Console

Create a Topic and Subscription

1. In the Services search bar, search and select Simple Notification Service. In the SNS dashboard left menu, select Topics and click Create Topic on the right. This topic will be used to route alerts to PagerDuty from AWS.

2. Select the Standard Topic Type.

3. Next, perform the following:

   • Name: Enter a name for your topic. You may want to name your topic after your PagerDuty service’s name.
   • Display name (optional): Enter an optional display name.
   • Click Create topic.

4. Now that your topic has been created, select Subscriptions in the left menu and click Create Subscription.

5. Perform the following:

   Field	Instructions
   Topic ARN	Select the Topic ARN of the topic you just created.
   Protocol	Select HTTPS.
   Endpoint	Paste your Integration URL from PagerDuty (generated in steps above).
   Enable raw message delivery	Ensure this checkbox is unchecked.

6. Click Create Subscription. Your subscription should be automatically confirmed. Refresh the page to make sure the Status is Confirmed and not PendingConfirmation.

Create an EventBridge Rule

1. Next you will create a rule to trigger an EventBridge alarm. Search and select Amazon EventBridge in the Services search bar.

2. Select Rules in the left menu and then click Create rule on the right.

3. On the next screen, perform the following:

   Field	Instructions
   Name	Enter a name that can be easily identified.
   Description	Enter a description of the rule, pattern and target(s).
   Event Bus	Select default.
   Enable the rule on the selected event bus	Toggle to the on position.
   Rule with an event pattern	This will automatically be preselected.

   Click Next to continue.

4. On the next screen, perform the following:

   Field	Instructions
   Event source	Select AWS events or EventBridge partner events.
   Sample event type (optional)	If you would like to view sample events, you may do so in this section.
   Method	Select Use pattern form.
   Event pattern - Event source	Select AWS services.
   AWS service	Select Health.
   Event type	You may select All Events, AWS API Call via CloudTrail or Specific Health Events based on your preference.

   Click Next to continue.

5. On the next screen, perform the following:

   Field	Instructions
   Target types	Select AWS service.
   Select a target	Search and select SNS topic.
   Topic	Search and select the topic created in previous steps.

   Configure other additional settings to your preference. Click Next to continue.

6. Optionally add tags to your preference. Click Next to continue.

7. On the final screen, review your settings and click Create Rule. If you would like to create more rules, repeat the steps to create additional EventBridge rules.

   Now that you have configured EventBridge to send AWS Health Dashboard notifications to PagerDuty, your responders will immediately be notified when AWS is experiencing problems.

Uninstall the AWS Health Dashboard Integration

Please refer to our Services and Integrations article to learn more about uninstalling or deleting an integration.

FAQ

Why are my EventBridge events not triggering incidents in PagerDuty?