Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Surveillance des rubriques Amazon SNS à l'aide de CloudWatch
Amazon SNS et Amazon CloudWatch sont intégrés afin que vous puissiez collecter, consulter et analyser les métriques pour chaque notification Amazon SNS active. Une fois que vous avez configuré CloudWatch Amazon SNS, vous pouvez mieux comprendre les performances de vos rubriques Amazon SNS, de vos notifications push et de vos envois 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 auxquelles Amazon SNS envoie CloudWatch, consultez. [Métriques Amazon SNS](#sns-metrics) Pour plus d'informations sur les notifications push Amazon SNS, consultez [Envoi de notifications push mobiles avec Amazon SNS](sns-mobile-application-as-subscriber.md).
**Note**
Les métriques que vous configurez CloudWatch pour vos rubriques Amazon SNS sont automatiquement collectées et transmises à CloudWatch intervalles d'une *minute*. Ces indicateurs sont collectés sur tous les sujets qui répondent aux CloudWatch directives relatives à l'activité physique. Un sujet est considéré comme actif jusqu' CloudWatch à six heures après la dernière activité (c'est-à-dire tout appel d'API) sur le sujet.
Les métriques Amazon SNS indiquées dans le présent document sont gratuites CloudWatch ; elles sont fournies dans le cadre du service Amazon SNS.
## Afficher CloudWatch les statistiques pour Amazon SNS
Vous pouvez surveiller les métriques pour Amazon SNS à l'aide de la CloudWatch console, CloudWatch de sa propre interface de ligne de commande (CLI) ou de manière programmatique à 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 CloudWatch console**
1. Connectez-vous à la [console CloudWatch](https://console.aws.amazon.com/cloudwatch).
1. Dans le volet de navigation, choisissez **Métriques**.
1. 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**
1. Pour afficher plus de détails, choisissez un élément spécifique. Par exemple, si vous choisissez **Topic Metrics**, puis choisissez **NumberOfMessagesPublished**, le nombre moyen de messages Amazon SNS publiés sur une période d'une minute sur une période de 6 heures est affiché.
1. Pour consulter les métriques d'utilisation d'Amazon SNS, dans l'onglet **All metrics** (Toutes les métriques), choisissez **Usage** (Utilisation), puis sélectionnez la **target Amazon SNS usage metric** (métrique d'utilisation Amazon SNS cible), par exemple, `NumberOfMessagesPublishedPerAccount`.
## Définissez des CloudWatch alarmes 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**, de sorte que lorsque le seuil que vous avez spécifié est atteint pendant la période d'échantillonnage, une notification par e-mail soit envoyée pour vous informer de l'événement.
**Pour définir des alarmes à l'aide de la CloudWatch console**
1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Choisissez **Alarmes**, puis sélectionnez le bouton **Créer une alarme**. L'assistant **Create Alarm** démarre alors.
1. 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**.
1. Remplissez les champs **Nom**, **Description**, **Seuil** et **Time** de la métrique, puis choisissez **Continuer**.
1. Choisissez **Alarm** comme état de l'alarme. Si vous CloudWatch souhaitez vous envoyer un e-mail lorsque l'état d'alarme est atteint, choisissez une rubrique Amazon SNS existante ou choisissez **Create New Email** Topic. 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. Sélectionnez **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.
1. 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 CloudWatch et les alarmes, consultez la [CloudWatchdocumentation](https://aws.amazon.com/documentation/cloudwatch).
## Métriques Amazon SNS
Amazon SNS envoie les métriques suivantes à. CloudWatch
| Namespace | Métrique | Description |
| --- | --- | --- |
| AWS/SNS | NumberOfMessagesPublished | Nombre de messages publiés dans vos rubriques Amazon SNS. **Unités :** nombre **Dimensions valides :** application PhoneNumber, plate-forme et TopicName **Statistiques valides :** somme |
| AWS/SNS | 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, plate-forme et TopicName **Statistiques valides :** somme |
| AWS/SNS | 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](sns-message-delivery-retries.md). **Unités :** nombre **Dimensions valides :** application PhoneNumber, plate-forme et TopicName **Statistiques valides :** somme, moyenne |
| AWS/SNS | 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, plate-forme et TopicName **Statistiques valides :** somme, moyenne |
| AWS/SNS | NumberOfNotificationsFilteredOut-MessageAttributes | Nombre de messages qui ont été rejetés par des politiques de filtre d'abonnement pour le filtrage basé sur les attributs. **Unités :** nombre **Dimensions valides :** application PhoneNumber, plate-forme et TopicName **Statistiques valides :** somme, moyenne |
| AWS/SNS | NumberOfNotificationsFilteredOut-MessageBody | Nombre de messages qui ont été rejetés par des politiques de filtre d'abonnement pour le filtrage basé sur la charge utile. **Unités :** nombre **Dimensions valides :** application PhoneNumber, plate-forme et TopicName **Statistiques valides :** somme, moyenne |
| AWS/SNS | 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, plate-forme et TopicName **Statistiques valides :** somme, moyenne |
| AWS/SNS | 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, plate-forme et TopicName **Statistiques valides :** somme, moyenne |
| AWS/SNS | NumberOfNotificationsFilteredOut-InvalidMessageBody | Nombre de messages qui ont été rejetés par des politiques de filtre d'abonnement, car le corps de message ne convient pas pour le filtrage – par exemple, corps de message JSON non valide. **Unités :** nombre **Dimensions valides :** application PhoneNumber, plate-forme et TopicName **Statistiques valides :** somme, moyenne |
| AWS/SNS | 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, plate-forme et TopicName **Statistiques valides :** somme, moyenne |
| AWS/SNS | 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, plate-forme et TopicName **Statistiques valides :** somme, moyenne |
| AWS/SNS | PublishSize | Taille des messages publiés. **Unités :** octets **Dimensions valides :** application PhoneNumber, plate-forme et TopicName **Statistiques valides :** minimum, maximum, moyenne et nombre |
| AWS/SNS | SMSMonthToDateSpentUSD | Frais cumulés depuis le début du mois calendaire en cours pour l'envoi de messages SMS. Vous pouvez configurer une alarme pour cette métrique afin de savoir quand vos month-to-date frais sont proches du quota mensuel de dépenses par 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 [Configuration des préférences de messagerie SMS dans Amazon SNS](sms_preferences.md). **Unités :** USD **Dimensions valides :** Aucune **Statistiques valides :** somme |
| AWS/SNS | SMSSuccessRate | Taux de diffusions SMS réussies. **Unités :** nombre **Dimensions valides :** PhoneNumber **Statistiques valides :** somme, moyenne, échantillons de données |
## Dimensions pour les métriques Amazon SNS
Amazon Simple Notification Service envoie les dimensions suivantes à CloudWatch.
| Dimension | Description |
| --- | --- |
| Application | Filtres sur les objets d'application, qui représentent une application et un appareil enregistrés auprès de l'un des services de notification push pris en charge, tels que APNs FCM. |
| Application,Platform | Filtres sur les objets de l'application et de la plate-forme, les objets de plate-forme étant destinés aux services de notification push pris en charge, tels que APNs 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 | Filtres sur les objets de la plateforme pour les services de notification push, tels que APNs FCM. |
| TopicName | Filtre sur les noms de rubrique Amazon SNS. |
| SMSType | Filtre sur le type de SMS. Il peut être *promotionnel* ou *transactionnel*. |
## Métriques d'utilisation Amazon SNS
Amazon Simple Notification Service envoie les statistiques d'utilisation suivantes à CloudWatch.
| Namespace | Service | Métrique | Ressource | Type | Description |
| --- | --- | --- | --- | --- | --- |
| AWS/Utilisation | SNS | ResourceCount | NumberOfMessagesPublishedPerAccount | Ressource | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Utilisation | SNS | ResourceCount | ApproximateNumberOfTopics | Ressource | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Utilisation | SNS | ResourceCount | ApproximateNumberOfFilterPolicies | Ressource | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Utilisation | SNS | ResourceCount | ApproximateNumberOfPendingSubscriptions | Ressource | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Utilisation | SNS | CallCount | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sns/latest/dg/sns-monitoring-using-cloudwatch.html) | API | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |