Monitorar entregas de SMS do Amazon SNS com métricas e logs do Amazon CloudWatch - Amazon Simple Notification Service
Visualizar métricas do Amazon CloudWatchVisualizar logs do CloudWatchExemplo de log para entrega de SMS bem-sucedida Exemplo de log para entrega de SMS com falhaMotivos para falha de entrega de SMS

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Monitorar entregas de SMS do Amazon SNS com métricas e logs do Amazon CloudWatch

É possível usar o Amazon CloudWatch e o Amazon CloudWatch Logs para monitorar as entregas de mensagens SMS.

Visualizar métricas do Amazon CloudWatch

O Amazon SNS coleta automaticamente as métricas sobre suas entregas de mensagens SMS e as envia ao Amazon CloudWatch. É possível usar o CloudWatch para monitorar essas métricas e criar alertas para avisá-lo quando uma métrica ultrapassar um limite. Por exemplo, você pode monitorar as métricas do CloudWatch para saber a taxa de entrega de SMS e seus encargos de SMS acumulados no mês.

Para obter informações sobre o monitoramento das métricas do CloudWatch, dos alarmes do CloudWatch e das métricas disponíveis, consulte Monitorar tópicos do Amazon SNS usando o CloudWatch.

Visualizar logs do CloudWatch

É possível coletar informações sobre entregas de mensagens SMS bem ou malsucedidas permitindo que o Amazon SNS grave dados no Amazon CloudWatch Logs. Para cada mensagem SMS que você enviar, o Amazon SNS gravará um log que inclui o preço da mensagem, o status de sucesso ou falha, o motivo da falha (se a mensagem falhou), o tempo de permanência da mensagem e outras informações.

Para habilitar e visualizar o CloudWatch Logs para suas mensagens SMS

  1. Faça login no console do Amazon SNS.

  2. No menu do console, defina a seleção de região para uma região que comporte mensagens SMS.

  3. No painel de navegação, escolha Text messaging (SMS) [Mensagens de texto (SMS)].

  4. Na página Mobile text messaging (SMS) [Mensagens de texto (SMS) em dispositivos móveis], na seção Text messaging preferences (Preferências de mensagens de texto), escolha Edit (Editar).

  5. Na página seguinte, expanda a seção Registro do status da entrega.

  6. Em Taxa de amostragem de êxito, especifique a porcentagem de entregas de SMS bem-sucedidas para as quais o Amazon SNS gravará logs no CloudWatch Logs. Por exemplo:

    • Para gravar logs somente para entregas com falha, defina esse valor como 0.

    • Para gravar logs para 10% de suas entregas bem-sucedidas, defina o valor como 10.

    Se você não especificar uma porcentagem, o Amazon SNS gravará logs para todas as entregas bem-sucedidas.

  7. Para fornecer as permissões necessárias, use uma das seguintes opções:

    • Para criar um novo perfil de serviço, escolha Criar novo perfil de serviço e, em seguida, Criar novos perfis. Na página seguinte, escolha Permitir para que o Amazon SNS tenha acesso de gravação aos recursos de sua conta.

    • Para usar um perfil de serviço existente, escolha Usar perfil de serviço existente e, em seguida, cole o ARN na caixa Perfil do IAM para entregas bem-sucedidas e com falha.

      A perfil de serviço especificado deve permitir acesso de gravação aos recursos de sua conta. Para obter mais informações sobre como criar funções do IAM, consulte Criar uma função para um serviço da AWS no Guia do usuário do IAM.

  8. Escolha Save changes (Salvar alterações).

  9. Novamente na página Mensagens de texto para dispositivos móveis (SMS), acesse a seção Logs de status de entrega para exibir todos os logs disponíveis.

    nota

    Dependendo da operadora do número de telefone de destino, pode demorar até 72 horas para que os logs de entrega apareçam no console do Amazon SNS.

Exemplo de log para entrega de SMS bem-sucedida

O log de status de entrega para uma entrega de SMS bem-sucedida será semelhante ao exemplo a seguir:

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

Exemplo de log para entrega de SMS com falha

O log de status de entrega para uma entrega de SMS com falha será semelhante ao exemplo a seguir:

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

Motivos para falha de entrega de SMS

O motivo da falha é fornecido com o atributo providerResponse. As mensagens SMS podem não ser entregues pelos seguintes motivos:

  • Bloqueada como spam pela operadora de telefonia

  • O destino está em uma lista bloqueada

  • Número de telefone inválido

  • O corpo da mensagem é inválido

  • A operadora de telefonia bloqueou essa mensagem

  • A operadora de telefonia está inacessível/indisponível no momento

  • O telefone bloqueou SMS

  • O telefone está em uma lista bloqueada

  • O telefone está inacessível/indisponível no momento

  • O número de telefone solicitou o cancelamento do recebimento

  • Essa entrega excede o preço máximo

  • Erro desconhecido ao tentar entrar em contato com o telefone