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

Observação: como alternativa às etapas de console a seguir, é possível configurar o status de entrega de mensagens usando os SDKs da AWS ou a AWS Command Line Interface (AWS CLI). Se você receber erros ao executar comandos da AWS CLI, consulte Solucionar erros da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

  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 (IAM) será aberto.

    Observação: se você já tiver um perfil do IAM com as permissões adequadas, use esse perfil de serviço selecionando 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

  1. Abra o console do Amazon CloudWatch.

  2. No painel de navegação, expanda Logs e, depois, selecione 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

    Exemplos de logs de entregas bem-sucedidas:

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

    Exemplos de logs de entregas com falha:

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

  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 das preferências de mensagens SMS

Visualizar métricas e logs do Amazon CloudWatch para entregas de SMS

AWS OFICIAL
AWS OFICIALAtualizada há 4 meses