イベント発行の CloudWatch イベント送信先のセットアップ - Amazon Simple Email Service

「翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。」

イベント発行の CloudWatch イベント送信先のセットアップ

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

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

たとえば、メッセージタグと、メールキャンペーンの識別に使用する campaign と呼ばれるディメンションを選択できます。メール送信イベントを CloudWatch に発行するとき、メッセージタグとディメンションを選択することが重要です。その選択内容によって、CloudWatch の請求に影響が及び、CloudWatch でのメール送信イベントのフィルタ方法が決まるからです。

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

CloudWatch イベント送信先の追加

このセクションの手順では、作成した設定セットに CloudWatch イベント送信先を追加する方法を示します。

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

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

  1. AWS マネジメントコンソール にサインインして、https://console.aws.amazon.com/ses/ で Amazon SES コンソールを開きます。

  2. ナビゲーションペインで [Configuration Sets] を選択します。

  3. 設定セットのリストで、CloudWatch イベントの送信先を作成する設定セットを選択します。リストが空の場合、まず設定セットを作成する必要があります。

  4. [Event Destinations (イベント送信先)] タブの [Add Destination (送信先の追加)] で、[Select a destination type (送信先タイプの選択)] を選択して、[CloudWatch] を選択します。

  5. [CloudWatch Destination (CloudWatch 送信先)] ダイアログボックスで、[Enabled (有効)] を選択します。

  6. [Name] に、イベント発行先の名前を入力します。

  7. [Event types] で、イベント送信先に発行するイベントタイプを選択します。次のイベントタイプを使用できます。

    • 送信 – Amazon SES に対する呼び出しが成功しました。Amazon SES はメールの配信を試行します。

    • 拒否 – Amazon SES は E メールを受け取りましたが、この E メールにウイルスが含まれていると判断して拒否しました。Amazon SES は受信者のメールサーバーに E メール配信を試みませんでした。

    • バウンス – 受取人のメールサーバーにより、メールは完全に拒否されました。このイベントはハードバウンスに該当します。ソフトバウンスは、Amazon SES が一定期間にわたって再試行してもメールを配信できなかった場合に限ります。

    • 苦情 – E メールは受取人に正常に配信されました。受取人がメールをスパムとしてマークしました。

    • 配信 – Amazon SES が受取人のメールサーバーに E メールを正常に送信しました。

    • オープン – 受取人がメッセージを受け取り、E メールクライアントで開きました。

    • クリック – 受取人はメール内の 1 つ以上のリンクをクリックしました。

    • レンダリング失敗 – テンプレートレンダリングの問題のために E メールが送信されませんでした。このイベントタイプは、SendTemplatedEmail または SendBulkTemplatedEmail API オペレーションを使用してテンプレートメールを送信する場合にのみ発生します。このイベントタイプは、テンプレートデータが見つからない場合や、テンプレートのパラメータとデータが一致しない場合に発生します。

    • 配信の遅延 – 一時的な問題が発生したため、メールを受信者に配信できませんでした。配信の遅延は、受信者の受信トレイがいっぱいになった場合や、受信側の電子メールサーバーで一時的な問題が発生した場合などに発生します。

      注記

      DELIVERY_DELAY イベントタイプをイベントの宛先に追加するには、Amazon SES API V2 で UpdateConfigurationSetEventDestin オペレーションを使用する必要があります。現時点では、Amazon SES コンソールを使用してこのイベントタイプを構成セットに追加することはできません。

  8. [Value Source (値ソース)] で、Amazon SES が CloudWatch に渡すデータを取得する方法を指定します。次の値ソースを使用できます。

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

      注記

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

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

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

      注記

      次の電子メール ヘッダーは、 属性名: ReceivedToFromDKIM-SignatureCCmessage-id、または Return-Path.

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

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

    注記

    ディメンション名と値には、文字 A~Z、数字 0~9、アンダースコア (_)、アットマーク (@)、ハイフン (-)、およびピリオド (.) のみを含めることができます。スペース、アクセント文字、非ラテン文字、およびその他の特殊文字は使用できません。

  10. さらにディメンションを追加する場合は、[Add Dimension] を選択します。問題がなければ、[保存] を選択します。

CloudWatch ディメンションの選択

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

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

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

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

CloudWatch の概念の詳細については、https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.htmlの「Amazon CloudWatch ユーザーガイドAmazon CloudWatch Concepts」を参照してください。