Amazon Simple Email Service (SES)

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

Overview

Amazon Simple Email Service (SES) is a cost-effective, outbound-only email-sending service.

Enable this integration to see in Datadog all your SES metrics.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

  1. In the AWS integration page, ensure that SES is enabled under the Metric Collection tab.

  2. Add those permissions to your Datadog IAM policy in order to collect Amazon SES metrics:

    • ses:GetSendQuota: Add metrics about send quotas.
    • ses:GetSendStatistics: Add metrics about send statistics.

    For more information, see the SES policies on the AWS website.

  3. Install the Datadog - Amazon Simple Email Service (SES) integration.

Log collection

Enable logging

Configure Amazon SES to send logs either to a S3 bucket or to CloudWatch.

Note: If you log to a S3 bucket, make sure that amazon_ses is set as Target prefix.

Send logs to Datadog

  1. If you haven’t already, set up the Datadog Forwarder Lambda function.

  2. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your Amazon SES logs in the AWS console:

Data Collected

Metrics

aws.ses.bounce
(gauge)
The average number of emails that resulted in a bounce.
Shown as response
aws.ses.bounce.sum
(gauge)
The total number of emails that resulted in a bounce.
Shown as response
aws.ses.bounces
(gauge)
The number of emails that resulted in a hard bounce.
Shown as response
aws.ses.complaints
(gauge)
The number of emails that were marked by their recipients as spam.
Shown as response
aws.ses.delivery
(gauge)
The average number of emails that Amazon SES successfully delivered to the mail servers of the intended recipients.
Shown as response
aws.ses.delivery.sum
(gauge)
The total number of emails that Amazon SES successfully delivered to the mail servers of the intended recipients.
Shown as response
aws.ses.deliveryattempts
(gauge)
The number of delivery attempts
Shown as event
aws.ses.max_24_hour_send
(gauge)
The maximum number of emails that can be sent in a 24-hour period
Shown as event
aws.ses.open
(gauge)
The number of emails that were opened by their recipients.
Shown as response
aws.ses.publish_expired
(gauge)
Amazon SES encountered an error when it tried to execute the actions you configured, and Amazon SES will no longer retry to deliver the email.
Shown as response
aws.ses.publish_failure
(gauge)
Amazon SES encountered an error when it tried to execute the actions you configured.
Shown as response
aws.ses.rejects
(gauge)
Rejected send attempts (a rejected email is an email that Amazon SES initially accepted, but later rejected because the email contained a virus. Amazon SES notifies you by email and does not send the message.)
Shown as response
aws.ses.reputation_bounce_rate
(gauge)
The percentage of messages that resulted in hard bounces.
Shown as fraction
aws.ses.reputation_complaint_rate
(gauge)
The percentage of messages that were reported as spam by their recipients.
Shown as fraction
aws.ses.send
(gauge)
The email sending API call to Amazon SES was successful and Amazon SES will attempt to deliver the email.
Shown as response
aws.ses.send.sum
(gauge)
The total number of emails sent.
Shown as response
aws.ses.sent_last_24_hours
(gauge)
The total number of emails sent in the past 24 hours.
Shown as event

Each of the metrics retrieved from AWS are assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.

Events

The Amazon Simple Email Service (SES) integration does not include any events.

Service Checks

The Amazon Simple Email Service (SES) integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.

Further reading

Additional helpful documentation, links, and articles: