Recuperação de dados de eventos do Amazon SES a partir do CloudWatch - Amazon Simple Email Service

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á.

Recuperação de dados de eventos do Amazon SES a partir do CloudWatch

O Amazon SES pode publicar métricas para seus eventos de envio de e-mail no 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 alarme do CloudWatch para ser acionado quando a métrica exceder determinado valor.

O Amazon SES pode publicar esses eventos no CloudWatch com dois níveis de detalhes:

  • Em toda a sua Conta da AWS: essas métricas aproximadas, que correspondem às métricas que você monitora usando o console do Amazon SES e a API GetSendStatistics, refletem os totais de toda a sua Conta da AWS. O Amazon SES publica automaticamente essas métricas no CloudWatch.

  • 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 no CloudWatch, você tem que configurar a publicação de eventos com um destino de eventos do CloudWatch 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 no CloudWatch.

Métricas disponíveis

Você pode publicar as seguintes métricas de e-mail do Amazon SES no 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. (As falhas de entrega temporárias só são incluídas quando o SES não tenta mais entregar o e-mail. Em geral, essas falhas de entrega temporárias indicam uma falha na entrega, embora em alguns casos uma falha de entrega temporária possa ser retornada mesmo quando o e-mail chega à caixa de entrada do destinatário com sucesso. Isso ocorre geralmente quando o destinatário envia uma resposta automática de ausência do escritório. Saiba mais sobre falhas de entrega temporárias 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 foi 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

O CloudWatch usa os nomes de dimensão que você especifica quando adiciona um destino de eventos do CloudWatch a um conjunto de configurações definido no Amazon SES. Para obter mais informações, consulte Configurar um destino de eventos do CloudWatch para publicação de eventos.

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

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

Como visualizar métricas usando o console do CloudWatch
  1. Faça login no Console de gerenciamento da AWS e abra o console do CloudWatch 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 os seus recursos da AWS residem. Para obter mais informações, consulte Regiões e endpoints.

  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 ver as métricas de publicação de eventos refinadas, escolha a combinação de dimensões que você especificou quando configurou seu destino de eventos do CloudWatch. Para saber mais sobre a visualização de métricas com o CloudWatch, consulte Usar métricas do Amazon CloudWatch.

Para visualizar métricas usando o AWS CLI
  • Em um prompt de comando, use o seguinte comando:

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