Menu
Amazon Simple Email Service
Developer Guide

Creating Reputation Monitoring Alarms Using CloudWatch

Amazon SES automatically publishes two reputation-related metrics to Amazon CloudWatch: Reputation.BounceRate and Reputation.ComplaintRate. You can use these metrics to create alarms that notify you when your bounce or complaint rates reach levels that could impact your ability to send email.

Values for Reputation.BounceRate and Reputation.ComplaintRate are in the range 0 to 1, with 0 representing no bounces or complaints, and 1 representing that 100% of your emails are bouncing or resulting in complaints.

To create a CloudWatch alarm

  1. Sign in to the AWS Management Console and open the Amazon SNS console at https://console.aws.amazon.com/sns/v2/home.

  2. Create a new Amazon SNS topic, and then subscribe to it using your preferred endpoint (such as email or SMS). For more information, see Create a Topic and Subscribe to a Topic in the Amazon Simple Notification Service Developer Guide.

  3. Open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  4. In the navigation panel on the left side of the screen, choose Alarms.

  5. Choose Create Alarm.

  6. Under CloudWatch Metrics by Category, choose SES Metrics.

  7. Under Metric name, choose the metric for which you want to create the alarm.

    For example, if you want to create an alarm when your bounce rate reaches a certain level, choose Reputation.BounceRate. If you want to create an alarm when your complaint rate reaches a certain level, choose Reputation.ComplaintRate.

    Choose Next.

  8. Under Alarm Threshold, for Name, type a name for the alarm.

  9. In the alarm threshold area, specify the value that should cause CloudWatch to raise an alarm.

    If you are creating an alarm for Reputation.BounceRate, note that Amazon SES recommends that you maintain a bounce rate under 5%, and that a rate of 10% puts your account at risk for suspension. For this reason, we recommend that you configure CloudWatch to raise an alarm when the bounce rate is greater than or equal to 0.05 (5%), as shown in the following image.

    If you are creating an alarm for Reputation.ComplaintRate, note that Amazon SES recommends that you maintain a complaint rate under 0.1%, and that a rate of 0.5% puts your account at risk for suspension. For this reason, we recommend that you configure CloudWatch to raise an alarm when the bounce rate is greater than or equal to 0.001 (0.1%), as shown in the following image.

  10. Under Alarm Preview, for Period, choose 15 Minutes.

  11. Under Actions, for Whenever this alarm, choose State is ALARM. For Send notification to, choose the topic that you created and subscribed to in step 2.

  12. Choose Create Alarm.

Note

These procedures omit some information about optional settings for CloudWatch alarms. For detailed instructions, see Creating Amazon CloudWatch Alarms in the Amazon CloudWatch User Guide.