CloudWatch

CloudWatch provides cloud monitoring services for your Amazon Web Services (AWS) resources and applications. Install this integration to correlate your CloudWatch alarms into actionable incidents in BigPanda so you can find problems more quickly and collaborate with your team to resolve them.

Supported Versions:
SaaS Deployments

Type:
Webhook

Key Features

  • Uses the Amazon Simple Notification Service (SNS) to send CloudWatch alarm data to BigPanda.

  • Correlates alarms from CloudWatch to help you understand and respond faster to issues with your AWS resources and applications.

  • Provides the option to automatically sync CloudWatch alarms created after the initial integration with BigPanda. To enable this feature, contact BigPanda support.

How It Works

The integration works by creating an SNS topic and subscribing to it with the BigPanda alerts endpoint. BigPanda then sets the SNS topic for all configured alarms, which forwards all events to BigPanda. BigPanda then processes and correlates the data from CloudWatch to create and maintain up-to-date incidents in BigPanda. When an alarm closes in CloudWatch, the alert is closed in BigPanda.

If the automatic sync is enabled, BigPanda periodically updates all alarms with the SNS topic to ensure that BigPanda receives data for any alarms created after the system was first integrated.

Enabling the automatic sync allows BigPanda to access and change the configurations in CloudWatch. If this feature is not enabled, BigPanda receives data only for the alarms that were configured when the integration was first installed or that were configured manually to send data to BigPanda.

Installing The Integration

Administrators can install the integration by following the on-screen instructions in BigPanda. For more information, see Installing an Integration.

CloudWatch Data Model

BigPanda normalizes alert data from CloudWatch into tags. You can use tag values to filter the incident feed and to define filter conditions for Environments. The primary and secondary properties are also used during the correlation process.

Standard Tags

Tags
Description
Attributes

object

Value of the CloudWatch metric dimension for the alarm's associated metric. If the value does not exist, then the name of the alarm.

check

Name of the alarm's associated metric.

Secondary Property (Default).

alarm_description

Description for the alarm.

Secondary Property.

incident_id

Name of the alarm. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the alarm name.

trigger_statistics

Statistic applied to the alarm's associated metric:(SampleCount, Average, Sum, Minimum, Maximum)

trigger_period

Time over which the specific metric is applied, in seconds.

trigger_evaluation_periods

Number of periods over which data is compared to the specified threshold.

trigger_comparison_operator

Arithmetic operation used when comparing the specified Statistic and Threshold. The Statistic value is the first operand:

(Greater Than Or Equal To Threshold, Greater Than Threshold, Less Than Or Equal To Threshold, Less Than Threshold)

trigger_threshold

Value against which the specified statistic is compared.

Configuring CloudWatch Permissions

Connecting BigPanda with CloudWatch requires an IAM user with EC2 read access and certain CloudWatch write permissions. Granting the user full access permissions in CloudWatch is the easiest way to ensure BigPanda has the required access. If granting full access is not an option, you can manually grant the required permissions with exact policies.

Prerequisites

Identify the desired user account in CloudWatch.

Granting Full Access

Grant full access by attaching the following User Policy templates to the user:

  • Amazon EC2 Read Only Access
  • CloudWatch Full Access
  • SNS Full Access

How BigPanda Uses Write Access

BigPanda requires write access to CloudWatch for these reasons:

  • BigPanda creates an SNS topic to which all CloudWatch alarms are sent and forwarded to our backend servers.

  • After the SNS topic is created, BigPanda automatically sets it on all alarms that are configured at the time of the integration. Contact BigPanda support if you would like BigPanda to automatically and periodically set the SNS topic for alarms that are created after the initial integration.

Granting Requirement Permissions

If you are unable to grant full access permissions to CloudWatch, you must attach the following policy.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Stmt1406573508000",
            "Effect": "Allow",
            "Action": [
                "sns:CreateTopic",
                "sns:GetTopicAttributes",
                "sns:ListTopics",
                "sns:Subscribe"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Sid": "Stmt1406573498000",
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeRegions"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Sid": "Stmt1406573528000",
            "Effect": "Allow",
            "Action": [
                "cloudwatch:PutMetricAlarm",
                "cloudwatch:DescribeAlarms"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

Post-Requisites

In BigPanda, follow the instructions to install and configure the integration with the user account.

Uninstalling CloudWatch

You must delete the BigPanda topic in CloudWatch to stop sending alerts to BigPanda.

Procedure

  1. In AWS, go to Services and open AWS SNS
  2. In the navigation pane, click Topics.
  3. Select the BigPanda topic.
  4. Click the Actions drop-down list, and select Delete Topics.
  5. Click Delete to confirm the deletion.

After you delete the BigPanda topic from AWS SNS, alarms that are configured to send notifications to the topic will show an error. To resolve these errors, delete the topic from the notification for each alarm.

Post-Requisites

  • Delete the Integration in BigPanda to remove the AppDynamics integration from your UI.

  • Manually resolve any open incidents related to the integration to remove them from your incident feed. Optionally, remove any additional data in BigPanda. For example, modify or remove any Environments or AutoShare rules that reference the integration.

CloudWatch


CloudWatch provides cloud monitoring services for your Amazon Web Services (AWS) resources and applications. Install this integration to correlate your CloudWatch alarms into actionable incidents in BigPanda so you can find problems more quickly and collaborate with your team to resolve them.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.