メインコンテンツへスキップ
見出し画像

【IT】Amazon SES のバウンス/苦情を CloudWatch アラームで監視(Django編)

    皆さま
    こんにちは

    本日は、Amazon SES のアラート設定(Djangoでの)について記載します。

    はじめに

    Amazon SES を使って Django アプリからメールを送信していると、
    「届かなかったメール(バウンス)」や「受信者に迷惑メール扱いされた(苦情)」を どう監視すればよいか?  が課題になるかと思います。

    本記事では、
    Amazon SES のバウンス/苦情イベントを
    CloudWatch メトリクスに送り、
    しきい値を超えたら CloudWatch アラーム経由でメール通知を受け取る
    仕組みを、Django アプリでの実装例とあわせて解説します。

    これにより、送信後のメール配信健全性を「数値」で把握し、
    問題が起きたときに即座に検知できるようになります。

    対象読者:
     - Django でメール送信を実装している
     - Resend/SendGrid などから SES(API / django-ses) に移行したい
     - 配信の健全性(バウンス率・苦情率)を監視し、自動通知 まで繋ぎたい



    0. ゴール(最終的に何ができる?)

    • Django から SES(API: `django-ses`)でメール送信

    • Configuration Set 経由でイベントを CloudWatch メトリクスに送出

    • CloudWatch アラームでしきい値を超えたら SNS 経由でメール通知

    • 「なぜこのしきい値?」の根拠まで理解して設定できる


    1. 事前準備(AWS 側)

    1-1. サンドボックス解除

    SES を本番利用するための申し込みが完了していること(ドメイン認証/送信元認証も済み)。

    1-2. IAM ユーザーの作成 & 最小権限ポリシー

    django-ses(API方式)でメールを送る場合、以下の権限が必要です。

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "ses:SendEmail",
            "ses:SendRawEmail",
            "ses:GetSendQuota",
            "ses:GetSendStatistics"
          ],
          "Resource": "*"
        }
      ]
    }

    `ses:GetSendQuota` / `ses:GetSendStatistics` は、`django-ses` のレート制御に必須となります。
    一時的に `AWS_SES_AUTO_THROTTLE=0` で回避も可能ですが、
    本番は権限を付けるのが安全です。

    1-3. 送信ドメインの DNS(SPF/DKIM/DMARC)

    • DKIM(Easy DKIM)の CNAME を DNS に追加(必須)

    • SPF:例 `v=spf1 include:amazonses.com ~all`

    • DMARC:例 `v=DMARC1; p=none; rua=mailto:dmarc@yourdomain`


    2. Django 側のセットアップ(API 方式/`django-ses`)

    2-1. パッケージ導入

    $ pip install django-ses boto3 botocore

    2-2. `.env`(例)

    DEFAULT_FROM_EMAIL="Your Brand <no-reply@yourdomain>"
    AWS_SES_ACCESS_KEY_ID=xxxxxxxxxxxxxxxxxxxx
    AWS_SES_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxx
    AWS_SES_REGION_NAME=ap-northeast-1
    # 後述の Configuration Set 名(例)
    AWS_SES_CONFIGURATION_SET=prod-mail
    # レート制御(0.5〜1.0程度で様子見。0で無効化)
    AWS_SES_AUTO_THROTTLE=0.5

    2-3. `settings.py`(最小構成)

    import os
    
    EMAIL_BACKEND = "django_ses.SESBackend"
    
    DEFAULT_FROM_EMAIL = os.getenv("DEFAULT_FROM_EMAIL", "no-reply@yourdomain")
    
    AWS_SES_ACCESS_KEY_ID = os.getenv("AWS_SES_ACCESS_KEY_ID")
    AWS_SES_SECRET_ACCESS_KEY = os.getenv("AWS_SES_SECRET_ACCESS_KEY")
    AWS_SES_REGION_NAME = os.getenv("AWS_SES_REGION_NAME", "ap-northeast-1")
    AWS_SES_REGION_ENDPOINT = os.getenv(
        "AWS_SES_REGION_ENDPOINT", "email.ap-northeast-1.amazonaws.com"
    )
    
    AWS_SES_AUTO_THROTTLE = float(os.getenv("AWS_SES_AUTO_THROTTLE", "0.5"))
    
    # Configuration Set を付ける(後述)
    AWS_SES_CONFIGURATION_SET = os.getenv("AWS_SES_CONFIGURATION_SET", "")

    2-4. 送信関数(例:共通メールユーティリティ)

    ※ `django.core.mail.EmailMultiAlternatives` を使えば OK

    # utils/email.py
    from django.core.mail import EmailMultiAlternatives, get_connection
    
    def send_mail(subject, message, from_email, recipient_list,
                  html_message=None, email_type="default", **kwargs):
        """
        共通送信関数。settings.EMAIL_BACKEND(django-ses)が使われる。
        """
        connection = get_connection()  # SESBackend
        msg = EmailMultiAlternatives(
            subject=subject,
            body=message,
            from_email=from_email,
            to=recipient_list,
            connection=connection,
        )
        if html_message:
            msg.attach_alternative(html_message, "text/html")
    
        # ログ(確認用)
        print(f"📨 SES(backend)送信開始: {subject} → {recipient_list}")
        try:
            msg.send()
            print(f"✅ 送信成功: {', '.join(recipient_list)}")
            return [{"recipient": r, "ok": True} for r in recipient_list]
        except Exception as e:
            print(f"[送信失敗] {recipient_list}: {e}")
            # ここで管理者通知や再試行処理など
            return [{"recipient": r, "ok": False, "error": str(e)} for r in recipient_list]

    2-5. 動作確認(Mailbox Simulator)

    $ python manage.py shell
    from utils.email import send_mail
    
    # 正常
    send_mail("[テスト] SES送信", "本文", None, ["success@simulator.amazonses.com"], "<p>HTML</p>")
    
    # バウンス
    send_mail("[テスト] Bounce発生テスト", "本文", None, ["bounce@simulator.amazonses.com"], "<p>HTML</p>")
    
    # 苦情
    send_mail("[テスト] Complaint発生テスト", "本文", None, ["complaint@simulator.amazonses.com"], "<p>HTML</p>")

    ヘッダ確認(受信側):`Received: from *.smtp-out.amazonses.com` / `X-SES-...` があれば SES 経由の証拠。


    3. 通知先メール(Amazon SNS)の準備

    CloudWatch アラームは直接メールを送ることはできません。
    アラーム → SNS → メール という経路を取るため、まずは Amazon SNS の「トピック」を作成し、通知先のメールアドレスを登録しておきます。

    3-1. SNS トピックを作成

    1. AWS コンソール → Amazon SNS を開く

    2. 左メニュー → トピック → トピックの作成

    3. 名前を `ses-alert-topic` など分かりやすいものに設定

    4. タイプは「スタンダード」を選択→ 作成

    3-2. サブスクリプションを追加

    1. 作成したトピックを開き、サブスクリプションの作成をクリック

    2. プロトコル:Eメール

    3. エンドポイント:通知を受け取りたいメールアドレスを入力

    4. サブスクリプションの作成

    3-3. 確認メールを承認

    • 入力したメールアドレスに 「AWS Notification - Subscription Confirmation」 が届く

    • 本文内の 「Confirm subscription」リンクをクリック

    • ステータスが「確認済み」になればOK

    👉 これで CloudWatch アラームの通知先として SNS トピックを選べるようになります。

    <例>

    画像

    4. Configuration Set(設定セット)の作成

    4-1. 作成手順

    1. SES コンソール → 設定セット → 作成

    2. 名前:`prod-mail`(任意の運用名をつけてください)

    3. そのまま作成(空でOK)

    4-2. Event destination(CloudWatch メトリクス)を追加

    1. 設定セット `prod-mail` → 「イベント送信先」(送信先の追加)を追加

    2. イベントタイプ:ハードバウンス/苦情 だけにチェック(最初は最小)

    3. 送信先タイプ:Amazon CloudWatch

      • 名前:cw-metrics-bounce-complaint(任意の名前)

      • イベント発行:有効化に☑️

    4. ディメンション

      • 値のソース:Eメールヘッダー

      • ディメンション名:`configuration-set`

      • デフォルト値:`prod-mail`

    5. 保存

    CloudWatch Logs 直行は v2 では選べません。
    JSON の生ログを見たい場合は SES → SNS →(Lambdaなど)→ CloudWatch Logs で実現。

    4-3. 送信側に ConfigSet を付ける(Djangoでの設定)

    `.env` で `AWS_SES_CONFIGURATION_SET=prod-mail` を設定済みなら、`django-ses` が自動でヘッダ付与。
    以後の送信が この設定セットでメトリクス化されます。

    <例>

    画像
    画像
    画像

    5. CloudWatch でメトリクス確認

    • CloudWatch → メトリクス(全てのメトリック) → SES → configuration-set → prod-mail

      • `Send` / `Delivery` / `Bounce` / `Complaint`(件数:Sum)

      • (出ていれば)`BounceRate` / `ComplaintRate`(率:Average)

    率メトリクスが見当たらない場合:
     * まずは件数で監視(後で Rate に切替)
     * または メトリクス数式で `Bounce / (Delivery + Bounce)` を自作してもよい

    <例>

    画像

    6. CloudWatch アラーム(通知)

    6-1. 「なぜこの値?」(しきい値の根拠)

    • Bounce(不達)

      • SES は バウンス率 5% 超を制限の目安にする

      • 少量送信では数件でも危険水域

      • → 件数で 5(テストしやすい) or Rate で 0.05(5%)

    • Complaint(苦情)

      • SES は 苦情率 0.1% 超を非常に厳格に管理

      • 少量送信では 1件でも重大

      • → 件数で 1(即通知) or Rate で 0.001(0.1%)

    小規模運用=件数ベースが直感的でテスト容易。
    大規模運用=Rate 監視が健全性に直結。両方のアラームを併用すると最強。

    6-2. アラーム作成手順(例)

    1. CloudWatch → アラーム(アラーム状態) → アラームの作成

    2. メトリクスを選択 → `SES / configuration-set / prod-mail`

    3. Bounce(件数)を選ぶ → 「メトリクスの選択」

    4. 条件:

      • 統計:Sum(合計)

      • 期間:5分

      • しきい値の種類:静的

      • 条件:より大きい

      • しきい値:5(本番は送信量に応じて最適化)

    5. 通知:既存の SNS トピックを選択

      • アラーム状態トリガー:アラーム状態

      • 通知の送信先: SNS トピック(例:`ses-alert-topic`)※3項で作成

    6. アラーム名:`SES-Prod-Bounce-High`

    7. 作成

    上記1〜7の手順で
    同様に Complaint(件数) で
     * 統計:Sum
     * しきい値:1(以上で即通知)
     * アラーム名:`SES-Prod-Complaint-High`

    <例>

    画像

    6-3. 実運用でのノイズ低減

    • 評価期間/データポイント:例「期間=5分、直近3データのうち2で閾値超」

    • Missing data:not breaching(送信が無い時間に鳴らない)

    • OK 通知:不要ならオフ

    • 複数宛先:SNS トピックにメールを複数購読すればOK

    6-4. 通知メールのイメージ(SNS)

    件名:

    ALARM: "SES-Prod-Complaint-High" in Asia Pacific (Tokyo)

    本文(抜粋):

    Alarm Name: SES-Prod-Complaint-High
    State Change: OK -> ALARM
    Reason: Threshold Crossed: 1 datapoint [1.0] was >= threshold (1.0).
    Metric: Complaint
    Dimensions: [configuration-set=prod-mail]
    Period: 300 seconds
    Threshold: 1

    7. まずは“観測だけ”で十分な理由(+ 将来拡張)

    • 今は OTP/購入通知など少量送信:
      → CloudWatch メトリクス + アラーム通知 で十分。

    • 将来、配信量が増えたら:
      → SNS → Webhook(Django) を追加し、
      バウンス/苦情アドレスを DB で自動サプレッション(再送停止)へ拡張。

    SNS → Webhook の最小サンプル(参考)
    
    # views_ses.py(骨子だけ)
    @csrf_exempt
    def ses_sns_webhook(request):
        body = json.loads(request.body.decode())
        if body.get("Type") == "Notification":
            msg = json.loads(body.get("Message", "{}"))
            if msg.get("notificationType") == "Bounce":
                for r in msg["bounce"]["bouncedRecipients"]:
                    email = r["emailAddress"]
                    # User.objects.filter(email=email).update(email_blocked=True)
            elif msg.get("notificationType") == "Complaint":
                for r in msg["complaint"]["complainedRecipients"]:
                    email = r["emailAddress"]
                    # User を苦情フラグ化・再送停止
        return HttpResponse("ok")

    8. 運用の小ワザ

    8-1. 成功通知の“メール振り分け”

    • 管理者に成功通知も流すなら、件名プレフィックス(例:`[管理者通知]`)や
      専用 From(`admin-notify@yourdomain`)で受信側フィルタを設定(Gmail/Outlook)。

    8-2. 送信ログの整備

    • `EmailLog` テーブルに「送信時刻/件名/宛先/種別(email_type)/状態」を記録

    • 後から CloudWatch や SNS の通知と突合しやすい。

    8-3. 迷惑率の目標

    • ComplaintRate < 0.1%

    • BounceRate < 5%
      (CloudWatch ダッシュボードにグラフ化しておくと便利)


    9. トラブルシューティング(つまずきポイント)

    • `AccessDenied: GetSendQuota`
      → IAM ポリシーに `ses:GetSendQuota` / `ses:GetSendStatistics` を追加。
      (一時回避は `AWS_SES_AUTO_THROTTLE=0` だが本番は不可)

    • メールは送れるのにメトリクスが出ない
      → 設定セット `prod-mail` に CloudWatch(メトリクス)宛て Event Destination が無い
      → `.env` の `AWS_SES_CONFIGURATION_SET=prod-mail` が未設定

    • BounceRate/ComplaintRate が見つからない
      → まず `Bounce` / `Complaint`(件数)で作成し、後から Rate に切替
      → あるいはメトリクス数式で自作

    • SNS 通知が来ない
      → 購読メールの Confirm を忘れていないか
      → アラームが ALARM 状態に遷移しているか


    10. 全体アーキテクチャ(図解)

    ┌────────────┐
    │  Django    │
    │  send_mail │
    └─────┬──────┘
          │ (SES経由で送信)
          ▼
    ┌────────────┐
    │ Amazon SES │
    │ (ConfigSet: prod-mail)│
    └─────┬──────┘
          │ (イベント: Bounce/Complaint)
          ▼
    ┌──────────────────────┐
    │ CloudWatch Metrics   │
    │  Bounce / Complaint  │
    │  BounceRate / ...    │
    └─────┬────────────────┘
          │ (しきい値監視)
          ▼
    ┌────────────┐
    │ CloudWatch │
    │  Alarm     │
    └─────┬──────┘
          │ (通知トリガー)
          ▼
    ┌────────────┐
    │   SNS      │
    │ ses-alert  │
    └─────┬──────┘
          │ (購読メールへ配信)
          ▼
    📧 管理者メールに通知

    11. まとめ

    • API方式(django-ses)で SES を使うと速くて安定・セキュア。

    • Configuration Set を使えば、バウンス/苦情を CloudWatch メトリクスに集約。

    • アラームで Bounce ≥ 5、Complaint ≥ 1(または Rate で 5%/0.1%)を監視。

    • SNS 通知で運用チームに即エスカレーション。

    • 送信量が増えたら SNS → Webhook(Django) で自動サプレッションへ拡張。

    この手順を入れておけば、「送ったら終わり」ではなく「送った後も見える」運用にできます。
    健全性を保ちながら、安心してメール機能を運用しましょう。 🚀


    📖 Amazon SES 構築ガイド シリーズ一覧


    では
    また!


     
     
    インフラエンジニアとして実務メモを、 写真作家として写真物語を、 童話作家として物語を書いています。 写真作品は、ポートフォリオサイトとしてまとめていく予定です。

    あなたへのおすすめ