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

# Configurar um destino de CloudWatch evento para publicação de eventos
<a name="event-publishing-add-event-destination-cloudwatch"></a>

Com [ CloudWatch as métricas da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html), você pode usar destinos de eventos para publicar e-mails do Amazon SES enviando eventos para CloudWatch. Como um destino de CloudWatch evento só pode ser configurado em um conjunto de configurações, você deve primeiro [criar um conjunto de configurações](event-publishing-create-configuration-set.md) e, em seguida, adicionar o destino do evento ao conjunto de configurações.

Ao adicionar um destino de CloudWatch evento a um conjunto de configurações, você deve escolher uma ou mais CloudWatch *dimensões* que correspondam às tags de mensagem que você usa ao enviar seus e-mails. Assim como as tags de mensagem, uma CloudWatch dimensão é um name/value par que ajuda você a identificar uma métrica de forma exclusiva.

Por exemplo, você pode ter uma tag de mensagem e uma dimensão chamada `campaign`, que você usa para identificar sua campanha de e-mails. Quando você publica seus eventos de envio de e-mail em CloudWatch, escolher suas tags e dimensões de mensagem é importante porque essas escolhas afetam seu CloudWatch faturamento e determinam como você pode filtrar seus dados de eventos de envio de e-mail. CloudWatch

Esta seção fornece informações para ajudá-lo a escolher suas dimensões e, em seguida, mostra como adicionar um destino de CloudWatch evento a um conjunto de configurações.

**Topics**
+ [Adicionando um destino de CloudWatch evento](#event-publishing-add-event-destination-cloudwatch-add)
+ [Escolhendo CloudWatch dimensões](#event-publishing-add-event-destination-cloudwatch-dimensions)

## Adicionando um destino de CloudWatch evento
<a name="event-publishing-add-event-destination-cloudwatch-add"></a>

O procedimento nesta seção mostra como adicionar detalhes do destino do CloudWatch evento a um conjunto de configurações e pressupõe que você tenha concluído as etapas de 1 a 6 polegadas. [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add)

Você também pode usar a [UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)operação na API V2 do Amazon SES para criar e modificar destinos de eventos.

**Para adicionar detalhes CloudWatch do destino do evento a um conjunto de configurações usando o console**

1. Estas são as instruções detalhadas para selecionar CloudWatch como seu tipo de destino de evento na [Etapa 7](event-destinations-manage.md#specify-event-dest-step) e pressupõe que você tenha concluído todas as etapas anteriores. [Criação de um destino de eventos](event-destinations-manage.md#event-destination-add) Depois de selecionar o **tipo de CloudWatch destino**, inserir um **nome** de destino e ativar a **publicação de eventos**, o painel de ** CloudWatch dimensões da Amazon** é exibido — seus campos são abordados nas etapas a seguir. *(Cobranças adicionais se aplicam, consulte [Preço por métrica para CloudWatch](#cw-add-pricing).)* 

1. Em **Value Source**, especifique como o Amazon SES obterá os dados para os quais ele passa CloudWatch. As origens de valores a seguir estão disponíveis:
   + **Message Tag (Etiqueta de mensagem)**; o Amazon SES recupera o nome e o valor da dimensão de uma etiqueta que você especifica usando o cabeçalho `X-SES-MESSAGE-TAGS` ou o parâmetro de API `EmailTags`. Para obter mais informações sobre como usar tags de mensagem, consulte [Etapa 3: Especificar o conjunto de configurações no envio de e-mail](event-publishing-send-email.md).
**nota**  
Tags de mensagens podem incluir números de 0-9, as letras A-Z (letras maiúsculas e minúsculas), hífens (-) e sublinhados (\$1).

     Você também pode usar a origem do valor **Message Tag (Etiqueta de mensagem)** para criar dimensões com base nas etiquetas automáticas do Amazon SES. Para usar uma tag automática, digite o nome completo da tag automática como o **Dimension Name** (Nome da dimensão). Por exemplo, para criar uma dimensão com base no conjunto de configuração de tags automáticas, use `ses:configuration-set` para o **Dimension Name** (Nome da dimensão), e o nome do conjunto de configurações para o **Default Value** (Valor padrão). Para obter uma lista completa de tags automáticas, consulte [Como a publicação de eventos funciona com conjuntos de configurações e etiquetas de mensagem](monitor-using-event-publishing.md#event-publishing-how-works).
   + **Email Header (Cabeçalho de e-mail)**: o Amazon SES recupera o nome e o valor da dimensão de um cabeçalho no e-mail.
**nota**  
Nenhum dos cabeçalhos de e-mail a seguir pode ser usado como **Dimension Name**: `Received`, `To`, `From`, `DKIM-Signature`, `CC`, `message-id` ou `Return-Path`.
   + **Link Tag (Etiqueta de link)**: o Amazon SES recupera o nome e o valor da dimensão de uma etiqueta que você especificou em um link. Para obter mais informações sobre a adição de tags em links, consulte [Posso usar tags em links com identificadores exclusivos?](faqs-metrics.md#sending-metric-faqs-clicks-q5).

1. Em **Dimension Name (Nome da dimensão)**, digite o nome da dimensão que você deseja passar para o CloudWatch.
**nota**  
Os nomes de dimensão só podem conter letras ASCII (a - z, A - Z), números (0 - 9), sublinhados (\$1) ou traços (-). Espaços, caracteres acentuados, caracteres não latinos e outros caracteres especiais não são permitidos.

1. Em **Default Value** (Valor padrão), digite o valor da dimensão.
**nota**  
Os valores de dimensão só podem conter letras ASCII (a - z, A - Z), números (0 - 9), sublinhados (\$1), traços (-), sinais de arroba (@) e pontos (.). Espaços, caracteres acentuados, caracteres não latinos e outros caracteres especiais não são permitidos.

1. Para adicionar mais dimensões, selecione **Add Dimension** (Adicionar dimensão). Caso contrário, escolha **Next**.

1. Na tela de revisão, se você estiver satisfeito com a forma como definiu o destino de eventos, escolha **Add destination (Adicionar destino)**.

## Escolhendo CloudWatch dimensões
<a name="event-publishing-add-event-destination-cloudwatch-dimensions"></a>

Ao escolher nomes e valores para usar como CloudWatch dimensões, considere os seguintes fatores:
+ **Preço por métrica** — Você pode visualizar as métricas básicas do Amazon SES CloudWatch gratuitamente. No entanto, ao coletar métricas usando a publicação de eventos, você incorre em custos de [monitoramento CloudWatch detalhado](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-basic-detailed.html). Cada combinação exclusiva de tipo de evento, nome da dimensão e valor da dimensão cria uma métrica diferente em CloudWatch. Ao usar o Monitoramento detalhado CloudWatch, você é cobrado por cada métrica. Por esse motivo, você pode querer evitar a escolha de dimensões que tenham muitos valores diferentes. Por exemplo, a menos que esteja muito interessado em rastrear seus eventos de envio de e-mails pelo domínio de origem, talvez seja melhor não definir uma dimensão para a etiqueta automática `ses:from-domain` do Amazon SES, pois ela pode assumir muitos valores diferentes. Para obter mais informações, consulte [Preços do CloudWatch](https://aws.amazon.com/cloudwatch/pricing).
+ **Filtragem métrica** — Se uma métrica tiver várias dimensões, você não poderá acessá-la CloudWatch com base em cada dimensão separadamente. Por esse motivo, pense bem antes de adicionar mais de uma dimensão a um único destino de CloudWatch evento. Por exemplo, se desejar métricas por `campaign` e por uma combinação de `campaign` e `genre`, você precisará adicionar dois destinos de eventos: um com apenas `campaign` como uma dimensão, e um com `campaign` e `genre` como dimensões.
+ **Origem do valor da dimensão**: como alternativa para especificar os valores de dimensão usando cabeçalhos específicos do Amazon SES ou um parâmetro para a API, você também pode escolher que o Amazon SES extraia os valores de dimensão de seus próprios cabeçalhos de mensagens MIME. Você pode usar essa opção caso já esteja usando cabeçalhos personalizados e não queira alterar seus e-mails ou chamadas para a API de envio de e-mail para coletar métricas com base em seus valores de cabeçalho. Se você usa seus próprios cabeçalhos de mensagem MIME para a publicação de eventos do Amazon SES, os nomes e valores de cabeçalhos usados para a publicação de eventos do Amazon SES só podem incluir letras de A a Z, números de 0 a 9, sublinhados (\$1), arrobas (@), hifens (-) e pontos (.). Se você especificar um nome ou valor que contenha outros caracteres, a chamada de envio por e-mail ainda será bem-sucedida, mas as métricas do evento não serão enviadas para a Amazon CloudWatch.

Para obter mais informações sobre CloudWatch conceitos, consulte [Amazon CloudWatch Concepts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html) no *Guia CloudWatch do usuário da Amazon*.