How do I access Amazon SNS topic delivery logs for SMS messages?

4 minute read

I want to access Amazon Simple Notification Service (Amazon SNS) topic delivery logs for SMS messages.

Resolution

Configure SMS delivery status attributes for Amazon CloudWatch Logs

Note: As an alternative to the following console steps, you can configure message delivery status using AWS SDKs or the AWS Command Line Interface (AWS CLI). If you receive errors when running AWS CLI commands, then see Troubleshoot AWS CLI errors. Also, make sure that you're using the most recent AWS CLI version.

Open the Amazon SNS console.
On the navigation pane, expand Mobile, and then choose Text messaging (SMS).
In the Text messaging preferences section, choose Edit.
Expand Delivery status logging - optional.
For Success sample rate, in the % text box, enter 100.

Note: Success rate is the percentage of successful message deliveries to log.
In the IAM roles section, for Service role, select Create new service role, and then choose Create new roles. The AWS Identity and Access Management (IAM) console opens.

Note: If you already have an IAM role with the right permissions, then use that service role by selecting Use existing service role instead.
On the IAM console permission request page, choose Allow.
After returning to the Amazon SNS console, choose Save changes.

This creates an IAM role for successful and failed deliveries, with the following policy and trust relationships for Amazon SNS.

IAM role:

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

Policy:

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

Trust relationships:

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

View delivery status logs

Open the Amazon CloudWatch console.
On the navigation pane, expand Logs, and then choose Log groups.

In the Filter search box, enter DirectPublishToPhoneNumber to find only SMS log groups for Amazon SNS.

Note: Depending on the destination phone number's carrier, it can take up to 72 hours for delivery logs to appear in the Amazon SNS console.

For example:

The sns/your-AWS-region/your-AWS-account-ID/DirectPublishToPhoneNumber log group contains the successful delivery logs:

sns/us-east-1/1111111111/DirectPublishToPhoneNumber

Sample successful delivery logs:

{
  "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"
}

The sns/your-AWS-region/your-AWS-account-ID/DirectPublishToPhoneNumber/Failure log group contains the failure delivery logs:

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

Sample failure delivery logs:

{
  "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"
}

Choose the SNS log group that you want to view.
On the Log streams tab, choose a particular log stream to view the SMS delivery logs.
To see the delivery status of your SMS message, expand the log event and check providerResponse.

View opted-out phone numbers

Recipients can opt out of receiving SMS messages on their phones from their AWS account. For more information, see Opting out of receiving SMS messages.

Open the Amazon SNS console.
On the navigation pane, expand the Mobile section, and then choose Text Messaging (SMS).
To view opted-out phone numbers, go to the Opted-out phone numbers section.