Présentation
Associez SNS à Datadog pour :
- Voir les messages SNS sous forme d’événements dans votre flux
- Envoyer des alertes et notifications d’événement à SNS
Configuration
Installation
Si vous ne l’avez pas déjà fait, configurez d’abord l’intégration Amazon Web Services.
Collecte de métriques
Dans le carré d’intégration AWS, assurez-vous que l’option SNS est cochée dans la section concernant la collecte des métriques.
Ajoutez les autorisations suivantes à votre stratégie IAM Datadog afin de recueillir des métriques Amazon SNS. Pour en savoir plus, consultez la section relative aux stratégies SNS de la documentation AWS.
| Autorisation AWS | Description |
|---|
sns:ListTopics | Utilisé pour énumérer les rubriques disponibles. |
sns:Publish | Utilisé pour publier des notifications (flux d’événements ou monitors). |
Installez l’intégration Datadog/AWS SNS.
Collecte d’événements
Recevoir les messages de SNS
Pour recevoir les messages de SNS dans le flux d’événements Datadog :
Dans la section Topics de la console de gestion SNS, sélectionnez la rubrique souhaitée et cliquez sur Create subscription.
Sélectionnez https et saisissez l’URL Webhook suivante :
## 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>
N’activez pas l’option « raw message delivery ».
Envoyer des notifications SNS
Pour envoyer des notifications SNS depuis Datadog :
- Configurez le compte AWS associé à un service SNS sur le carré d’intégration AWS.
- Installez l’intégration SNS.
- Datadog détecte alors vos rubriques SNS configurées et active les @notifications, par exemple :
@sns-topic-name.
Collecte de logs
SNS ne fournit pas de logs. Traitez les logs et les événements transmis via le service SNS.
Envoyer des logs à Datadog
- Configurez un nouvel abonnement SNS
- Sélectionnez la rubrique d’où proviennent les messages
- Choisissez « Lambda » comme protocole et l’ARN de la fonction Lambda du Forwarder Datadog
Données collectées
Métriques
aws.sns.dwell_time
(gauge) | Time waited by a message before it was delivered.
Shown as millisecond |
aws.sns.number_of_messages_published
(count) | Number of messages published.
Shown as message |
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.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_invalid_attributes
(count) | The number of messages that were rejected by subscription filter policies because the messages have no 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.publish_size
(gauge) | Size of messages published.
Shown as byte |
aws.sns.smssuccess_rate
(gauge) | The percentage of successfully delivered sms.
Shown as percent |
Chacune des métriques récupérées à partir d’AWS se voit assigner les mêmes tags que ceux qui apparaissent dans la console AWS, y compris, mais sans s’y limiter, le hostname et les groupes de sécurité.
Événements
L’intégration AWS SNS comprend des événements pour les abonnements aux rubriques. Vous trouverez ci-dessous un exemple d’événement :
Checks de service
L’intégration AWS SNS n’inclut aucun check de service.
Dépannage
Datadog ne prend pas en charge les notifications SNS envoyées depuis Datadog vers des rubriques dans les régions GovCloud ou Chine.
Besoin d’aide ? Contactez l’assistance Datadog.
