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á.
# Monitoramento de entrega de SMS do Amazon SNS com CloudWatch métricas e registros da Amazon
Você pode usar a Amazon CloudWatch e o Amazon CloudWatch Logs para monitorar suas entregas de mensagens SMS.
## Visualizando CloudWatch métricas da Amazon
O Amazon SNS coleta automaticamente métricas sobre suas entregas de mensagens SMS e as envia para a Amazon. CloudWatch Você pode usar CloudWatch para monitorar essas métricas e criar alarmes para alertá-lo quando uma métrica ultrapassa um limite. Por exemplo, você pode monitorar CloudWatch métricas para saber sua taxa de entrega de SMS e suas cobranças de month-to-date SMS.
Para obter informações sobre CloudWatch métricas de monitoramento, configuração de CloudWatch alarmes e os tipos de métricas disponíveis, consulte[Monitorando tópicos do Amazon SNS usando CloudWatch](sns-monitoring-using-cloudwatch.md).
## Visualizando CloudWatch registros
Você pode coletar informações sobre entregas de mensagens SMS bem-sucedidas e malsucedidas ao permitir que o Amazon SNS grave no Amazon Logs. CloudWatch 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 ativar e visualizar CloudWatch os registros de suas mensagens SMS**
1. Faça login no [console do Amazon SNS](https://console.aws.amazon.com/sns/home).
1. No menu do console, defina a seleção de região para uma [região que comporte mensagens SMS](https://docs.aws.amazon.com/general/latest/gr/end-user-messaging.html).
1. No painel de navegação, escolha **Text messaging (SMS) [Mensagens de texto (SMS)]**.
1. 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)**.
1. Na página seguinte, expanda a seção **Registro do status da entrega**.
1. Para **taxa de amostragem de sucesso**, especifique a porcentagem de entregas de SMS bem-sucedidas para as quais o Amazon SNS gravará registros em registros CloudWatch . 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.
1. 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 a criação de funções do IAM, consulte [Como criar uma função para um AWS serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html#roles-creatingrole-service-console) no *Guia do usuário do IAM*.
1. Escolha **Salvar alterações**.
1. 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