
【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 botocore2-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.52-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 トピックを作成
AWS コンソール → Amazon SNS を開く
左メニュー → トピック → トピックの作成
名前を `ses-alert-topic` など分かりやすいものに設定
タイプは「スタンダード」を選択→ 作成
3-2. サブスクリプションを追加
作成したトピックを開き、サブスクリプションの作成をクリック
プロトコル:Eメール
エンドポイント:通知を受け取りたいメールアドレスを入力
サブスクリプションの作成
3-3. 確認メールを承認
入力したメールアドレスに 「AWS Notification - Subscription Confirmation」 が届く
本文内の 「Confirm subscription」リンクをクリック
ステータスが「確認済み」になればOK
👉 これで CloudWatch アラームの通知先として SNS トピックを選べるようになります。
<例>

4. Configuration Set(設定セット)の作成
4-1. 作成手順
SES コンソール → 設定セット → 作成
名前:`prod-mail`(任意の運用名をつけてください)
そのまま作成(空でOK)
4-2. Event destination(CloudWatch メトリクス)を追加
設定セット `prod-mail` → 「イベント送信先」(送信先の追加)を追加
イベントタイプ:ハードバウンス/苦情 だけにチェック(最初は最小)
送信先タイプ:Amazon CloudWatch
名前:cw-metrics-bounce-complaint(任意の名前)
イベント発行:有効化に☑️
ディメンション
値のソース:Eメールヘッダー
ディメンション名:`configuration-set`
デフォルト値:`prod-mail`
保存
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. アラーム作成手順(例)
CloudWatch → アラーム(アラーム状態) → アラームの作成
メトリクスを選択 → `SES / configuration-set / prod-mail`
Bounce(件数)を選ぶ → 「メトリクスの選択」
条件:
統計:Sum(合計)
期間:5分
しきい値の種類:静的
条件:より大きい
しきい値:5(本番は送信量に応じて最適化)
通知:既存の SNS トピックを選択
アラーム状態トリガー:アラーム状態
通知の送信先: SNS トピック(例:`ses-alert-topic`)※3項で作成
アラーム名:`SES-Prod-Bounce-High`
作成
上記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: 17. まずは“観測だけ”で十分な理由(+ 将来拡張)
今は 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 構築ガイド シリーズ一覧
では
また!