CloudWatch イベント発行用のイベント送信先を設定する

Amazon CloudWatch メトリクス では、イベント送信先を使用して Amazon SES E メール送信イベントを に発行できます CloudWatch。 CloudWatch イベント送信先は設定セット内にのみ存在するため、まず設定セットを作成してから、その設定セットにイベント送信先を追加する必要があります。

設定セットに CloudWatch イベント送信先を追加するときは、E メールの送信時に使用するメッセージタグに対応する CloudWatch ディメンションを 1 つ以上選択する必要があります。メッセージタグと同様に、 CloudWatch ディメンションはメトリクスを一意に識別するのに役立つ名前と値のペアです。

たとえば、メッセージタグと、メールキャンペーンの識別に使用する campaign と呼ばれるディメンションを選択できます。E メール送信イベントを に発行する場合 CloudWatch、メッセージタグとディメンションを選択することが重要になります。これらの選択は CloudWatch 請求に影響し、 で E メール送信イベントデータをフィルタリングする方法を決定するためです CloudWatch。

このセクションでは、ディメンションの選択に役立つ情報と、設定セットに CloudWatch イベント送信先を追加する方法について説明します。

CloudWatch イベント送信先の追加

このセクションの手順では、設定セットに CloudWatch イベント送信先の詳細を追加する方法を示します。ただし、「」のステップ 1～6 を完了していることを前提としていますイベント送信先の作成。

Amazon SES API V2 の UpdateConfigurationSetEventDestinationオペレーションを使用して、イベント送信先を作成および変更することもできます。 V2

コンソールを使用して設定セットに CloudWatch イベント送信先の詳細を追加するには

1. これらは、ステップ 7 でイベント送信先タイプ CloudWatch として を選択するための詳細な手順であり、 で前のステップをすべて完了したことを前提としていますイベント送信先の作成。 CloudWatch 送信先タイプを選択し、イベント発行を有効にすると、Amazon CloudWatch ディメンションパネルが表示されます。そのフィールドは次のステップで対処されます。（追加料金が適用されます。「 のメトリクスあたりの料金 CloudWatch」を参照してください。）

2. 値ソース には、Amazon SES が に渡すデータを取得する方法を指定します CloudWatch。次の値ソースを使用できます。

   • メッセージタグ - Amazon SES は、X-SES-MESSAGE-TAGS ヘッダーまたは EmailTags API のパラメータを使用して、指定するタグからディメンション名と値を取得します。メッセージタグの使用方法の詳細については、「ステップ 3: E メールを送信するときに設定セットを指定する」を参照してください。

     注記

     メッセージタグには、0〜9 の数字、A〜Z の文字 (大文字と小文字)、ハイフン (-)、およびアンダースコア (_) を使用できます。

     [メッセージタグ] 値ソースを使用し、Amazon SES 自動タグに基づいてディメンションを作成することもできます。自動タグを使用するには、自動タグの完全な名前を [Dimension Name] として入力します。例えば、設定セット自動タグに基づいてディメンションを作成するには、[ディメンション名] に ses:configuration-set を使用し、[デフォルト値] に設定セットの名前を使用します。自動タグの詳しい一覧については、「設定セットとメッセージタグでのイベント発行の仕組み」を参照してください。

   • Email Header – Amazon SES が、E メール内のヘッダーからディメンション名と値を取得します。

     注記

     以下の E メールヘッダーをディメンション名として使用することはできません: Received、To、From、DKIM-Signature、CC、message-id、または Return-Path。

   • リンクタグ - Amazon SES は、リンクで指定したタグからディメンション名と値を取得します。リンクへのタグの追加の詳細については、「リンクに一意の識別子をタグ付けできますか?」を参照してください。

3. [Dimension Name (ディメンション名)] で、 CloudWatch に渡すディメンションの名前を入力します。

   注記

   ディメンション名は、ASCII 文字 (a～z、A～Z)、数字 (0～9)、アンダースコア (_)、ダッシュ (-) のみを含みます。スペース、アクセント文字、非ラテン文字、およびその他の特殊文字は使用できません。

4. [Default Value] に、ディメンションの値を入力します。

   注記

   ディメンション値は、ASCII 文字 (a～z、A～Z)、数字 (0～9)、アンダースコア (_)、ダッシュ (-)、アットマーク (@)、ピリオド (.) のみを含みます。スペース、アクセント文字、非ラテン文字、およびその他の特殊文字は使用できません。

5. さらにディメンションを追加する場合は、[Add Dimension] を選択します。それ以外の場合は、次へ を選択します。

6. レビュー画面で、イベント目的地の定義に問題がなければ、送信先を追加するを選択します。

CloudWatch ディメンションの選択

CloudWatch ディメンションとして使用する名前と値を選択するときは、次の要素を考慮してください。

• メトリクスあたりの料金 – で基本的な Amazon SES メトリクス CloudWatch を無料で表示できます。ただし、イベント発行を使用してメトリクスを収集すると、CloudWatch 詳細モニタリングコストが発生します。イベントタイプ、ディメンション名、ディメンション値の一意の組み合わせごとに、 に異なるメトリクスが作成されます CloudWatch。 CloudWatch詳細モニタリングの を使用すると、メトリクスごとに課金されます。このため、多くの異なる値を取得する可能性があるディメンションの選択を回避できます。例えば、「From」ドメインごとに E メール送信イベントを追跡することが特に必要な場合を除き、Amazon SES 自動タグ ses:from-domain のディメンションを定義する必要はありません。多くの異なる値が使用されるためです。詳細については、「CloudWatch の料金」を参照してください。

• メトリクスフィルタリング – メトリクスに複数のディメンションがある場合、各ディメンション CloudWatch に基づいて のメトリクスに個別にアクセスすることはできません。そのため、1 つの CloudWatch イベント送信先に複数のディメンションを追加する前に、慎重に検討してください。たとえば、campaign あたりのメトリクスと、campaign と genre の組み合わせあたりのメトリクスが必要な場合、2 つのイベント送信先を追加する必要があります。ディメンションとして campaign のみ使用するイベント送信先と、campaign および genre の両方をディメンションとして使用するイベント送信先です。

• ディメンション値ソース – Amazon SES 固有のヘッダーまたは API へのパラメータを使用してディメンション値を指定する代わりに、Amazon SES が独自の MIME メッセージヘッダーからディメンション値を取得するように選択することもできます。このオプションは、すでにカスタムヘッダーを使用しており、ヘッダー値に基づいてメトリクスを収集するために、メールやメール送信 API 呼び出しを変更したくない場合に使用できます。Amazon SES イベント発行に独自の MIME メッセージヘッダーを使用する場合、Amazon SES イベント発行に使用するヘッダー名と値には、文字 A 〜 Z、数字 0 〜 9、アンダーバー (_)、アットマーク (@)、ハイフン (-)、およびピリオド (.) のみを含めることができます｡ 他の文字を含む名前または値を指定しても、E メール送信呼び出しは成功しますが、イベントメトリクスは Amazon に送信されません CloudWatch。

CloudWatch 概念の詳細については、「Amazon ユーザーガイド」の「Amazon CloudWatch の概念」を参照してください。 CloudWatch