Connect SNS to Datadog in order to:
If you haven’t already, set up the Amazon Web Services integration first.
In the AWS integration tile, ensure that SNS is checked under metric collection.
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). |
Install the Datadog - AWS SNS integration.
On the Topics section of the SNS Management console, select the desired topic and click Create Subscription
Select https and enter the following Webhook url:
https://app.datadoghq.com/intake/webhook/sns?api_key=<API KEY>
Do not enable “raw message delivery”
There is no SNS Logs. Process logs and events that are transiting through to the SNS Service.
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.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.
Currently, we do not support SNS notifications from Datadog to topics in GovCloud or China.
Need help? Contact Datadog support.
