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.
Vous pouvez utiliser Amazon CloudWatch et Amazon CloudWatch Logs pour surveiller la livraison de vos SMS.
Afficher les CloudWatch statistiques Amazon
Amazon SNS collecte automatiquement les statistiques relatives à la livraison de vos SMS 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 statistiques pour connaître votre taux de livraison de SMS et vos frais de month-to-date SMS.
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 rubriques Amazon SNS à l'aide de CloudWatch.
Affichage des CloudWatch journaux
Vous pouvez collecter des informations sur les envois de SMS réussis et infructueux en autorisant Amazon SNS à écrire sur Amazon CloudWatch Logs. Pour chaque SMS que vous envoyez, Amazon SNS écrit un journal qui inclut le prix du message, l'état de réussite ou d'échec, la cause d'échec (le cas échéant), la durée de conservation du message et d'autres informations.
Pour activer et afficher CloudWatch les journaux de vos messages SMS
Connectez-vous à la console Amazon SNS
. -
Dans le menu de la console, définissez le sélecteur de région sur une région prenant en charge la messagerie SMS.
-
Dans le panneau de navigation, choisissez Messages texte (SMS).
-
Sur la pageSMS mobile, dans la section Préférences de SMS, 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 livraisons de SMS réussies pour lesquelles Amazon SNS rédigera des journaux dans CloudWatch 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 écrit des journaux pour toutes les distributions 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 permettre à Amazon SNS d'accéder en écriture aux ressources de votre compte.
-
Pour utiliser un rôle de service existant, choisissez Utiliser le rôle de service existant, puis collez le nom ARN dans la case Rôle IAM pour les distributions ayant réussi et échoué.
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 rôles IAM, consultez la section Création d'un rôle pour un AWS service dans le Guide de l'utilisateur IAM.
-
-
Sélectionnez Enregistrer les modifications.
-
De retour sur la page Messagerie texte mobile (SMS), accédez à la section Journaux de l'état de distribution pour afficher tous les journaux disponibles.
Note
Selon l'opérateur du numéro de téléphone de destination, l'affichage des journaux de distribution peut durer jusqu'à 72 heures dans la console Amazon SNS.
Exemple de journal pour une distribution SMS réussie
Le journal de l'état de distribution pour une distribution SMS réussie se présente comme 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 pour une distribution SMS ayant échoué
Le journal de l'état de distribution pour une distribution SMS ayant échoué se présente comme 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"
}Causes d'échec de la distribution SMS
La cause d'un échec est fournie avec l'attribut providerResponse. La distribution des SMS risque d'échouer 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 a bloqué le 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
