Viewing metrics for Amazon SES email receiving - Amazon Simple Email Service

Viewing metrics for Amazon SES email receiving

If you've enabled email receiving in Amazon SES and you've created receipt rules for your email, you can view the metrics for those receipt rule sets and rules using Amazon CloudWatch.

In the CloudWatch console, you'll find the metrics under Metrics > All metrics > SES > Receipt Rule Set Metrics and Receipt Rule Metrics.

Note

Receipt Rule Set Metrics and Receipt Rule Metrics will not appear under SES if you have not yet:

The following message metrics are available:

  • Message receiving

    Scope Metric Description Dimension
    Receipt Rule Set Metrics Received SES successfully received a message that has at least one rule that applies. This metric can only have a value of 1. RuleSetName
    Receipt Rule Metrics Received SES successfully received a message and will try to process the applied rule. This metric can only have a value of 1. RuleName

  • Message publishing

    Scope Metric Description Dimension
    Receipt Rule Set Metrics PublishSuccess SES successfully executed all rules that apply within a rule set. RuleSetName
    Receipt Rule Metrics PublishSuccess SES successfully executed a rule that applies to the receiving message. RuleName
    Receipt Rule Set Metrics PublishFailure SES encountered an error when it tried to execute rules within a rule set, execution will be retried. RuleSetName
    Receipt Rule Metrics PublishFailure SES encountered an error when it tried to execute the actions in a rule—depending on the error, execution may be retried. RuleName
    Receipt Rule Set Metrics PublishExpired SES will no longer retry to execute the rules because they didn't succeed within 36 hours, or encountered non-retriable error. RuleSetName
    Receipt Rule Metrics PublishExpired SES will no longer retry to execute the rule's actions because they didn’t succeed within 36 hours. RuleName
Note

  • In the preceding tables, the term applies means that the sender is not blocklisted by IP Filters or is on SES's internal blocklist, and the rule has matching recipient conditions and matching TLS policy.

  • Publish failure errors can occur, for example, if you deleted or revoked permissions to an Amazon S3 bucket, Amazon SNS topic, or Lambda function that an action in one of your receipt rules was configured to use.

  • Because only one rule set can be active at a time, SES publishes an aggregate metric displayed as RuleSetName:[Active] for all rules sets that were active for the time range you select in CloudWatch. This has the advantage of letting you freely change rule sets without any change to your alarming setup.

Important

Changes you make to fix your receipt rule set will apply only to emails that Amazon SES receives after the update. Emails are always evaluated against the receipt rule set that was in place at the time the email was received.

Metrics for an SES receipt rule set displayed in the CloudWatch console.

Receipt rule set metrics in CloudWatch.

Metrics for an SES receipt rule displayed in the CloudWatch console.

Receipt rule metrics in CloudWatch.