本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
针对事件发布设置 CloudWatch 事件目标
使用 Amazon CloudWatch 指标,可以使用事件目标将 Amazon SES 电子邮件发送事件发布到 CloudWatch。由于 CloudWatch 事件目标只能在配置集中设置,您必须先创建配置集,再将事件目标添加到该配置集。
在添加 CloudWatch 事件目标到配置集时,必须选择一个或多个与在发送电子邮件时使用的邮件标签对应的 CloudWatch 维度。与邮件标签类似,CloudWatch 维度是帮助您对某指标进行唯一标识的名称/值对。
例如,您可以有名为 campaign
的一个邮件标签和一个维度,用于标识您的电子邮件营销活动。在发布电子邮件发送事件到 CloudWatch 时,选择邮件标签和维度非常重要,因为这些选项会影响 CloudWatch 计费并决定可在 CloudWatch 中筛选电子邮件发送事件数据的方式。
本部分提供的信息可帮助您选择维度,然后说明如何将 CloudWatch 事件目标添加到配置集。
添加 CloudWatch 事件目标
本节中的过程演示如何将 CloudWatch 事件目标详细信息添加到配置集,并假设您已完成 创建事件目标 中的步骤 1 到 6。
您也可以使用 Amazon SES API V2 中的 UpdateConfigurationSetEventDestination 操作创建和修改事件目标。
使用控制台将 CloudWatch 事件目标详细信息添加到配置集
-
以下是步骤 7 中选择 CloudWatch 作为事件目标类型的详细说明,并假设您已完成创建事件目标中的所有之前的步骤。在选择 CloudWatch 目标类型,输入目标名称并启用事件发布后,Amazon CloudWatch 维度面板将显示,其字段将在以下步骤中得到处理。(需支付额外费用,请参阅 CloudWatch 的指标单价。)
-
对于 Value Source(值来源),请指定 Amazon SES 如何获取它传递到 CloudWatch 的数据。提供了以下值来源:
-
邮件标签 – Amazon SES 从使用
X-SES-MESSAGE-TAGS
标头或EmailTags
API 参数指定的标签中检索维度名称和值。有关使用邮件标签的更多信息,请参阅步骤 3:在发送电子邮件时指定配置集。注意
邮件标签可以包含数字 0-9、字母 A-Z(大写和小写字母)、连字符(-)和下划线(_)。
您也可以使用 Message Tag (邮件标签) 值来源根据 Amazon SES 自动标签创建维度。要使用自动标签,请键入自动标签的完整名称以作为 Dimension Name (维度名称)。例如,要根据配置集自动标签创建维度,请将
ses:configuration-set
作为 Dimension Name (维度名称) 并将配置集的名称作为 Default Value (默认值)。有关完整的自动标签列表,请参阅事件发布如何与配置集和消息标签协同工作。 -
Email Header (电子邮件标头) – Amazon SES 从电子邮件中的标头检索维度名称和值。
注意
您不能使用以下任意电子邮件标头作为 Dimension Name (维度名称):
Received
、To
、From
、DKIM-Signature
、CC
、message-id
或Return-Path
。 -
Link Tag (链接标签) – Amazon SES 从您在链接中指定的标签检索维度名称和值。有关向链接添加标签的更多信息,请参阅我能否用唯一标识符来标记链接?。
-
-
对于 Dimension Name(维度名称),请键入要传递到 CloudWatch 的维度的名称。
注意
维度名称只能包含 ASCII 字母 (a-z , A-Z )、数字 (0 - 9 )、下划线 (_) 和dashes (-)。不允许使用空格、重音字符、非拉丁字符和其他特殊字符。
-
对于 Default Value(默认值),请键入维度的值。
注意
维度值只能包含 ASCII 字母(a-z、A—Z)、数字 (0-9)、下划线 (_)、短划线 (-)、@ 符号和句点 (.)。不允许使用空格、重音字符、非拉丁字符和其他特殊字符。
-
如果要添加更多维度,请选择 Add Dimension(添加维度)。否则,请选择 Next(下一步)。
-
在审核屏幕上,如果您对定义事件目标的方式感到满意,请选择添加目标。
选择 CloudWatch 维度
在您选择要用作 CloudWatch 维度的名称和值时,请考虑以下因素:
-
指标单价 – 您可以在 CloudWatch 中免费查看基本的 Amazon SES 指标。但是,在使用事件发布来收集指标时,会产生 CloudWatch 详细监控费用。事件类型、维度名称和维度值的每个独特组合,都会在 CloudWatch 中创建不同的指标。在使用 CloudWatch 详细监控时,您需要为每个指标付费。出于此原因,您可能想要避免选择需要许多不同值的维度。例如,除非对通过“发件人”域跟踪电子邮件发送事件非常感兴趣,否则可能不希望为 Amazon SES 自动标签
ses:from-domain
定义维度,因为它可能需要许多不同的值。有关更多信息,请参阅 CloudWatch 定价。 -
指标筛选 – 如果指标具有多个维度,您无法单独基于每个维度在 CloudWatch 中访问指标。出于此原因,在添加多个维度到单个 CloudWatch 事件目标之前,请谨慎考虑。例如,如果要按
campaign
或campaign
和genre
组合查看指标,您需要添加两个事件目标:一个目标仅将campaign
作为维度,另一个目标将campaign
和genre
作为维度。 -
维度值来源 – 除了使用特定于 Amazon SES 的标头或 API 的参数指定维度值之外,您还可以选择让 Amazon SES 从您自己的 MIME 消息标头中获取维度值。如果您已在使用自定义标头并且不想更改电子邮件或对电子邮件发送 API 的调用以根据标头值收集指标,则可以使用此选项。如果对 Amazon SES 事件发布使用自己的 MIME 邮件标头,则用于 Amazon SES 事件发布的标头名称和值只能包含字母 A-Z、数字 0-9、下划线(_)、at 符号(@)、连字符(-)和句点(.)。如果您指定的名称或值包含其他字符,则电子邮件发送调用仍将成功,但事件指标不会发送到 Amazon CloudWatch。
有关 CloudWatch 概念的更多信息,请参阅《Amazon CloudWatch 用户指南》中的 Amazon CloudWatch 概念。