Amazon SES でのメール送信ログを表示する

こんにちは。SRE 課の栩野です。

先日、Amazon SES からのメールを正常に配信することが出来ない事象があり
失敗の原因を特定するため、メールの送信ログを可視化する設定を行ってみたので
その設定方法を今回ブログのネタにします。

以下のサイトと動画を参考にしています。

Amazon SES で E メール送信履歴を表示するにはどうすればよいですか ?
Amazon SES でメールの送信履歴を保存する方法を教えてください。(動画)

送信ログを表示するための設定

それでは、実際にメールの送信ログを可視化するための設定手順を説明していきます。
Amazon SES には既にドメインもしくはメールアドレスの設定は完了している前提で進めていきます。

Amazon SES 単体ではメールの送信ログを確認する方法が提供されていないため
今回ログの保存先に Amazon Elasticsearch Service を使い、ログの配信には
Amazon Kinesis Data Firehose といったサービスを使っていきます。

Amazon Elasticsearch Service の作成

まずは Amazon SES の送信ログを保存するための Elasticsearch を作成していきます。
以下の手順で作成していきます。

マネージメントコンソールから Amazon Elasticsearch Service のサービスコンソールに移動し
[新しいドメインの作成]をクリックします。

[Step 1: デプロイタイプの選択] でデプロイタイプは[開発およびテスト]を選択し
バージョンは(latest)がついた最新バージョンを選択します。

[Step 2: ドメインの設定] でドメイン名には任意の名前を入力します。
今回は[ses-logs]と入力し、インスタンスタイプは費用の安い[t3.small.elasticsearch]
を選択し、ノード数は[1]で設定します。その他はデフォルトのまま[次へ]をクリックします。

[Step 3: アクセスとセキュリティの設定] でネットワーク構成を[パブリックアクセス]にし
細かいアクセスコントロールを有効化についたチェックを外します。

アクセスポリシーを[カスタムアクセスポリシー]に設定し、送信ログを確認する際に
接続するアクセス元となる自分の IP アドレスを許可するよう以下画像のように設定します。

その他はデフォルト設定のまま[次へ]をクリックします。

[Step 4: 確認]で全体の設定を確認して、一番下にある[確認]をクリックします。

Amazon Elasticsearch Service の作成までには 10 分ほど時間がかかりますが
作成はこれで完了です。

Amazon Kinesis Data Firehose の作成

次に SES のログを Elasticsearch に配信するための Kinesis Data Firehose の作成していきます。
Amazon Kinesis のサービスコンソールから Kinesis Data Firehose を選択し[配信ストリームの作成]を
クリックします。

[Step 1: Name and source] では Delivery stream name に任意のストリームネームを設定します。
ここでは[ses-stream]で入力します。
Choose a source では[Direct PUT or other sources]に選択が入っていることを確認します。

その他はデフォルトのままで[Next]をクリックします。

[Step 2: Process records] はデフォルトのまま[Next]をクリックします。

[Step 3: Choose a destination] の destination でストリーム先に[Amazon Elasticsearch]を選択します。
Domain の部分では、先ほど作成した Elasticsearch のドメイン名を選択します。
(この時点で作成処理が終わってなければ待ちます。)

Index には任意で名前を付けます。今回は[ses-logs]と入力します。

次に Elasticsearch への配信に失敗したデータを保管するための S3 backup を作成します。
[Failed records only]にチェックをいれ[Create new]をクリックし任意のバケットネームを入力します。
ここでは[ses-failedlog]で作成し、その他はデフォルトで[Next]をクリックします。

[Step 4: Configure settings] ではログを配信するために必要な IAM ロールの作成だけ行います。
Create or update IAM role の部分のボタンを選択し[Next]をクリックします。

[Step 5: Review] で設定内容を確認し[Create delivery stream]をクリックして
Kinesis Data Firehose の作成も完了です。

Amazon SES Configuration Sets の作成

Amazon SES のサービスコンソールから[Configuration Sets]に移動し
[Create Configuration Set]をクリックします。

Configuration Set Name には任意で名前を入力します。
今回は[to-firehose]で作成します。

次に作成した Configuration Set を選択して

Event Destinations タブから Destination の設定を行っていきます。
Add Destination で firehose を選択するとポップアップが表示されるので
設定を入力していきます。

Name は任意で to-firehose と入力し Event types には以下画像の通り
Send、Reject、Delivery、Bounce、Complaint にチェックをいれます。

Stream には先ほど作成した firehose のストリームを選択し、IAM role は
[Let SES make a new role]を選択し、Role name に任意の名前を入力します。
今回は[ses-firehose-role]と入力し、右側にある[Create Role]を選択します。

最後に[Save]をクリックします。