Datadog-AWS SNS Integration

SNS Dashboard

Overview

Connect SNS to Datadog in order to:

  • See SNS messages as events in your stream
  • Send alert and event notifications to SNS

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Receiving SNS Messages In the Event Stream

  1. On the Topics section of the SNS Management console, select the desired topic and click Create Subscription
  2. Select https and enter the following webhook url:

    https://app.datadoghq.com/intake/webhook/sns?api_key=<API KEY>
    

Configuration

In the Amazon Web Services integration tile, ensure that SNS is checked under metric collection.

Sending SNS Notifications from Datadog

  1. Configure the AWS account that is associated with an SNS service on the AWS integration tile
  2. Install the SNS integration
  3. Datadog will detect your configured SNS topics and demonstrate the @ notifications you can use below (e.g., “@sns-topic-name”)

Data Collected

Metrics

aws.sns.number_of_messages_published
(count)
Number of messages published.
shown as message
aws.sns.publish_size
(gauge)
Size of messages published.
shown as byte
aws.sns.number_of_notifications_delivered
(count)
Number of messages successfully delivered.
shown as message
aws.sns.number_of_notifications_failed
(count)
Number of messages that SNS failed to deliver.
shown as message
aws.sns.dwell_time
(gauge)
Time waited by a message before it was delivered.
shown as second
aws.sns.smssuccess_rate
(gauge)
The percentage of successfully delivered sms.
shown as percent

Each of the metrics retrieved from AWS will be assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.