

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

# Recuperando dados de eventos do Amazon SES de CloudWatch
<a name="event-publishing-retrieving-cloudwatch"></a>

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](monitor-sending-using-event-publishing-setup.md) com um destino de CloudWatch evento e [especificar um conjunto de configurações](event-publishing-send-email.md) ao enviar um e-mail. Você também pode especificar etiquetas de mensagens ou usar as [etiquetas automática](monitor-using-event-publishing.md#event-publishing-how-works) 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
<a name="event-publishing-retrieving-cloudwatch-metrics"></a>

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 [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html) ou [https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html))
+ **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](https://repost.aws/knowledge-center/ses-understand-soft-bounces).)
+ **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
<a name="event-publishing-retrieving-cloudwatch-dimensions"></a>

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 obter mais informações, consulte [Configurar um destino de CloudWatch evento para publicação de eventos](event-publishing-add-event-destination-cloudwatch.md).

## Visualização de métricas do Amazon SES no CloudWatch console
<a name="event-publishing-retrieving-cloudwatch-console"></a>

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 Console de gerenciamento da AWS e abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. 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 ](https://docs.aws.amazon.com/general/latest/gr/rande.html).

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

1. No painel **Métricas**, selecione **SES.**

1. Escolha a métrica que você deseja visualizar. Para ver [métricas de publicação de eventos](monitor-using-event-publishing.md) minuciosas, selecione a combinação de dimensões especificada ao [configurar seu evento de destino do CloudWatch](event-publishing-add-event-destination-cloudwatch.md). Para saber mais sobre a visualização de métricas com CloudWatch, consulte [Usar CloudWatch métricas da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html).

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

  ```
  1. aws cloudwatch list-metrics --namespace "AWS/SES"
  ```