AWS CloudWatch Integration Guide

AWS CloudWatch Integration

AWS CloudWatch provides monitoring for Amazon Web Services (AWS) and the applications that run on AWS. CloudWatch metrics play a critical role in the monitoring of the applications running on AWS cloud. A CloudWatch alarm can watch a single metric over a specified time period and execute automated actions based on the value of the watched metric and given threshold.

How AWS CloudWatch users benefit from PagerTree

AWS CloudWatch triggers user defined alarms by watching metrics. PagerTree acts as the dispatcher for these alarms, determining the right people to notify based on on-call schedules. PagerTree notifies them via email, sms, voice, and/or push notifications until the incident is acknowledged or closed.

Functionality of Integration

The AWS CloudWatch integration is one-way, meaning:

  • When an alarm is triggered (‘ALARM’ state) in AWS CloudWatch, an incident is created in PagerTree automatically.
  • When the alarm is closed (‘OK’ state) in AWS CloudWatch, the incident is resolved in PagerTree automatically.

Tutorial Overview

In this integration tutorial we will show you how to send alarms from AWS CloudWatch to AWS Simple Notification Service (SNS) into PagerTree. The estimated time for this integration is 15 minutes. We assume that you already have a PagerTree and AWS account setup.

In PagerTree

  1. Click the team you wish to add the integration to. Select Team
  2. On the team page, click the “Integrations” tab. Click Integrations Tab
  3. On the “Integrations” tab, click the “+ Integration” button. Click Plus Integration Button
  4. In the “Create Integration” box, fill out the following:
    1. Name of the Integration,
    2. Select the Integration Type to AWS CloudWatch
    3. Select an appropriate urgency for when this integration is triggered
    4. Select the team member the incident will be created by (example: manager or team lead)
    5. Select the team this incident will be assigned to Click Create
  5. Click “Create”
  6. Copy the WebHook URL Copy Webhook URL

In AWS SNS Console

  1. In the SNS Console, click “Create Topic” Create SNS Topic
  2. Enter a Topic name (ex: “pagertree_integration”) and a Display name (ex: “pagertree”), then click “Create Topic”. SNS Topic Details
  3. Now that your topic has been created, click “Create Subscription” Create SNS Subscription
  4. Select HTTPS as the Protocol and paste the PagerTree WebHook URL as the Endpoint SNS Subscription Details
  5. Your subscription should be automatically confirmed. Click the refresh icon and ensure the Subscription ID is not PendingConfirmation. Verify Subscription

In the EC2 Console

  1. Go to your EC2 Instances Console. Right click on the instance that you would like to monitor, and select CloudWatch Monitoring -> Add/Edit Alarms Add EC2 Alarm
  2. Click Create Alarm Create EC2 Alarm
  3. Select your new notification topic from the drop down menu, configure the settings that would like to trigger the alarm, and click “Create Alarm” EC2 Alarm Details
  4. At this point you PagerTree will create an incident if the alarm fires. To configure auto-resolve click the Alarm Link in the dialog box Click Alarm Link
  5. With the new alarm selected, click Actions -> Modify Click Modify Alarm
  6. In the Actions section of the Modify Alarm window, click “+ Notification” Add Notification
  7. Select the following values
    1. Whenever this alarm: State is OK
    2. Send notification to: your new notification topic
  8. Click “Save Changes” Click Save Changes

You have successfully completed the AWS CloudWatch Integration. Now when AWS CloudWatch creates an alarm, PagerTree will create an incident and route it to the correct team member that is on-call. If you have any questions please contact support@pagertree.com