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 eventos do CloudWatch para publicação de eventos
Com as métricas do Amazon CloudWatch, você pode usar os destinos de eventos para publicar eventos de envio de e-mail do Amazon SES no CloudWatch. Uma vez que um destino de eventos do CloudWatch só pode ser configurado em um conjunto de configurações, primeiro é necessário criar um conjunto de configurações e, em seguida, adicionar o destino de evento ao conjunto de configurações.
Quando você adiciona um destino de eventos do CloudWatch a um conjunto de configurações, deve escolher uma ou mais dimensões do CloudWatch que correspondam às tags de mensagens que você usa ao enviar seus e-mails. Assim como as tags de mensagens, uma dimensão do CloudWatch é um par nome/valor que ajuda a identificar com exclusividade uma métrica.
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. Ao publicar os eventos de envio de e-mails no CloudWatch, é importante escolher as tags de mensagens e as dimensões, pois são opções que afetam seu faturamento do CloudWatch e determinam como você pode filtrar seus dados de evento de envio de e-mails no CloudWatch.
Esta seção apresenta informações para ajudá-lo a escolher as dimensões e mostra como adicionar um destino de evento do CloudWatch a um conjunto de configurações.
Adicionar um destino de evento do CloudWatch
O procedimento nesta seção mostra como adicionar detalhes do destino de eventos do CloudWatch a um conjunto de configurações e pressupõe que você tenha realizado as etapas de 1 a 6 em Criação de um destino de eventos.
Você também pode usar a operação UpdateConfigurationSetEventDestination na API V2 do Amazon SES para criar e modificar destinos de eventos.
Para adicionar detalhes do destino de eventos do CloudWatch a um conjunto de configurações usando o console
-
Estas são as instruções detalhadas para selecionar o CloudWatch como o tipo de destino de eventos na Etapa 7 e pressupõem que você tenha concluído as etapas anteriores no Criação de um destino de eventos. Depois de selecionar o Tipo de destino do CloudWatch, inserir o Nome do destino e habilitar a Publicação de eventos, o painel Dimensões do Amazon CloudWatch será exibido. Os respectivos campos são abordados nas etapas a seguir. (Sujeito a cobranças adicionais; consulte Preço por métrica para o CloudWatch.)
-
Para Value Source (Origem do valor), especifique como o Amazon SES obterá os dados que ele passa para o 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-TAGSou o parâmetro de APIEmailTags. 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.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 (_).
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-setpara 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. -
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-idouReturn-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?.
-
-
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 (_) ou traços (-). Espaços, caracteres acentuados, caracteres não latinos e outros caracteres especiais não são permitidos.
-
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 (_), traços (-), sinais de arroba (@) e pontos (.). Espaços, caracteres acentuados, caracteres não latinos e outros caracteres especiais não são permitidos.
-
Para adicionar mais dimensões, selecione Add Dimension (Adicionar dimensão). Caso contrário, escolha Next.
-
Na tela de revisão, se você estiver satisfeito com a forma como definiu o destino de eventos, escolha Add destination (Adicionar destino).
Escolha das dimensões do CloudWatch
Quando você escolher nomes e valores para usar como dimensões do CloudWatch, considere os seguintes fatores:
-
Preço por métrica: você pode visualizar as métricas básicas do Amazon SES no CloudWatch gratuitamente. No entanto, ao coletar métricas usando a publicação de eventos, você incorre em custos de Monitoramento detalhado do CloudWatch. Cada combinação única de tipo de evento, nome de dimensão e valor de dimensão cria uma métrica diferente no CloudWatch. Ao usar o Monitoramento detalhado do 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-domaindo Amazon SES, pois ela pode assumir muitos valores diferentes. Para obter mais informações, consulte Definição de preço do CloudWatch. -
Filtro de métrica: se uma métrica tiver várias dimensões, você não poderá acessar a métrica no CloudWatch com base em cada dimensão separadamente. Por esse motivo, pense cuidadosamente antes de adicionar mais de uma dimensão a um único destino de eventos do CloudWatch. Por exemplo, se desejar métricas por
campaigne por uma combinação decampaignegenre, você precisará adicionar dois destinos de eventos: um com apenascampaigncomo uma dimensão, e um comcampaignegenrecomo 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 (_), arrobas (@), hifens (-) e pontos (.). Se você especificar um nome ou valor contendo outros caracteres, a chamada de envio de e-mail ainda acontecerá, mas as métricas de eventos não serão enviadas para o Amazon CloudWatch.
Para obter mais informações sobre os conceitos do CloudWatch, consulte Conceitos do Amazon CloudWatch no Guia do usuário do Amazon CloudWatch.
