--- title: Amazon SES description: >- Amazon Simple Email Service (SES) is a cost-effective outbound-only email-sending service breadcrumbs: Docs > Integrations > Amazon SES --- # Amazon SES Integration version1.0.0 ## Overview{% #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{% #setup %} ### Installation{% #installation %} If you haven't already, set up the [Amazon Web Services integration first](https://docs.datadoghq.com/integrations/amazon_web_services/). ### Metric collection{% #metric-collection %} 1. In the [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services), ensure that `SES` is enabled under the `Metric Collection` tab. 1. Add the following permissions to your [Datadog IAM policy](https://docs.datadoghq.com/integrations/amazon_web_services/#installation) 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](https://docs.aws.amazon.com/ses/latest/dg/control-user-access.html) on the AWS website. 1. Install the [Datadog - Amazon SES integration](https://app.datadoghq.com/integrations/amazon-ses). ### Log collection{% #log-collection %} #### Enable logging{% #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{% #send-logs-to-datadog %} 1. If you haven't already, set up the [Datadog Forwarder Lambda function](https://docs.datadoghq.com/logs/guide/forwarder/). 1. 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: - [Add a manual trigger on the S3 bucket](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#collecting-logs-from-s3-buckets) - [Add a manual trigger on the CloudWatch Log Group](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function/#collecting-logs-from-cloudwatch-log-group) ## Data Collected{% #data-collected %} ### Metrics{% #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.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.open**(gauge) | The number of emails that were opened by their recipients.*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.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.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.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.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{% #events %} The Amazon Simple Email Service (SES) integration does not include any events. ### Service Checks{% #service-checks %} The Amazon Simple Email Service (SES) integration does not include any service checks. ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/). ## Further Reading{% #further-reading %} - [Amazon SES monitoring: Detect phishing campaigns in the cloud](https://www.datadoghq.com/blog/detect-phishing-activity-amazon-ses/)