Datadog Synthetics is now available!
home Home docs Docs api API

AWS SNS

Crawler Crawler
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.

Metric collection

  1. In the AWS integration tile, ensure that SNS is checked under metric collection.

  2. Add the following permissions to your Datadog IAM policy in order to collect Amazon SNS metrics. For more information on SNS policies, review the documentation on the AWS website.

    AWS Permission Description
    sns:ListTopics Used to list available topics.
    sns:Publish Used to publish notifications (monitors or event feed).

  3. Install the Datadog - AWS SNS integration.

Event collection

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>

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 then detects your configured SNS topics and demonstrate the @notifications (e.g., “@sns-topic-name”)

Log collection

There is no SNS Logs. Process logs and events that are transiting through to the SNS Service.

Send logs to Datadog

Configure a new SNS subscription, Select the topic where messages come from, Select “Lambda” as protocol and the arn of the lambda you want to use:

AWS sns log collection
AWS sns log collection 2

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 millisecond
aws.sns.smssuccess_rate
(gauge)		 The percentage of successfully delivered sms.
shown as percent

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

Events

The AWS SNS integration includes events for topic subscriptions. See the example event below:

AWS SNS Events

Service Checks

The AWS SNS integration does not include any service checks.

Troubleshooting

AWS GovCloud & AWS China

Currently, we do not support SNS notifications from Datadog to topics in GovCloud or China.

Other Issues

Need help? Contact Datadog support.

Table of Contents