Amazon Simple Notification Service (SNS)

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

SNS Dashboard

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

  1. Sur la page de l’intégration AWS, vérifiez que SNS est activé dans l’onglet Metric Collection.

  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/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 :

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

  3. Ne cochez pas la case Enable raw message delivery.

  4. Cliquez sur Créer un abonnement.

Envoyer des notifications SNS

Pour envoyer des notifications SNS depuis Datadog :

  1. Configurez le compte AWS associé à un service SNS sur la page de l’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 une nouvelle rubrique SNS.
  2. Sélectionnez la rubrique d’où proviennent les messages.
  3. Pour le protocole, sélectionnez AWS Lambda.
  4. Pour l’endpoint, saisissez l’ARN de la fonction Lambda du Forwarder Datadog.

Données collectées

Métriques

aws.sns.approximate_number_of_bytes_archived
(gauge)		The aggregate number of bytes archived, across all messages in the topic archive.
Shown as byte
aws.sns.approximate_number_of_messages_archived
(gauge)		The aggregate number of messages archived in the topic archive.
Shown as message
aws.sns.dwell_time
(gauge)		The time a message waited before it was delivered.
Shown as millisecond
aws.sns.number_of_bytes_archive_processing
(count)		The aggregate number of bytes saved to the topic archive during the interval.
Shown as byte
aws.sns.number_of_messages_archive_processing
(count)		The number of messages saved to the topic archive during the interval.
Shown as message
aws.sns.number_of_messages_published
(count)		The number of messages published to your SNS topics.
Shown as message
aws.sns.number_of_notifications_delivered
(count)		The number of messages successfully delivered from your SNS topics to subscribing endpoints.
Shown as message
aws.sns.number_of_notifications_failed
(count)		The number of messages that SNS failed to deliver.
Shown as message
aws.sns.number_of_notifications_failed_to_redrive_to_dlq
(count)		The number of messages that couldn’t be moved to a dead-letter queue.
Shown as message
aws.sns.number_of_notifications_failed_to_redrive_to_dlq.sum
(count)		The number of messages that couldn’t be moved to a dead-letter queue.
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.sum
(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 message attributes are invalid, for example the attribute JSON is incorrectly formatted.
Shown as message
aws.sns.number_of_notifications_filtered_out_invalid_attributes.sum
(count)		The number of messages that were rejected by subscription filter policies because the message attributes are invalid, for example the attribute JSON is incorrectly formatted.
Shown as message
aws.sns.number_of_notifications_filtered_out_invalid_message_body
(count)		The number of messages that were rejected by subscription filter policies because the message body is invalid for filtering, for example, invalid JSON message body.
Shown as message
aws.sns.number_of_notifications_filtered_out_message_attributes
(count)		The number of messages that were rejected by subscription filter policies for attribute-based filtering.
Shown as message
aws.sns.number_of_notifications_filtered_out_message_body
(count)		The number of messages that were rejected by subscription filter policies for payload-based filtering.
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 because the messages have no attributes.
Shown as message
aws.sns.number_of_notifications_filtered_out_no_message_attributes.sum
(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_redriven_to_dlq
(count)		The number of messages that have been moved to a dead-letter queue.
Shown as message
aws.sns.number_of_notifications_redriven_to_dlq.sum
(count)		The number of messages that have been moved to a dead-letter queue.
Shown as message
aws.sns.publish_size
(gauge)		The size of messages published. For PublishBatch calls, this reports the total batch size as a single data point, not individual message sizes.
Shown as byte
aws.sns.smsmonth_to_date_spent_usd
(gauge)		The charges accrued since the start of the current calendar month for sending SMS messages.
Shown as dollar
aws.sns.smssuccess_rate
(gauge)		The percentage of successfully delivered sms.
Shown as percent

Each of the metrics retrieved from AWS is assigned the same tags that appear in the AWS console, including host name, security-groups, and more.

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 :

Événements Amazon SNS

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.