Configurar um destino de CloudWatch evento para publicação de eventos

Com CloudWatch as métricas da Amazon, 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 e depois 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 par nome/valor 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.

Adicionar um destino de evento do CloudWatch

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

Você também pode usar a operação UpdateConfigurationSetEventDestino 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 o tipo de destino do evento na Etapa 7 e pressupõe que você tenha concluído todas as etapas anteriores. Criação de um destino de eventos 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.)

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

     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-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 tags de mensagens.

   • 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?.

3. Em Nome da Dimensão, digite o nome da dimensão para a qual você deseja passar 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.

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

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

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

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

• 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 (_), 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 no Guia CloudWatch do usuário da Amazon.