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 SNS SMS livraisons Amazon avec les CloudWatch métriques et les journaux Amazon
Vous pouvez utiliser Amazon CloudWatch et Amazon CloudWatch Logs pour surveiller la livraison de vos SMS messages.
Rubriques
Afficher les CloudWatch statistiques d'Amazon
Amazon collecte SNS automatiquement des statistiques relatives à la livraison de vos SMS messages et les transmet à Amazon CloudWatch. Vous pouvez les utiliser CloudWatch pour surveiller ces mesures et créer des alarmes pour vous avertir lorsqu'une métrique franchit un seuil. Par exemple, vous pouvez surveiller CloudWatch les indicateurs pour connaître votre taux de SMS livraison et vos month-to-date SMS frais.
Pour plus d'informations sur la surveillance CloudWatch des métriques, le paramétrage des CloudWatch alarmes et les types de métriques disponibles, consultezSurveillance des SNS sujets Amazon à l'aide de CloudWatch.
Affichage des CloudWatch journaux
Vous pouvez collecter des informations sur les envois de SMS messages réussis et infructueux en autorisant Amazon SNS à écrire sur Amazon CloudWatch Logs. Pour chaque SMS message que vous envoyez, Amazon SNS rédige un journal qui inclut le prix du message, le statut de réussite ou d'échec, la raison de l'échec (en cas d'échec du message), le temps de séjour du message et d'autres informations.
Pour activer et afficher CloudWatch les journaux de vos SMS messages
Connectez-vous à la SNSconsole Amazon
. -
Dans le menu de la console, définissez le sélecteur de région sur une région qui prend en charge la SMS messagerie.
-
Dans le panneau de navigation, choisissez Messagerie texte (SMS).
-
Sur la page Messagerie texte mobile (SMS), dans la section des préférences de messagerie texte, choisissez Modifier.
-
Sur la page suivante, développez la section Journalisation de l'état de distribution.
-
Pour le taux d'échantillonnage de réussite, spécifiez le pourcentage de SMS livraisons réussies pour lesquelles Amazon SNS rédigera des CloudWatch journaux dans Logs. Par exemple :
-
Pour écrire des journaux uniquement pour les distributions qui ont échoué, définissez cette valeur sur 0.
-
Pour écrire des journaux pour 10 % des distributions qui ont réussi, définissez-la sur 10.
Si vous ne spécifiez pas de pourcentage, Amazon SNS rédige des journaux pour toutes les livraisons réussies.
-
-
Pour fournir les autorisations requises, utilisez une des méthodes suivantes :
-
Pour créer un nouveau rôle de service, choisissez Créer un nouveau rôle de service puis Créer de nouveaux rôles. Sur la page suivante, choisissez Autoriser pour autoriser Amazon à accéder en SNS écriture aux ressources de votre compte.
-
Pour utiliser un rôle de service existant, choisissez Utiliser un rôle de service existant, puis collez le ARN nom dans la case IAMRôle pour les livraisons réussies et échouées.
Le rôle de service que vous spécifiez doit autoriser l'accès en écriture aux ressources de votre compte. Pour plus d'informations sur la création de IAM rôles, voir Création d'un rôle pour un AWS service dans le Guide de IAM l'utilisateur.
-
-
Sélectionnez Enregistrer les modifications.
-
De retour sur la page Messagerie texte mobile (SMS), accédez à la section Journaux d'état de livraison pour consulter tous les journaux disponibles.
Note
Selon l'opérateur du numéro de téléphone de destination, l'affichage des journaux de livraison dans la SNS console Amazon peut prendre jusqu'à 72 heures.
Exemple de journal pour une SMS livraison réussie
Le journal de l'état de livraison d'une SMS livraison réussie ressemblera à l'exemple suivant :
{ "notification": { "messageId": "34d9b400-c6dd-5444-820d-fbeb0f1f54cf", "timestamp": "2016-06-28 00:40:34.558" }, "delivery": { "phoneCarrier": "My Phone Carrier", "mnc": 270, "numberOfMessageParts": 1, "destination": "+1XXX5550100", "priceInUSD": 0.00645, "smsType": "Transactional", "mcc": 310, "providerResponse": "Message has been accepted by phone carrier", "dwellTimeMs": 599, "dwellTimeMsUntilDeviceAck": 1344 }, "status": "SUCCESS" }
Exemple de journal en cas d'échec SMS de livraison
Le journal de l'état de livraison d'une SMS livraison échouée ressemblera à l'exemple suivant :
{ "notification": { "messageId": "1077257a-92f3-5ca3-bc97-6a915b310625", "timestamp": "2016-06-28 00:40:34.559" }, "delivery": { "mnc": 0, "numberOfMessageParts": 1, "destination": "+1XXX5550100", "priceInUSD": 0.00645, "smsType": "Transactional", "mcc": 0, "providerResponse": "Unknown error attempting to reach phone", "dwellTimeMs": 1420, "dwellTimeMsUntilDeviceAck": 1692 }, "status": "FAILURE" }
SMSraisons d'échec de livraison
La cause d'un échec est fournie avec l'attribut providerResponse. SMSles messages peuvent ne pas être livrés pour les raisons suivantes :
-
Il est bloqué en tant que courrier indésirable par l'opérateur de téléphonie
-
La destination est sur une liste bloquée
-
Le numéro de téléphone n'est pas valide
-
Le corps du message n'est pas valide
-
L'opérateur de téléphonie a bloqué ce message
-
L'opérateur de téléphonie est actuellement inaccessible/indisponible
-
Le téléphone est bloqué SMS
-
Le téléphone est sur une liste bloquée
-
Le téléphone est actuellement inaccessible/indisponible
-
Le numéro de téléphone est désactivé
-
Cette distribution entraînerait un dépassement du prix maximum
-
Erreur inconnue lors de la tentative d'accès au téléphone
