How do I view my email sending history in Amazon SES?

Last updated: 2022-06-30

I want to review my email sending history in Amazon Simple Email Service (Amazon SES). How can I do that?

Resolution

Use Amazon OpenSearch Service and Amazon Kinesis to store and view your Amazon SES sending history.

Create an Amazon OpenSearch Service domain

Create an Amazon OpenSearch Service domain to store your Amazon SES sending history. OpenSearch Service can be placed in a public network or in an Amazon Virtual Private Cloud (Amazon VPC). For more information on the type of network to use for your OpenSearch Service domain, see VPC versus public domains.

Create a Kinesis delivery stream

  1. Open the Kinesis console.
  2. Choose Create delivery stream.
  3. For Source, select Direct PUT. For Destination, select Amazon OpenSearch Service.
  4. For Delivery stream name, enter a name for your stream.
  5. (Optional) You can choose to transform source records with AWS Lambda, or leave this setting as Disabled.
  6. Under Destination settings, enter the following:
    For OpenSearch Service domain, select the domain that you created to store your Amazon SES sending history.
    For Index, enter an index name.
    For Index rotation, choose a rotation schedule. Or, leave the field with the default No rotation setting.
    For Type, enter a type name.
    For Retry duration, modify the retry duration in seconds. Or, leave the field with the default 300 seconds.
  7. For Buffer hints, configure OpenSearch Service buffer conditions for your use case. For more information on these fields, see Backup and advanced settings.
  8. Under Backup settings, enter the following:
    Leave Failed data only as the default setting.
    For S3 backup bucket, choose to store the records in an existing bucket. Or, choose Create to create a new bucket.
    (Optional) For S3 backup bucket prefix, enter a prefix. Or, leave this field blank.
    (Optional) For S3 backup bucket error output prefix, enter a prefix. Or, leave this field blank.
  9. (Optional) You can expand the Advanced settings tab to configure server-side encryption, CloudWatch error logging, permissions, and tags. Configure the settings for your use case. For more information on these fields, see Backup and advanced settings.
  10. Choose Create delivery stream.

Create an Amazon SES configuration set

  1. Open the Amazon SES console, and then choose Configuration Sets from the navigation pane.
  2. Choose Create Set.
  3. For Configuration set name, enter a name for the set.
  4. For Sending IP pool, select your preferred pool or leave default selected. Then, choose Create Set.
  5. Choose Event destinations from the top pane of the newly created set, and then choose Add destination.
  6. For Event types, select Sends, Rejects, Deliveries, Hard bounces, and Complaints. Then, choose Next.
  7. For Destination type, select Amazon Kinesis Data Firehose.
  8. In the Name field, enter a destination name.
  9. For Delivery stream, select the delivery stream that you created.
  10. For Identity and Access Management (IAM) Role, choose a role that grants permission for Amazon SES to publish to Kinesis Data Firehose on your behalf. Then, choose Next.
    Note: This must be a manually created Identity and Access Management (IAM) role.
  11. Review your event destination settings, and then choose Add destination.

Test your configuration

  1. Send a test email using the Amazon SES console.
    Important: To see the results of the test email, you must specify the configuration set that you created.
    For Email Format, select Formatted.
    For Configuration set, enter the name of the configuration set.
  2. Open the Amazon OpenSearch Service console.
  3. Choose the domain that you created for storing your Amazon SES sending history.
  4. In the General information section, choose the link next to OpenSearch dashboards URL.
  5. Create an index pattern for the index name that you configured when you created the delivery stream. For instructions, see Create a data view on the elastic.co website.
  6. After the index pattern is created, use the Discover feature in OpenSearch Dashboards to view the log of the test email that you sent. For more information, see Discover on the elastic.co website.