Ir para o conteúdo

Como acessar logs de entrega de tópicos do Amazon SNS para mensagens SMS?

4 minuto de leitura
0

Quero acessar os logs de entrega de tópicos do Amazon Simple Notification Service (Amazon SNS) para mensagens SMS.

Resolução

Configurar atributos de status de entrega de SMS para o Amazon CloudWatch Logs

Conclua as etapas a seguir:

  1. Abra o console do Amazon SNS.
  2. No painel de navegação, expanda Dispositivos móveis e, em seguida, selecione Mensagens de texto (SMS).
  3. Na seção Preferências de mensagens de texto, selecione Editar.
  4. Expanda Registro em log do status de entrega - opcional.
  5. Em Taxa de amostragem de êxito, na caixa de texto %, insira 100.
    Observação: a taxa de sucesso é a porcentagem de entregas bem-sucedidas de mensagens ao log.
  6. Na seção Perfis do IAM, em Perfil de serviço, selecione Criar novo perfil de serviço e, depois, selecione Criar novos perfis. O console do AWS Identity and Access Management (AWS IAM) será aberto.
    Observação: se você já tem um perfil do IAM com as permissões corretas, escolha Usar perfil de serviço existente.
  7. Na página de solicitação de permissão do console do IAM, selecione Permitir.
  8. Depois de retornar ao console do Amazon SNS, selecione Salvar alterações.

Isso cria um perfil do IAM para entregas bem-sucedidas e com falha, com a seguinte política e relações de confiança para o Amazon SNS.

Perfil do IAM:

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

Política:

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

Relações de confiança:

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

Exibir logs de status de entrega

Conclua as etapas a seguir:

  1. Abra o console do Amazon CloudWatch.

  2. No painel de navegação, escolha Logs e, em seguida, escolha Grupos de logs.

  3. Na caixa de pesquisa de filtro, insira DirectPublishToPhoneNumber para localizar apenas grupos de logs de SMS para o Amazon SNS.
    Observação: dependendo da operadora do número de telefone de destino, pode levar até 72 horas para que os logs de entrega apareçam no console do Amazon SNS.
    Por exemplo:
    O grupo de logs sns/your-AWS-region/your-AWS-account-ID/DirectPublishToPhoneNumber contém os logs de entregas bem-sucedidas:

    sns/us-east-1/1111111111/DirectPublishToPhoneNumber
    

    Exemplo de logs de entrega bem-sucedidos:

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

    O grupo de logs sns/your-AWS-region/your-AWS-account-ID/DirectPublishToPhoneNumber/Failure contém os logs de entregas com falha:

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

    Exemplo de logs de falha na entrega:

    {
        "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"
    }
  4. Escolha o grupo de logs do SNS que você deseja visualizar.

  5. Na guia Fluxos de logs, selecione um fluxo de logs específico para visualizar os logs de entrega de SMS.

  6. Para visualizar o status de entrega da sua mensagem SMS, expanda o evento de logs e marque providerResponse.

Exibir números de telefone cancelados

Os destinatários podem optar por não receber mensagens SMS em seus telefones a partir de suas contas da AWS. Para obter mais informações, consulte Opting out of receiving SMS messages.

Conclua as etapas a seguir:

  1. Abra o console do Amazon SNS.
  2. No painel de navegação, expanda a seção Dispositivo móvel e escolha Mensagens de texto (SMS).
  3. Para ver os números de telefone cancelados, acesse a seção Números de telefone cancelados.

Informações relacionadas

Monitoramento de tópicos do Amazon SNS usando o CloudWatch

Configuração de preferências de mensagens SMS no Amazon SNS

Monitoramento da entrega de SMS do Amazon SNS com métricas e logs do Amazon CloudWatch