Recuperando dados de eventos do Amazon SES de CloudWatch

O Amazon SES pode publicar métricas para seus eventos de envio de e-mail para a Amazon CloudWatch. Quando você publica dados de eventos no CloudWatch, ele fornece essas métricas como um conjunto ordenado de dados de séries temporais. Você pode usar essas métricas para monitorar a performance do envio de e-mails. Por exemplo, você pode monitorar a métrica de reclamação e definir um CloudWatch alarme para ser acionado quando a métrica exceder um determinado valor.

Há dois níveis de granularidade nos quais o Amazon SES pode publicar esses eventos: CloudWatch

• Em todo o seu Conta da AWS — Essas métricas gerais, que correspondem às métricas que você monitora usando o console do Amazon SES e a GetSendStatistics API, são totais em todo o seu. Conta da AWS O Amazon SES publica essas métricas CloudWatch automaticamente.

• Fine-grained (Refinadas): essas métricas são categorizadas por características de e-mail que você define usando etiquetas de mensagem. Para publicar essas métricas CloudWatch, você precisa configurar a publicação de eventos com um destino de CloudWatch evento e especificar um conjunto de configurações ao enviar um e-mail. Você também pode especificar etiquetas de mensagens ou usar as etiquetas automática que o Amazon SES fornece automaticamente.

Esta seção descreve as métricas disponíveis e como visualizá-las em CloudWatch.

Métricas disponíveis

Você pode publicar as seguintes métricas de envio de e-mail do Amazon SES para CloudWatch:

• Send (Envio): a solicitação de envio foi bem-sucedida e o Amazon SES tentará entregar a mensagem ao servidor de e-mail do destinatário. (Se a supressão global ou no nível da conta estiver sendo usada, o SES ainda contará como um envio, mas a entrega está suprimida.)

• RenderingFailure— O e-mail não foi enviado devido a um problema de renderização do modelo. Esse tipo de evento pode ocorrer quando estão faltando dados no modelo ou quando há uma incompatibilidade entre os parâmetros e os dados do modelo. (Esse tipo de evento só ocorre quando você envia e-mails usando as operações de API SendTemplatedEmail ou SendBulkTemplatedEmail)

• Reject (Rejeição): o Amazon SES aceitou o e-mail, mas determinou que ele continha um vírus e não tentou entregá-lo ao servidor de e-mail do destinatário.

• Delivery (Entrega): o Amazon SES entregou com êxito o e-mail ao servidor de e-mail do destinatário.

• Devolução: uma devolução definitiva em que o servidor de e-mail do destinatário rejeitou permanentemente o e-mail. (Os soft bounces só são incluídos quando o SES não está mais tentando entregar o e-mail novamente. Geralmente, esses soft bounces indicam uma falha na entrega, embora em alguns casos um soft bounce possa ser devolvido mesmo quando o e-mail chega à caixa de entrada do destinatário com sucesso. Isso geralmente ocorre quando o destinatário envia uma resposta out-of-office automática. Saiba mais sobre soft bounces neste artigo do AWS re:POST.)

• Complaint (Reclamação): o e-mail foi entregue com sucesso ao servidor de e-mail do destinatário, mas o destinatário marcou-o como spam.

• DeliveryDelay— O e-mail não pôde ser entregue ao servidor de e-mail do destinatário porque ocorreu um problema temporário. Atrasos de entrega podem ocorrer, por exemplo, quando a caixa de entrada do destinatário está cheia ou quando o servidor de recebimento de e-mail enfrenta um problema transitório.

• Subscription (Assinatura): o e-mail foi entregue com êxito, mas o destinatário atualizou as preferências de assinatura clicando em List-Unsubscribe no cabeçalho do e-mail ou no link Unsubscribe no rodapé.

• Open (Abertura): o destinatário recebeu a mensagem e a abriu em seu cliente de e-mail.

• Click (Clique): o destinatário clicou em um ou mais links no e-mail.

Dimensões disponíveis

CloudWatch usa os nomes de dimensão que você especifica ao adicionar um destino de CloudWatch evento a um conjunto de configurações no Amazon SES. Para ter mais informações, consulte Configurar um destino de CloudWatch evento para publicação de eventos.

Visualização de métricas do Amazon SES no CloudWatch console

O procedimento a seguir descreve como visualizar suas métricas de publicação de eventos do Amazon SES usando o CloudWatch console.

Para visualizar métricas usando o CloudWatch console

1. Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. Se necessário, altere a região. Na barra de navegação, selecione a região em que seus AWS recursos residem. Para mais informações, consulte Regiões e endpoints da .

3. No painel de navegação, escolha Todas as métricas.

4. No painel Métricas, selecione SES.

5. Escolha a métrica que você deseja visualizar. Para visualizar métricas detalhadas de publicação de eventos, escolha a combinação de dimensões que você especificou ao configurar o CloudWatch destino do evento. Para saber mais sobre a visualização de métricas com CloudWatch, consulte Usar CloudWatch métricas da Amazon.

Para visualizar métricas usando o AWS CLI

• Em um prompt de comando, use o seguinte comando:

  aws cloudwatch list-metrics --namespace "AWS/SES"