Amazon Simple Notification Service (SNS)
Présentation
Associez Amazon Simple Notification Service (SNS) à Datadog pour accomplir ce qui suit :
- 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
Sur la page de l’intégration AWS, vérifiez que SNS est activé dans l’onglet Metric Collection.
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/Amazon SNS.
Collecte d’événements
Recevoir les messages de SNS
Vous pouvez recevoir des messages SNS au sein du flux d’événements Datadog via les protocoles HTTPS et Email. Le protocole HTTPS vous permet de confirmer automatiquement l’abonnement à l’aide d’une URL de webhook.
Le protocole Email nécessite la confirmation manuelle de l’adresse e-mail générée automatiquement par Datadog. Consultez le guide Créer des événements Datadog à partir d’e-mails Amazon SNS pour en savoir plus.
Pour recevoir les messages SNS dans l’Event Explorer Datadog via le protocole HTTPS, procédez comme suit :
Dans la section Topics de la console de gestion SNS, sélectionnez la rubrique souhaitée et cliquez sur Create subscription.
Sélectionnez le protocole HTTPS, puis saisissez l’URL de webhook suivante, en prenant soin de remplacer <API_KEY> par la valeur d’une clé d’API Datadog valide :
## 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>
Ne cochez pas la case Enable raw message delivery.
Cliquez sur Créer un abonnement.
Envoyer des notifications SNS
Pour envoyer des notifications SNS depuis Datadog :
- Configurez le compte AWS associé à un service SNS sur la page de l’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 une nouvelle rubrique SNS.
- Sélectionnez la rubrique d’où proviennent les messages.
- Pour le protocole, sélectionnez AWS Lambda.
- Pour l’endpoint, saisissez 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 Amazon 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 Amazon 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 en Chine.
Besoin d’aide ? Contactez l’assistance Datadog.
