Comment puis-je accéder aux journaux de livraison par rubrique Amazon SNS pour les SMS ?

Lecture de 4 minute(s)

Je souhaite accéder aux journaux de livraison par rubrique d’Amazon Simple Notification Service (Amazon SNS) pour les messages SMS.

Résolution

Configuration des attributs relatifs au statut de diffusion des SMS pour Amazon CloudWatch Logs

Remarque : au lieu d’effectuer les étapes suivantes dans la console, vous pouvez configurer le statut de diffusion des messages à l’aide des kits SDK AWS ou de l’interface de la ligne de commande AWS (AWS CLI). Si des erreurs surviennent lorsque vous exécutez des commandes AWS CLI, consultez la page Résoudre les erreurs liées à AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente d’AWS CLI.

Ouvrez la console Amazon SNS.
Dans le volet de navigation, développez ** Mobile**, puis choisissez Messagerie SMS.
Dans la section Préférences de SMS, choisissez Modifier.
Développez Journalisation du statut de diffusion - facultatif.
Pour Fréquence d’échantillonnage de réussite, dans la zone de texte %, saisissez 100.

Remarque : la fréquence de réussite représente le pourcentage des diffusions de messages réussies à enregistrer.
Dans la section Rôles IAM, pour le rôle de Service, sélectionnez Créer un nouveau rôle de service, puis choisissez Créer de nouveaux rôles. La console AWS Identity and Access Management (IAM) s’ouvre alors.

Remarque : si vous possédez déjà un rôle IAM doté des autorisations appropriées, utilisez ce rôle de service en sélectionnant Utiliser un rôle de service existant.
Sur la page de demande d’autorisation de la console IAM, choisissez Autoriser.
Une fois de retour à la console Amazon SNS, choisissez Enregistrer les modifications.

Cette action crée un rôle IAM pour les diffusions ayant abouti et échoué, avec la politique et les relations d’approbation suivantes pour Amazon SNS.

Rôle IAM :

arn:aws:iam::1111111111:role/SNSSuccessFeedback

Politique :

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:PutMetricFilter",
        "logs:PutRetentionPolicy"
      ],
      "Resource": [
        "*"
      ]
    }
  ]
}

Relations d’approbation :

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Affichage des journaux du statut de diffusion

Ouvrez la console Amazon CloudWatch.
Dans le volet de navigation, développez Journaux, puis choisissez Groupes de journaux.

Dans le filtre de recherche, saisissez DirectPublishToPhoneNumber pour rechercher uniquement les groupes de journaux relatifs aux SMS pour Amazon SNS.

Remarque : en fonction de l’opérateur du numéro de téléphone de destination, les journaux de diffusion peuvent prendre jusqu’à 72 heures pour apparaître dans la console Amazon SNS.

Exemple :

le groupe de journaux sns/your-AWS-region/your-AWS-account-ID/DirectPublishToPhoneNumber contient les journaux de messages diffusés :

sns/us-east-1/1111111111/DirectPublishToPhoneNumber

Exemples de journaux de messages diffusés :

{
  "notification": {
    "messageId": "34d9b400-c6dd-5444-820d-fbeb0f1f54cf",
    "timestamp": "2016-06-28 00:40:34.558"
  },
  "delivery": {
    "phoneCarrier": "My Phone Carrier",
    "mnc": 270,
    "destination": "+1XXX5550100",
    "priceInUSD": 0.00645,
    "smsType": "Transactional",
    "mcc": 310,
    "providerResponse": "Message has been accepted by phone carrier",
    "dwellTimeMs": 599,
    "dwellTimeMsUntilDeviceAck": 1344
  },
  "status": "SUCCESS"
}

Le groupe de journaux sns/your-AWS-region/your-AWS-account-ID/DirectPublishToPhoneNumber/Failure contient les journaux de messages non diffusés :

sns/us-east-1/1111111111/DirectPublishToPhoneNumber/Failure

Exemples de journaux de messages non diffusés :

{
  "notification": {
    "messageId": "1077257a-92f3-5ca3-bc97-6a915b310625",
    "timestamp": "2016-06-28 00:40:34.559"
  },
  "delivery": {
    "mnc": 0,
    "destination": "+1XXX5550100",
    "priceInUSD": 0.00645,
    "smsType": "Transactional",
    "mcc": 0,
    "providerResponse": "Unknown error attempting to reach phone",
    "dwellTimeMs": 1420,
    "dwellTimeMsUntilDeviceAck": 1692
  },
  "status": "FAILURE"
}

Choisissez le groupe de journaux SNS que vous souhaitez consulter.
Dans l’onglet Flux de journaux, choisissez un flux de journaux en particulier pour afficher les journaux de diffusion de SMS.
Pour voir le statut de diffusion de votre SMS, développez l’événement du journal et consultez l’élément providerResponse.

Afficher des numéros de téléphone désactivés

Les destinataires peuvent refuser de recevoir des SMS sur leur téléphone depuis leur compte AWS. Pour en savoir plus, consultez la page Désactivation de la réception des SMS.

Ouvrez la console Amazon SNS.
Dans le volet de navigation, développez la section Mobile, puis choisissez SMS.
Pour afficher les numéros de téléphone désactivés, rendez-vous dans la section Numéros de téléphone désactivés.