Amazon SNS

Dashboard SNS

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

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

  2. 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 AWSDescription
    sns:ListTopicsUtilisé pour énumérer les rubriques disponibles.
    sns:PublishUtilisé pour publier des notifications (flux d’événements ou monitors).
  3. 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 :

  1. Dans la section Topics de la console de gestion SNS, sélectionnez la rubrique souhaitée et cliquez sur Create subscription.

  2. 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>
    
  3. N’activez pas l’option « raw message delivery ».

Envoyer des notifications SNS

Pour envoyer des notifications SNS depuis Datadog :

  1. Configurez le compte AWS associé à un service SNS sur le carré d’intégration AWS.
  2. Installez l’intégration SNS .
  3. 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

  1. Configurez un nouvel abonnement SNS
  2. Sélectionnez la rubrique d’où proviennent les messages
  3. Choisissez « Lambda » comme protocole et l’ARN de la fonction Lambda du Forwarder Datadog
Collecte de logs AWS sns
Collecte de logs AWS sns 2

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 :

Événements AWS SNS

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 .