Surveillance des rubriques Amazon SNS à l'aide de CloudWatch - Amazon Simple Notification Service

Surveillance des rubriques Amazon SNS à l'aide de CloudWatch

Amazon SNS et Amazon CloudWatch étant intégrés, vous pouvez collecter, afficher et analyser des métriques pour chaque notification Amazon SNS active. Une fois que vous avez configuré CloudWatch pour Amazon SNS, vous disposez d'un meilleur aperçu des performances de vos rubriques Amazon SNS, des notifications push et des diffusions de SMS. Par exemple, vous pouvez définir une alarme qui vous envoie une notification par e-mail si un seuil défini est atteint pour une métrique Amazon SNS, comme NumberOfNotificationsFailed. Pour obtenir la liste de toutes les métriques envoyées par Amazon SNS à CloudWatch, consultez Métriques Amazon SNS. Pour plus d'informations sur les notifications push Amazon SNS, consultez Notifications push mobile.

Note

Les métriques que vous configurez avec CloudWatch pour vos rubriques Amazon SNS sont automatiquement collectées et envoyées à CloudWatch à intervalles d'1 minute. Ces métriques sont rassemblées sur toutes les rubriques qui sont considérées comme actives par CloudWatch. Une rubrique est considérée comme active par CloudWatch pendant six heures au maximum depuis la dernière activité (c'est-à-dire, un appel d'API) sur la rubrique.

Aucun frais n'est facturé pour les métriques Amazon SNS présentées dans CloudWatch. Elles sont fournies dans le cadre du service Amazon SNS.

Afficher les métriques CloudWatch pour Amazon SNS

Vous pouvez surveiller les métriques pour Amazon SNS à l'aide de la console CloudWatch, de l'interface de ligne de commande (CLI) CloudWatch, ou par programmation à l'aide de l'API CloudWatch. Les procédures suivantes vous expliquent comment accéder aux métriques avec la AWS Management Console.

Pour afficher les métriques à l'aide de la console CloudWatch

  1. Connectez-vous à la console CloudWatch.

  2. Dans le volet de navigation, choisissez Métriques.

  3. Sous l'onglet All metrics (Toutes les métriques), choisissez SNS, puis l'une des dimensions suivantes :

    • Country, SMS Type

    • PhoneNumber

    • Topic Metrics

    • Metrics with no dimensions

  4. Pour afficher plus de détails, choisissez un élément spécifique. Par exemple, si vous choisissez Métriques de rubrique puis NumberOfMessagesPublished, le nombre moyen de messages Amazon SNS publiés pendant une période d'une minute sur la plage de temps de 6 heures s'affiche.

Définir les alarmes CloudWatch pour les métriques Amazon SNS

CloudWatch vous permet également de définir des alarmes lorsqu'un seuil est atteint pour une métrique. Par exemple, vous pouvez définir une alarme pour la métrique NumberOfNotificationsFailed, afin de recevoir une notification par e-mail lorsque la valeur définie pour ce seuil est atteinte pendant la période d'échantillonnage.

Pour définir des alarmes à l'aide de la console CloudWatch

  1. Connectez-vous à AWS Management Console et ouvrez la console CloudWatch à l'adresse https://console.aws.amazon.com/cloudwatch/.

  2. Choisissez Alarmes, puis sélectionnez le bouton Créer une alarme. L'assistant Create Alarm démarre alors.

  3. Faites défiler les métriques Amazon SNS afin de rechercher celle sur laquelle vous souhaitez placer une alarme. Sélectionnez la métrique sur laquelle créer une alarme sur et choisissez Continuer.

  4. Remplissez les champs Nom, Description, Seuil et Time de la métrique, puis choisissez Continuer.

  5. Choisissez Alarm comme état de l'alarme. Si vous voulez que CloudWatch vous envoie un e-mail lorsque l'état de l'alarme est atteint, choisissez une rubrique Amazon SNS préexistante ou Créer une rubrique e-mail. Si vous choisissez Create New Email Topic (Créer une nouvelle rubrique d'e-mail), vous pouvez définir le nom et les adresses e-mail d'une nouvelle rubrique. Cette liste sera enregistrée et s'affichera dans la zone de liste déroulante des futures alarmes. Choisissez Continuer.

    Note

    Si vous utilisez Créer une rubrique e-mail pour créer une rubrique Amazon SNS, les adresses e-mail doivent être vérifiées avant de recevoir des notifications. Les e-mails sont envoyés uniquement lorsque l'alarme passe à un état défini. Si ce changement d'état de l'alarme se produit avant la vérification des adresses e-mail, elles ne reçoivent pas de notification.

  6. A ce stade, l'assistant Create Alarm vous donne la possibilité de passer en revue l'alarme que vous allez créer. Si vous avez besoin d'apporter des modifications, vous pouvez utiliser les liens Edit situés à droite. Une fois que vous êtes satisfait, choisissez Create Alarm (Créer une alarme).

Pour plus d'informations sur l'utilisation de CloudWatch et des alarmes, consultez la documentation CloudWatch.

Métriques Amazon SNS

Amazon SNS envoie les métriques suivantes à CloudWatch.

Métrique Description
NumberOfMessagesPublished

Nombre de messages publiés dans vos rubriques Amazon SNS.

Unités : nombre

Dimensions valides : Application, PhoneNumber, Platform et TopicName

Statistiques valides : somme

NumberOfNotificationsDelivered

Nombre de messages transmis avec succès à des points de terminaison d'abonnement à partir de vos rubriques Amazon SNS.

Pour qu'une tentative de remise réussisse, l'abonnement du point de terminaison doit accepter le message. Un abonnement accepte un message si a.) il manque une politique de filtrage ou b.) sa politique de filtrage contient des attributs qui correspondent à ceux qui sont affectés au message. Si l'abonnement rejette le message, la tentative de remise n'est pas comptabilisée pour cette métrique.

Unités : nombre

Dimensions valides : Application, PhoneNumber, Platform et TopicName

Statistiques valides : somme

NumberOfNotificationsFailed

Nombre de messages qu'Amazon SNS n'a pas pu diffuser.

Pour les points de terminaison Amazon SQS, e-mail, SMS ou push mobile, la métrique est incrémentée de 1 quand Amazon SNS arrête les tentatives de remise de message. Pour les points de terminaison HTTP ou HTTPS, la métrique inclut toutes les tentatives de remise en échec, y compris les tentatives qui suivent la tentative initiale. Pour tous les autres points de terminaison, le nombre augmente de 1 lorsque le message ne peut pas être remis (quel que soit le nombre de tentatives).

Cette métrique ne comprend pas les messages qui ont été rejetés par des stratégies de filtre d'abonnement.

Vous pouvez contrôler le nombre de nouvelles tentatives pour les points de terminaison HTTP. Pour de plus amples informations, veuillez consulter . Nouvelle tentative de distribution des messages Amazon SNS.

Unités : nombre

Dimensions valides : Application, PhoneNumber, Platform et TopicName

Statistiques valides : somme, moyenne

NumberOfNotificationsFilteredOut

Nombre de messages qui ont été rejetés par des stratégies de filtre d'abonnement. Une politique de filtre rejette un message lorsque les attributs du message ne correspondent pas à ses attributs.

Unités : nombre

Dimensions valides : Application, PhoneNumber, Platform et TopicName

Statistiques valides : somme, moyenne

NumberOfNotificationsFilteredOut-InvalidAttributes

Nombre de messages qui ont été rejetés par des stratégies de filtre d'abonnement, car les attributs des messages ne sont pas valides – par exemple, le JSON d'un attribut est mal formaté.

Unités : nombre

Dimensions valides : Application, PhoneNumber, Platform et TopicName

Statistiques valides : somme, moyenne

NumberOfNotificationsFilteredOut-NoMessageAttributes

Nombre de messages qui ont été rejetés par des stratégies de filtre d'abonnement, car les messages n'ont pas d'attribut.

Unités : nombre

Dimensions valides : Application, PhoneNumber, Platform et TopicName

Statistiques valides : somme, moyenne

NumberOfNotificationsRedrivenToDlq

Nombre de messages qui ont été déplacés vers une file d'attente de lettres mortes.

Unités : nombre

Dimensions valides : Application, PhoneNumber, Platform et TopicName

Statistiques valides : somme, moyenne

NumberOfNotificationsFailedToRedriveToDlq

Nombre de messages qui n'ont pas pu être déplacés vers une file d'attente de lettres mortes.

Unités : nombre

Dimensions valides : Application, PhoneNumber, Platform et TopicName

Statistiques valides : somme, moyenne

PublishSize

Taille des messages publiés.

Unités : octets

Dimensions valides : Application, PhoneNumber, Platform et TopicName

Statistiques valides : minimum, maximum, moyenne et nombre

SMSMonthToDateSpentUSD

Frais cumulés depuis le début du mois calendaire en cours pour l'envoi de messages SMS.

Vous pouvez définir une alarme pour cette métrique afin d'être informé lorsque les frais mensuels sont proches du quota de dépenses mensuelles pour l'envoi de messages SMS pour votre compte. Lorsqu'Amazon SNS détermine que l'envoi d'un SMS entraînerait un coût supérieur à ce quota, le service cesse la publication de SMS en quelques minutes.

Pour plus d'informations sur la configuration de votre quota de dépenses mensuelles pour l'envoi de SMS, ou pour obtenir des informations sur l'augmentation du quota de dépenses avec AWS, consultez Définition des préférences de messagerie SMS.

Unités : USD

Dimensions valides : PhoneNumber

Statistiques valides : maximum

SMSSuccessRate

Taux de diffusions SMS réussies.

Unités : nombre

Dimensions valides : PhoneNumber

Statistiques valides : somme, moyenne, exemples de données

Dimensions pour les métriques Amazon SNS

Amazon Simple Notification Service envoie les dimensions suivantes à CloudWatch.

Dimension

Description

Application

Filtre sur les objets d'application, qui représentent une application et l'appareil enregistrés auprès de l'un des services de notification push pris en charge, tels qu'APNs et FCM.

Application,Platform

Filtre sur les objets d'application et de plateforme, où les objets de plateforme sont destinés aux services de notification push pris en charge, tels qu'APNs et FCM.

Country

Filtre sur le pays ou la région de destination d'un SMS. Le pays ou la région est représenté par son code ISO 3166-1 alpha-2.

PhoneNumber

Filtre sur le numéro de téléphone lorsque vous publiez des SMS directement sur un numéro de téléphone (sans rubrique).

Platform

Filtre sur les objets de plateforme pour les services de notifications push, tels qu'APNs et FCM.

TopicName

Filtre sur les noms de rubrique Amazon SNS.

SMSType

Filtre sur le type de SMS. Il peut être promotionnel ou transactionnel.