How do I implement the AWS Service Health Dashboard Notifier?

2 minute read

I want to use the AWS Service Health Dashboard Notifier tool to quickly see if there's a problem with an AWS service.

Short description

Important: It's a best practice to use AWS Health Aware (AHA) for health notifications. You can still use the Service Health Dashboard Notifier tool to send notifications from the AWS Health Dashboard, but AHA has more comprehensive functionality. These features are available to only Business and Enterprise Support plans.

Service Health Dashboard Notifier on the GitHub website provides service status updates in an Amazon Simple Notification Service (Amazon SNS) topic, Amazon Chime webhook, or Slack webhook.


Note: If you receive errors when running AWS Command Line Interface (AWS CLI) commands, make sure that you’re using the most recent AWS CLI version.

Install the Service Health Dashboard Notifier tool

Run the following commands to download and install shd-notifier:

git clone && cd aws-health-tools
git filter-branch --subdirectory-filter shd-notifier/ HEAD

Create a notification on Slack, Amazon Chime, or Amazon SNS

Use the following links to create a notification type of your choice:

Run the AWS CloudFormation template

Run the AWS CloudFormation template for shd-notifier with the following steps:

1.    Open the CloudFormation console.

2.    Choose Create stack. Create a stack With new resources (standard).

3.    Select Template is ready for Prepare template, and select Amazon S3 URL for Template source. Then, enter the following for the Amazon S3 URL:

4.    Enter ShdNotifier for the Stack name, and then choose Next.

5.    Choose Next to see the review screen, and then choose Submit.

Note: The following is an example of an endpoint array:

["", "arn:aws:sns:us-east-1:111122223333:MY_TOPIC_NAME", ""]

Run shd-notifier

Run the file on AWS CLI:

/bin/bash Health-Event us-east-1

Note: Replace us-east-1 with your AWS Region.

AWS OFFICIALUpdated a year ago