How can I access my Amazon SES logs?

3 minute read

I send emails using Amazon Simple Email Service (Amazon SES), and I want to get logs or notifications for bounces, complaints, delivery, failures, or rejections.

Short description

To get logs or notifications about your email-sending events on Amazon SES, use one of the following mechanisms:

  • Email feedback forwarding
  • Amazon Simple Notification Service (Amazon SNS) topic for event notifications
  • Configuration set to publish email-sending events to Amazon SNS, Amazon CloudWatch, Amazon Pinpoint, or Amazon Kinesis Data Firehose

Note: These mechanisms don't provide logs for emails that you sent before you implemented the mechanism.


Use email feedback forwarding

By default, Amazon SES sends you a notification when a message that you send bounces or gets a complaint. The destination that you check for the bounce or complaint notifications depends on your email-sending operation. For more information, see Email feedback forwarding destination.

If you de-activated email feedback forwarding, then you can re-activate feedback forwarding using the Amazon SES console.

Use an Amazon SNS topic to send event notifications

You can use an Amazon SNS topic for notifications about Amazon SES email delivery, bounces, or complaints.

Follow these steps to configure an Amazon SNS topic for Amazon SES events:

  1. Create an Amazon SNS topic.
  2. Subscribe an endpoint (such as an email address) to receive notifications from the Amazon SNS topic.
  3. Configure your Amazon SES verified identity (domain or email address) to send event notifications to the Amazon SNS topic that you created. You can do this using either the Amazon SES console or the Amazon SES API.

After you configure an Amazon SNS topic for Amazon SES event notifications, you receive notifications at the endpoint that you subscribed to the topic. For more information on the details in the notifications, see Amazon SNS notification contents for Amazon SES and Amazon SNS notification examples for Amazon SES.

Note: Amazon SES doesn't support FIFO type topics.

Use a configuration set to publish email-sending events to Amazon SNS, CloudWatch, Amazon Pinpoint, or Kinesis Data Firehose

Use an Amazon SES configuration set that publishes events to get information about the following outcomes:

  • Sends
  • Rejects
  • Hard bounces
  • Complaints
  • Deliveries
  • Delivery delays
  • Subscriptions
  • Opens
  • Clicks
  • Rendering failures

For details about each outcome, see Event publishing terminology.

To create the configuration set, first specify the event destination, and then specify the parameters for the events that you want to publish. For step-by-step instructions, see Setting up Amazon SES event publishing.

Make sure that you configure your email-sending method to pass the name of the configuration set in the headers of your emails. This is required for Amazon SES to apply the configuration set to your emails. For more information, see Specifying a configuration set when you send email. You can also assign a default configuration set to the verified identity that's used as the From/Source address. Then, messages that you send from this identity automatically use the assigned default configuration set.

AWS OFFICIALUpdated a year ago