--- title: Amazon SES description: >- Amazon Simple Email Service (SES) is a cost-effective outbound-only email-sending service breadcrumbs: Docs > Integrations > Amazon SES --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # Amazon SES Integration version1.2.0 {% callout %} # Important note for users on the following Datadog sites: us2.ddog-gov.com {% alert level="info" %} To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator. To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com). {% /alert %} {% /callout %} ## 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.md). ### 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.md#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.md). 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.md#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.md#collecting-logs-from-cloudwatch-log-group) ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} | | | | | **aws.ses.approximate_dedicated_sending_percentage**(gauge) | The approximate percentage of traffic that was delivered through a dedicated IP address of the managed IP pool.*Shown as percent* | | **aws.ses.available_2_4hour_send**(gauge) | The available capacity of the internet service provider (ISP) for the managed IP pool during the last 24 hours.*Shown as email* | | **aws.ses.blacklisted_ips**(gauge) | The number of dedicated IP addresses that are listed on a blocklist. | | **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.click**(gauge) | The average number of emails in which the recipient clicked one or more links.*Shown as response* | | **aws.ses.click.sum**(gauge) | The total number of emails in which the recipient clicked one or more links.*Shown as response* | | **aws.ses.complaint**(gauge) | The average number of delivered emails that the recipient marked as spam.*Shown as response* | | **aws.ses.complaint.sum**(gauge) | The total number of delivered emails that the recipient marked 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.delivery_delay**(gauge) | The average number of emails that couldn't be delivered to the recipient's mail server because a temporary issue occurred.*Shown as response* | | **aws.ses.delivery_delay.sum**(count) | The total number of emails that couldn't be delivered to the recipient's mail server because a temporary issue occurred.*Shown as response* | | **aws.ses.email_address_insights_confidence_verdict_high**(gauge) | The number of validated email addresses that received a high overall validity confidence verdict. | | **aws.ses.email_address_insights_confidence_verdict_low**(gauge) | The number of validated email addresses that received a low overall validity confidence verdict. | | **aws.ses.email_address_insights_confidence_verdict_medium**(gauge) | The number of validated email addresses that received a medium overall validity confidence verdict. | | **aws.ses.open**(gauge) | The number of emails that were opened by their recipients.*Shown as response* | | **aws.ses.open.sum**(gauge) | The total number of emails that were opened by their recipients.*Shown as response* | | **aws.ses.publish_expired**(gauge) | The average number of emails for which Amazon SES stopped retrying the receipt rules or actions after they failed for 36 hours or hit a non-retriable error.*Shown as response* | | **aws.ses.publish_expired.sum**(count) | The total number of emails for which Amazon SES stopped retrying the receipt rules or actions after they failed for 36 hours or hit a non-retriable error.*Shown as response* | | **aws.ses.publish_failure**(gauge) | The average number of emails for which Amazon SES encountered an error when it tried to execute the receipt rules or actions.*Shown as response* | | **aws.ses.publish_failure.sum**(count) | The total number of emails for which Amazon SES encountered an error when it tried to execute the receipt rules or actions.*Shown as response* | | **aws.ses.publish_success**(gauge) | The average number of emails for which Amazon SES successfully executed the receipt rules or actions.*Shown as response* | | **aws.ses.publish_success.sum**(count) | The total number of emails for which Amazon SES successfully executed the receipt rules or actions.*Shown as response* | | **aws.ses.received**(gauge) | The average number of emails that Amazon SES successfully received and to which at least one receipt rule applies.*Shown as response* | | **aws.ses.received.sum**(count) | The total number of emails that Amazon SES successfully received and to which at least one receipt rule applies.*Shown as response* | | **aws.ses.reject**(gauge) | The average number of emails that Amazon SES accepted but rejected because they contained a virus.*Shown as response* | | **aws.ses.reject.sum**(count) | The total number of emails that Amazon SES accepted but rejected because they contained a virus.*Shown as response* | | **aws.ses.rendering_failure**(gauge) | The average number of emails that weren't sent because of a template rendering issue.*Shown as response* | | **aws.ses.rendering_failure.sum**(count) | The total number of emails that weren't sent because of a template rendering issue.*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.reputation_deliveries_eligible_for_bounce_rate**(gauge) | The number of deliveries that are counted when calculating the bounce rate.*Shown as email* | | **aws.ses.reputation_deliveries_eligible_for_complaint_rate**(gauge) | The number of deliveries that are counted when calculating the complaint rate.*Shown as email* | | **aws.ses.reputation_enforceable_bounces**(gauge) | The number of bounces that are counted toward the enforced bounce rate.*Shown as email* | | **aws.ses.reputation_enforceable_complaints**(gauge) | The number of complaints that are counted toward the enforced complaint rate.*Shown as email* | | **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_2_4hours**(gauge) | The number of emails sent through the internet service provider (ISP) for the managed IP pool in the last 24 hours.*Shown as email* | | **aws.ses.sndscomplaint_rate**(gauge) | The fraction of messages from the dedicated IP address that Outlook users complained about during the activity period, as reported by Outlook Smart Network Data Services (SNDS).*Shown as fraction* | | **aws.ses.sndsdatacommands**(gauge) | The number of Simple Mail Transfer Protocol (SMTP) DATA commands from the dedicated IP address that Outlook Smart Network Data Services (SNDS) perceived during the activity period.*Shown as command* | | **aws.ses.sndsmessage_recipients**(gauge) | The number of recipients on messages from the dedicated IP address that Outlook Smart Network Data Services (SNDS) perceived during the activity period. | | **aws.ses.sndsrcptcommands**(gauge) | The number of Simple Mail Transfer Protocol (SMTP) RCPT commands from the dedicated IP address that Outlook Smart Network Data Services (SNDS) perceived during the activity period.*Shown as command* | | **aws.ses.sndsspam_rate**(gauge) | The combined result of spam filtering on all mail from the dedicated IP address, as reported by Outlook Smart Network Data Services (SNDS). The value is 0 for less than 10% spam, 0.5 for 10% to 90%, and 1 for 90% or more.*Shown as fraction* | | **aws.ses.sndstrap_hits**(gauge) | The number of messages from the dedicated IP address that were sent to Outlook trap accounts, as reported by Outlook Smart Network Data Services (SNDS).*Shown as message* | | **aws.ses.subscription**(gauge) | The average number of delivered emails for which the recipient updated the subscription preferences.*Shown as response* | | **aws.ses.subscription.sum**(count) | The total number of delivered emails for which the recipient updated the subscription preferences.*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.max_send_rate**(gauge) | The maximum number of emails that can be sent per second*Shown as event* | | **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 %} Additional helpful documentation, links, and articles: - [Amazon SES monitoring: Detect phishing campaigns in the cloud](https://www.datadoghq.com/blog/detect-phishing-activity-amazon-ses/)