Menu
Amazon Simple Email Service
Developer Guide

Retrieving Amazon SES Event Data from CloudWatch

Amazon SES can publish metrics for your email sending events to Amazon CloudWatch. When you publish event data to CloudWatch, it provides these metrics as an ordered set of time-series data. You can use these metrics to monitor the performance of your email sending. For example, you can monitor the complaint metric and set a CloudWatch alarm to trigger when the metric exceeds a certain value.

There are two levels of granularity at which Amazon SES can publish these events to CloudWatch:

  • Across your AWS account – These coarse metrics, which correspond to the metrics you monitor using the Amazon SES console and the GetSendStatistics API, are totals across your entire AWS account. Amazon SES publishes these metrics to CloudWatch automatically.

  • Fine-grained – These metrics are categorized by email characteristics that you define using message tags. To publish these metrics to CloudWatch, you must set up event publishing with a CloudWatch event destination and specify a configuration set when you send an email. You can also specify message tags or use auto-tags that Amazon SES automatically provides.

This section describes the available metrics and how to view the metrics in CloudWatch.

Available Metrics

You can publish following Amazon SES email sending metrics to CloudWatch:

  • Send – Your API call to Amazon SES was successful and Amazon SES attempted to deliver the email.

  • Reject – Amazon SES initially accepted the email, but later rejected it because the email contained a virus.

  • Bounce – The recipient's mail server permanently rejected the email. This event corresponds to hard bounces. Soft bounces are only included when Amazon SES fails to deliver the email after retrying for a period of time.

  • Complaint – The recipient marked the email as spam.

  • Delivery – Amazon SES successfully delivered the email to the recipient's mail server.

  • Open – The recipient received the message and opened it in his or her email client.

  • Click – The recipient clicked one or more links contained in the email.

Available Dimensions

CloudWatch uses the dimension names that you specify when you add a CloudWatch event destination to a configuration set in Amazon SES. For more information, see Set Up a CloudWatch Event Destination for Amazon SES Event Publishing.

Viewing Amazon SES Metrics in the CloudWatch Console

The following procedure describes how to view your Amazon SES event publishing metrics using the CloudWatch console.

To view metrics using the CloudWatch console

  1. Sign in to the AWS Management Console and open the CloudWatch console at https://console.aws.amazon.com/cloudwatch/.

  2. If necessary, change the region. From the navigation bar, select the region where your AWS resources reside. For more information, see Regions and Endpoints.

  3. In the navigation pane, choose Metrics.

  4. In the All metrics pane, expand AWS Namespaces, and then choose SES.

  5. To view metrics across your entire AWS account, which Amazon SES publishes automatically, choose Account Sending Metrics. To view fine-grained event publishing metrics, choose the combination of dimensions that you specified when you set up your CloudWatch event destination.

  6. Choose the metric you want to view.

    The graph will display the metric over time.

To view metrics using the AWS CLI

  • At a command prompt, use the following command:

    Copy
    aws cloudwatch list-metrics --namespace "AWS/SES"