Connect SNS to Datadog in order to:
If you haven’t already, set up the Amazon Web Services integration first.
In the AWS integration page, ensure that SNS is enabled under the Metric Collection tab.
Add the following permissions to your Datadog IAM policy in order to collect Amazon SNS metrics. For more information, see the SNS policies on the AWS website.
| AWS Permission | Description |
|---|---|
sns:ListTopics | Used to list available topics. |
sns:Publish | Used to publish notifications (monitors or event feed). |
Install the Datadog - AWS SNS integration.
You can receive SNS messages in the Datadog Event Stream through both the HTTPS and Email protocols. Using the HTTPS protocol allows you to automatically confirm the subscription with a webhook URL.
Using the Email protocol requires a manual confirmation step for the email address that Datadog automatically generates for this purpose. Read the Create Datadog Events from Amazon SNS Emails guide for more information.
To receive SNS messages in the Datadog Event Explorer through HTTPS:
In the Topics section of the SNS Management console, select the desired topic and click Create Subscription.
Select HTTPS as the protocol and enter the following webhook URL:
## Datadog US site
https://app.datadoghq.com/intake/webhook/sns?api_key=<API KEY>
## Datadog EU site
https://app.datadoghq.eu/intake/webhook/sns?api_key=<API KEY>
Leave Enable raw message delivery unchecked.
Click Create subscription.
To send SNS notifications from Datadog:
@sns-topic-name.SNS does not provide logs. Process logs and events that are transiting through to the SNS.
| 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 |
| aws.sns.number_of_notifications_filtered_out (count) | The number of messages that were rejected by subscription filter policies. A filter policy rejects a message when the message attributes don't match the policy attributes. Shown as message |
| aws.sns.number_of_notifications_filtered_out_no_message_attributes (count) | The number of messages that were rejected by subscription filter policies. A filter policy rejects a message when the message attributes don't match the policy attributes. Shown as message |
| aws.sns.number_of_notifications_filtered_out_invalid_attributes (count) | The number of messages that were rejected by subscription filter policies because the messages have no attributes. Shown as message |
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.
The AWS SNS integration includes events for topic subscriptions. See the example event below:
The AWS SNS integration does not include any service checks.
Datadog does not support SNS notifications from Datadog to topics in GovCloud or China.
Need help? Contact Datadog support.
