Como faço para acessar os registros de entrega de tópicos do Amazon SNS para notificações push?

Breve descrição

O Amazon SNS fornece suporte para registrar o status de entrega das mensagens de notificação push enviadas aos tópicos. Depois de configurar os atributos do status de entrega da mensagem, as entradas de log são enviadas para o Amazon CloudWatch Logs para essas mensagens de notificação push. O registro do status de entrega de mensagens fornece os seguintes insights operacionais:

• Saiba se uma mensagem foi entregue ao endpoint do Amazon SNS.
• Identifique a resposta enviada do endpoint do Amazon SNS para o Amazon SNS.
• Determine o tempo de permanência da mensagem (o tempo entre a data e hora de publicação e pouco antes da entrega para um endpoint do Amazon SNS).

Configurar registros de status de entrega de notificações push

A seção a seguir fornece etapas para configurar o registro do status de entrega usando o AWS Management Console. Você também pode usar os SDKs da AWS ou a AWS Command Line Interface (AWS CLI) para configurar os logs de entrega de mensagens.
Observação: se você receber erros ao executar comandos da AWS CLI, consulte Solucionar erros da AWS CLI. Além disso, certifique-se que você está usando a versão mais recente da AWS CLI.

Realize as etapas a seguir:

1. Abra o console do Amazon SNS.
2. No menu de navegação, expanda Celular e escolha Notificações push.
3. Na seção Aplicativos da plataforma, selecione o aplicativo da plataforma para o qual você deseja ter o status de entrega.
4. Selecione Editar.
5. Registro do status de entrega: opcional.
6. Em Taxa de amostragem de sucesso, insira a porcentagem de mensagens bem-sucedidas para as quais você deseja receber o CloudWatch Logs. Todas as entregas com falha são registradas por padrão.
7. Na seção Funções do IAM, em Função de serviço, selecione Criar nova função de serviço e escolha Criar novas funções.  Abra o console do AWS Identity and Access Management (IAM).
   Observação: se você já tem uma função do IAM com as permissões corretas, pode usar essa função de serviço selecionando Usar função de serviço existente.
8. Na página de solicitação de permissão do console IAM, escolha Permitir para conceder acesso de gravação ao Amazon SNS para usar o CloudWatch Logs em seu nome.
9. Depois de retornar ao console do Amazon SNS, escolha Salvar alterações.

Isso cria uma função do IAM para entregas bem-sucedidas e com falha, com as seguintes políticas e relações de confiança para o Amazon SNS.

Função do IAM para entregas bem-sucedidas:

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

Função do IAM para entregas com falha:

arn:aws:iam::1111111111:role/SNSFailureFeedback

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 registros de status de entrega de notificações push

1. Abra o console do Amazon CloudWatch.

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

3. Na caixa de pesquisa Filtro, digite sns para encontrar somente grupos de log para o Amazon SNS.

4. O grupo de logs sns/your-AWS-region/your-account_ID/app/platform_name/application_name contém os registros de entrega bem-sucedidos.

   sns/us-east-1/1111111111/app/GCM/Test1
   sns/us-east-1/1111111111/app/APNS_SANDBOX/Test2
   sns/us-east-1/1111111111/app/APNS/Test3

   O grupo de logs sns/your-AWS-region/your-account_ID/app/platform_name/application_name**/Failure** contém os registros de falha na entrega:

   sns/us-east-1/1111111111/app/GCM/Test1/Failure
   sns/us-east-1/1111111111/app/APNS_SANDBOX/Test2/Failure
   sns/us-east-1/1111111111/app/APNS/Test3/Failure

5. Escolha o grupo de logs do Amazon SNS que você deseja visualizar.

6. Na guia Fluxos de Log, selecione um fluxo de log específico para visualizar os registros de entrega do endpoint do aplicativo.

7. Para ver o status de entrega da sua mensagem, expanda o evento de log e marque providerResponse. Para obter uma lista dos códigos de resposta do serviço de notificação push, consulte Códigos de resposta da plataforma.

Informações relacionadas

Como soluciono falhas de notificação push FCM para dispositivos móveis no Amazon SNS?

Como soluciono falhas de notificação push APNs para dispositivos móveis no Amazon SNS?

Atributos do aplicativo móvel