Registrar em log as chamadas de API do Amazon Pinpoint com o AWS CloudTrail - Amazon Pinpoint

Aviso de fim do suporte: em 30 de outubro de 2026, a AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para acessar mais informações, consulte Amazon Pinpoint end of support. Observação: as APIs relacionadas a SMS, voz, notificações push para dispositivos móveis, OTP e validação de número de telefone não são afetadas por essa alteração e são compatíveis com o AWS End User Messaging.

Registrar em log as chamadas de API do Amazon Pinpoint com o AWS CloudTrail

O Amazon Pinpoint é integrado ao AWS CloudTrail, um serviço que fornece um registro de ações que foram executadas por um usuário, perfil ou serviço da AWS no Amazon Pinpoint. O CloudTrail captura as chamadas de API para o Amazon Pinpoint como eventos. As chamadas capturadas incluem as chamadas do console do Amazon Pinpoint e as chamadas de código para as operações da API do Amazon Pinpoint.

Se você criar uma trilha, poderá habilitar a entrega contínua de eventos do CloudTrail para um bucket do Amazon Simple Storage Service (Amazon S3), incluindo eventos para o Amazon Pinpoint. Se você não configurar uma trilha, ainda poderá visualizar os eventos mais recentes no console do CloudTrail em Histórico de eventos. Usando as informações coletadas pelo CloudTrail, é possível determinar a solicitação feita para o Amazon Pinpoint, o endereço IP no qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita, além de detalhes adicionais.

Para saber mais sobre o CloudTrail, incluindo como configurá-lo e ativá-lo, consulte o AWS CloudTrail Guia do usuário do.

Informações sobre o Amazon Pinpoint no CloudTrail

O CloudTrail é habilitado em sua conta AWS ao criá-la. Quando uma atividade de evento compatível ocorre no Amazon Pinpoint, ela é registrada em um evento do CloudTrail juntamente com outros eventos de serviços da AWS no Histórico de eventos. É possível visualizar, pesquisar e baixar eventos recentes em sua AWS conta. Para obter mais informações, consulte Viewing events with CloudTrail event history.

Para obter um registro de eventos em andamento na sua conta da AWS, incluindo eventos do Amazon Pinpoint, crie uma trilha. Uma trilha permite que o CloudTrail entregue arquivos de log a um bucket do Amazon S3. Por padrão, quando uma trilha é criada no console, a mesma é aplicada a todas as regiões da AWS. A trilha registra logs de eventos de todas as Regiões na AWS divisória e entrega os arquivos do log para o bucket Amazon S3 especificado. Além disso, é possível configurar outros AWS serviços para melhor analisar e agir de acordo com dados coletados do evento nos logs CloudTrail. Para obter mais informações, consulte:

Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar:

  • Se a solicitação foi feita com credenciais de usuário da raiz ou do AWS Identity and Access Management.

  • Se a solicitação foi feita com credenciais de segurança temporárias de uma função ou de um usuário federado.

  • Se a solicitação foi feita por outro serviço da AWS.

Para obter mais informações, consulte Elemento userIdentity do CloudTrail.

Você poder criar uma trilha e armazenar os arquivos de log no bucket do Amazon S3 pelo tempo que quiser. Além disso, você pode definir as regras de ciclo de vida do Amazon S3 para arquivar ou excluir os arquivos de log automaticamente. Por padrão, os arquivos de log são criptografados com criptografia do lado do servidor (SSE) do Amazon S3.

Para ser notificado sobre a entrega do arquivo de log, configure o CloudTrail para publicar notificações do SNS quando novos arquivos de log forem entregues. Para obter mais informações, consulte Configurar notificações do Amazon SNS para o CloudTrail.

Também é possível agregar arquivos de log do Amazon Pinpoint de várias Regiões e contas da AWS em um único bucket do Amazon S3. Para obter mais informações, consulte Recebimento de arquivos de log do CloudTrail de várias regiões e Recebimento de arquivos de log do CloudTrail de várias contas.

Você pode usar o CloudTrail para registrar em log ações para as seguintes APIs do Amazon Pinpoint: