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

Breve descrição

O Amazon SNS fornece suporte para registrar em log o status de entrega das mensagens de notificação por 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 por push. O registro em log do status de entrega de mensagens fornece os seguintes insights operacionais:

• Saber se uma mensagem foi entregue ao endpoint do Amazon SNS.
• Identificar a resposta enviada do endpoint do Amazon SNS para o Amazon SNS.
• Identificar 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).

Configure logs de status de entrega de notificações por push

A seção a seguir fornece etapas para configurar o registro em log do status de entrega usando o Console de gerenciamento da AWS. Também é possível 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 mensagens de erro ao executar comandos da AWS CLI, consulte Solução de problemas da AWS CLI. Além disso, certifique-se que você está usando a versão mais recente da AWS CLI.

Conclua as etapas a seguir:

1. Abra o console do Amazon SNS.
2. No menu de navegação, expanda Celular e clique em Notificações por push.
3. Na seção Aplicações da plataforma, selecione a aplicação da plataforma da qual você deseja ter o status de entrega.
4. Clique em Editar.
5. Registro em log 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 em log por padrão.
7. Na seção Perfis do IAM, em Perfil de serviço, selecione Criar novo perfil de serviço e clique em Criar novos perfis. O console do AWS Identity and Access Management (AWS IAM) é aberto.
   Observação: se você já tem um perfil do IAM com as permissões corretas, é possível usar esse perfil de serviço selecionando Usar perfil de serviço existente.
8. Na página de solicitação de permissão do console do IAM, clique em 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, 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 no Amazon SNS.

Perfil do IAM para entregas bem-sucedidas:

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

Perfil 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"
    }
  ]
}

Verifique os logs de status de entrega de notificações por push

1. Abra o console do Amazon CloudWatch.

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

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

4. O grupo de logs sns/your-AWS-region/your-account_ID/app/platform_name/application_name contém os logs 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 logs com 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. Selecione o grupo de logs do Amazon SNS que você deseja visualizar.

6. Na guia Fluxos de logs, selecione um fluxo de logs específico para visualizar os logs de entrega do endpoint da aplicação.

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

Informações relacionadas

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

How do I troubleshoot APNs mobile push notification failures in Amazon SNS? (Como soluciono falhas de notificação por push móveis do APNs no Amazon SNS?)

Atributos de aplicativo móvel do Amazon SNS