Menu
Amazon Simple Email Service
Developer Guide

Retrieving Amazon SES Event Data from CloudWatch

Amazon SES publishes metrics for your email sending events — bounces, complaints, deliveries, sent emails, and rejected emails — to Amazon CloudWatch. CloudWatch provides your email sending event 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

The following metrics are available from Amazon SES.

Metric Description

Bounce

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

Unit: count

Complaint

The recipient marked the email as spam.

Unit: count

Delivery

Amazon SES successfully delivered the email to the recipient’s mail server.

Unit: count

Reject

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

Unit: count

Send

The email sending API call to Amazon SES was successful and Amazon SES will attempt to deliver the email.

Unit: count

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"