Amazon Route 53 Health Check Integration

Amazon Route 53 is a highly available and scalable cloud Domain Name System (DNS) web service. Amazon Route 53 Health Check service monitors the health of your resources such as web servers and email servers. Using Amazon Route 53 Health Check, one can configure CloudWatch alarms for the health checks.

OpsGenie is an alert and notification management solution that is highly complementary to Amazon Route 53 Health Check.

What does OpsGenie offer Amazon Route 53 Health Check users?

By using OpsGenie Amazon Route 53 Health Check Integration, you can forward Amazon Route 53 Health Check alerts to OpsGenie. OpsGenie can determine the right people to notify based on on-call schedules, using email, text messages (SMS), phone calls and iOS & Android push notifications, and escalating alerts until the alert is acknowledged or closed.


Functionality of the integration

  • When an alert is created in Amazon Route 53 Health Check, an alert is created in OpsGenie automatically through the integration.

Add Amazon Route 53 Health Check Integration to OpsGenie

  1. Please create an OpsGenie account if you haven't done already
  2. Go to OpsGenie Amazon Route 53 Health Check Integration page,
  3. Specify who should be notified for Amazon Route 53 Health Check alerts using the "Teams" field. Auto-complete suggestions will be provided as you type.
  4. Click on "Save Integration".

Configuration in Amazon Route 53 Health Check

  1. Create an SNS topic

  2. Add an HTTPS subscription to your topic with the OpsGenie API endpoint by using the url provided from OpsGenie Integration

    Upon successfully configuring SNS subscription to OpsGenie a confirmation alert will be created on OpsGenie :

  3. Configure health check to send notifications to the SNS topic you've created.
  4. After configuring the Health Check "Get notified when health check fails" window opens.
  5. Click Yes and Send Notification to Existing Topic
  6. Choose the topic that you created for OpsGenie usage.
  7. Click Create Health Check

Sample Webhook Message from OpsGenie Amazon Route 53 Health Check Plugin

{
  "Type" : "Notification",
  "MessageId" : "fa97d391-ae96-585b-97dc-830e0d4935e9",
  "TopicArn" : "arn:aws:sns:us-east-1:729181177740:test-sns-for-route53",
  "Subject" : "ALARM: \"try2-awsroute53-23065a3c-3d3d-467f-8930-82cbb897a5ab-Low-Health...\" in US East - N. Virginia",
  "Message" : "{\"AlarmName\":\"try2-awsroute53-23065a3c-3d3d-467f-8930-82cbb897a5ab-Low-HealthCheckStatus\",\"AlarmDescription\":null,\"AWSAccountId\":\"729181177740\",\"NewStateValue\":\"ALARM\",\"NewStateReason\":\"Threshold Crossed: 1 datapoint (0.0) was less than the threshold (1.0).\",\"StateChangeTime\":\"2016-11-11T10:46:55.660+0000\",\"Region\":\"US East - N. Virginia\",\"OldStateValue\":\"INSUFFICIENT_DATA\",\"Trigger\":{\"MetricName\":\"HealthCheckStatus\",\"Namespace\":\"AWS/Route53\",\"Statistic\":\"MINIMUM\",\"Unit\":null,\"Dimensions\":[{\"name\":\"HealthCheckId\",\"value\":\"23065a3c-3d3d-467f-8930-82cbb897a5ab\"}],\"Period\":60,\"EvaluationPeriods\":1,\"ComparisonOperator\":\"LessThanThreshold\",\"Threshold\":1.0}}",
  "Timestamp" : "2016-11-11T10:46:55.762Z",
  "SignatureVersion" : "1",
  "Signature" : "YuaEzc4ZGxWI68sBukJ0+Bn5NpI2uLpKJwmVU5uhj7+B6ljxHBVizS+YprbcNH0fT22QyzxCt5oyouFMJO860ULeV8KNd0GZjJhg6xukxiXQJk3pTe9ecvqRDQVsTnVOZUII9+ITZNEFgsQ3mIZXElb8hhJixnPZJEVYSutqyDtA807HS9LSL5aLrnNCOBzqAx493phcf6b60DeyX2+m1N8WAjclDTC6UwJwaIRX+5OHnfi2+DRj55AyR73uEiiqg42AhA6yeVTL8NvwXKVWUc7enNARMAegOnWtvSucHRcgaj2XLhe5jApIHp5L8QnVGhBpopJ56gNytvCj7/5FWg==",
  "SigningCertURL" : "https://sns.us-east-1.amazonaws.com/SimpleNotificationService-b95095beb82e8f6a046b3aafc7f4149a.pem",
  "UnsubscribeURL" : "https://sns.us-east-1.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-1:729181177740:test-sns-for-route53:d6533783-f9a2-41c2-92d2-3bcedd92a8ec"
}

This payload is parsed by OpsGenie as:

[
  "Type" : "Notification",
  "MessageId" : "fa97d391-ae96-585b-97dc-830e0d4935e9",
  "TopicArn" : "arn:aws:sns:us-east-1:729181177740:test-sns-for-route53",
  "Subject" : "ALARM: \"try2-awsroute53-23065a3c-3d3d-467f-8930-82cbb897a5ab-Low-Health...\" in US East - N. Virginia",
  "AlarmName" : "try2-awsroute53-23065a3c-3d3d-467f-8930-82cbb897a5ab-Low-HealthCheckStatus",
  "AlarmDescription" : null,
  "AWSAccountID" : "729181177740",
  "NewStateValue" : "ALARM",
  "NewStateReason" : "Threshold Crossed: 1 datapoint (0.0) was less than the threshold (1.0).",
  "StateChangeTime" : "2016-11-11T10:46:55.660+0000",
  "Region" : "US East - N. Virginia",
  "OldStateValue" : "INSUFFICIENT_DATA"
]