Configurar un destino de CloudWatch evento para la publicación de eventos

Con CloudWatch las métricas de Amazon, puedes usar los destinos de los eventos para publicar los eventos de envío de correos electrónicos de Amazon SES CloudWatch. Como el destino de un CloudWatch evento solo se puede configurar en un conjunto de configuraciones, primero debe crear un conjunto de configuración y, a continuación, añadir el destino del evento al conjunto de configuraciones.

Al añadir un destino de CloudWatch eventos a un conjunto de configuraciones, debe elegir una o más CloudWatch dimensiones que se correspondan con las etiquetas de los mensajes que utiliza al enviar los correos electrónicos. Al igual que las etiquetas de los mensajes, una CloudWatch dimensión es un par de nombre/valor que le ayuda a identificar una métrica de forma única.

Por ejemplo, podría tener una etiqueta de mensajes y una dimensión denominada campaign que usa para identificar su campaña de correo electrónico. Cuando publicas tus eventos de envío de correo electrónico CloudWatch, es importante elegir las etiquetas y dimensiones de los mensajes, ya que estas elecciones afectan a tu CloudWatch facturación y determinan cómo puedes filtrar los datos de los eventos de envío de correo electrónico. CloudWatch

En esta sección se proporciona información que le ayudará a elegir las dimensiones y, a continuación, se muestra cómo añadir un destino de CloudWatch evento a un conjunto de configuraciones.

Añadir un destino de eventos de CloudWatch

El procedimiento de esta sección muestra cómo añadir los detalles del destino CloudWatch del evento a un conjunto de configuraciones y supone que ha completado los pasos 1 a 6 que se indican más adelanteCrear un destino de eventos.

También puede usar la operación UpdateConfigurationSetEventDestination en la API V2 de Amazon SES para crear y modificar los destinos de los eventos.

Para añadir los detalles CloudWatch del destino del evento a un conjunto de configuraciones mediante la consola

1. Estas son las instrucciones detalladas para seleccionar CloudWatch el tipo de destino del evento en el paso 7 y se supone que ha completado todos los pasos anterioresCrear un destino de eventos. Tras seleccionar el tipo de CloudWatch destino, introducir un nombre de destino y activar la publicación de eventos, se muestra el panel de CloudWatch dimensiones de Amazon, cuyos campos se abordan en los siguientes pasos. (Se aplican cargos adicionales; consulte el precio por métrica para ver.) CloudWatch

2. En Value Source, especifique cómo obtendrá Amazon SES los datos a los que pasa CloudWatch. Están disponibles los siguientes orígenes de valores:

   • Message Tag (Etiqueta de mensaje): Amazon SES recupera el nombre y el valor de la dimensión de una etiqueta que especifica utilizando el encabezado X-SES-MESSAGE-TAGS o el parámetro de la API EmailTags. Para obtener más información acerca del uso de etiquetas de mensaje, consulte Paso 3: Especifique el conjunto de configuración cuando envía correo electrónico.

     nota

     Las etiquetas de mensaje pueden incluir los números del 0 al 9, las letras de la A a la Z (mayúsculas y minúsculas), guiones (-) y guiones bajos (_).

     También puede utilizar la fuente del valor Message Tag (Etiqueta de mensaje) para crear dimensiones basadas en las etiquetas automáticas de Amazon SES. Para utilizar una etiqueta automática, escriba el nombre completo de la etiqueta automática como Dimension Name (Nombre de dimensión). Por ejemplo, para crear una dimensión en función de la etiqueta automática del conjunto de configuración, utilice ses:configuration-set para el Dimension Name (Nombre de dimensión) y el nombre del conjunto de configuración para el Default Value (Valor predeterminado). Para obtener una lista completa de etiquetas automáticas, consulte Cómo funciona la publicación de eventos con los conjuntos de configuración y las etiquetas de los mensajes.

   • Email Header (Encabezado de correo electrónico): Amazon SES recupera el nombre y el valor de la dimensión a partir de un encabezado de correo electrónico.

     nota

     No puede usar ninguno de los siguientes encabezados de correo electrónico como Dimension Name: Received, To, From, DKIM-Signature, CC, message-id o Return-Path.

   • Link Tag (Etiqueta de enlace): Amazon SES recupera el nombre y el valor de la dimensión a partir de una etiqueta especificada en un enlace. Para obtener más información sobre cómo añadir etiquetas a los enlaces, consulte ¿Puedo etiquetar enlaces con identificadores únicos?.

3. En Nombre de dimensión, escriba el nombre de la dimensión a la que desea pasar CloudWatch.

   nota

   Los nombres de dimensión deben contener únicamente letras ASCII (a-z, A-Z), números (0 a 9), guiones bajos (_) y guiones (-). Los espacios, los caracteres acentuados, los caracteres no latinos y otros caracteres especiales no están permitidos.

4. Para Default Value (Valor predeterminado), escriba el valor de la dimensión.

   nota

   Los valores de dimensión solo deben contener letras ASCII (a-z, A-Z), números (0-9), guiones bajos (_), guiones (-), arrobas (@) y puntos (.). Los espacios, los caracteres acentuados, los caracteres no latinos y otros caracteres especiales no están permitidos.

5. Si desea añadir más dimensiones, elija Add Dimension (Añadir dimensión). En caso contrario, elija Siguiente.

6. En la pantalla de revisión, si está satisfecho con la forma en que ha definido el destino de eventos, elija Add destination (Agregar destino).

Selección de CloudWatch dimensiones

Al elegir nombres y valores para usarlos como CloudWatch dimensiones, tenga en cuenta los siguientes factores:

• Precio por métrica: puedes ver las métricas básicas de Amazon SES de forma CloudWatch gratuita. Sin embargo, si recopila métricas mediante la publicación de eventos, incurre en costos de monitoreo CloudWatch detallado. Cada combinación única de tipo de evento, nombre de dimensión y valor de dimensión crea una métrica diferente. CloudWatch Cuando utilizas CloudWatch Detailed Monitoring, se te cobra por cada métrica. Por este motivo, es posible que desee evitar elegir dimensiones que puedan tener muchos valores diferentes. Por ejemplo, a menos que esté muy interesado en el seguimiento de los eventos de envío de correo electrónico desde el dominio del remitente (“From”), es posible que no desee definir una dimensión para la etiqueta automática de Amazon SES ses:from-domain, ya que puede tener muchos valores distintos. Para más información, consulte Precios de CloudWatch.

• Filtrado de métricas: si una métrica tiene varias dimensiones, no puede acceder a la métrica en CloudWatch función de cada dimensión por separado. Por ese motivo, piénselo detenidamente antes de añadir más de una dimensión a un único destino de CloudWatch evento. Por ejemplo, si desea métricas por campaign y por una combinación de campaign y genre, tiene que añadir dos destinos de evento: uno solo con campaign como dimensión y otro con campaign y genre como dimensiones.

• Fuente de los valores de las dimensiones: como alternativa a especificar los valores de las dimensiones utilizando encabezados específicos de Amazon SES o un parámetro para la API, también puede especificar que Amazon SES tome los valores de las dimensiones de sus propios encabezados de mensaje MIME. Podría utilizar esta opción si ya está utilizando encabezados personalizados y no desea cambiar sus mensajes de correo electrónico o sus llamadas a la API de envío de correo electrónico para recopilar métricas en función de los valores de encabezado. Si utiliza sus propios encabezados de mensaje MIME para la publicación de eventos de Amazon SES, los nombres y los valores de los encabezados usados con esta finalidad para Amazon SES solo pueden incluir las letras de la A a la Z, los números del 0 al 9, guiones bajos (_), signos arroba (@), guiones (-) y puntos (.). Si especificas un nombre o un valor que contenga otros caracteres, la llamada de envío del correo electrónico seguirá siendo correcta, pero las estadísticas del evento no se enviarán a Amazon CloudWatch.

Para obtener más información sobre CloudWatch los conceptos, consulta Amazon CloudWatch Concepts en la Guía del CloudWatch usuario de Amazon.