Email Delivery Metrics

Monitor the health, capacity, and performance of the Email Delivery service by using metrics, alarms, and notifications.

This topic describes the metrics emitted by the metric namespace oci_emaildelivery (the Email Delivery service).

Overview of the Email Delivery Service Metrics

Oracle Cloud Infrastructure Email Delivery (Email Delivery) is an email sending service that provides a fast and reliable managed solution for sending high-volume emails that need to reach your recipients' inbox. Email Delivery service metrics help you measure counts for accepted mail, email complaints, emails hard bounced, and emails soft bounced.

  • Accepted Mail: Accepted mail consists of the unique emails accepted by the Email Delivery service to send. Emails are defined by the number of unique emails and the number of unique recipients per message attempted to be delivered, resulting in successful delivery and blocked email. For example, sending an email with 10 recipients means 10 emails accepted.
  • Email Complaints: Email complaints consists of the number of email complaints for a sender by the Email Delivery service.
  • Emails Hard Bounced: Hard bounces occur when a mailbox provider provides a signal that the email address you have tried to send to is not valid. Most often, this happens because the email address does not exist. You should not try to email this address again in the future. The emails hard bounced metric consists of the number of emails hard bounced (permanent failure) for a sender by the recipient domain's email service.
  • Emails Soft Bounced: Soft bounces are messages from a mailbox provider that provide a signal that the email address you have tried to send to is not valid for the time being. Usually, a message soft bounces when the inbox is full or cannot be reached. You can try to email this address again in the future. The emails soft bounced metric consists of the number of emails soft bounced (persistent transient failure) by the recipient domain's email service or because of an inability to reach that service.
  • Emails Relayed: Emails relayed consists of the number of emails that the Email Delivery service has successfully transferred to a recipient domain. The recipient domain has accepted responsibility and will typically deliver these emails, but can still choose to discard, quarantine, or bounce. A single email may be both relayed and bounced.
Note

Email Delivery is billed for every 1,000 emails accepted.

Prerequisites

IAM policies: To monitor resources, you must be given the required type of access in a policy  written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. The policy must give you access to the monitoring services as well as the resources being monitored. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which compartment  you should work in. For more information on user authorizations for monitoring, see the Authentication and Authorization section for the related service: Monitoring or Notifications.

Available Metrics: oci_emaildelivery

The metrics listed in the following table are automatically available for any policies you create. You do not need to enable monitoring on the resource to get these metrics. However, your tenancy must have Email Delivery configured and must send mail to make the oci_emaildelivery metric space available in the Metrics Explorer feature.

Each metric includes the following dimensions:

RESOURCEID
The OCID  of the policy to which the metric applies.
Metric Metric Display Name Unit Description Dimensions
EmailsAccepted Emails Accepted count The number of unique emails accepted by the Email Delivery service. resourceID (The OCID of the approved sender to which the metric applies.)

resourceDomain (The domain name of the approved sender email address to which the metric applies.)

EmailsBlocklist Emails Blocklist count The number of email blocked by blocklist.
EmailComplaints Email Complaints count The number of email complaints for a sender by the Email Delivery service.
EmailsHardBounced Emails Hard Bounced count The number of emails hard bounced (permanent failure) for a sender by the recipient domain's email service.
EmailsSoftBounced Emails Soft Bounced count The number of emails soft bounced (persistent transient failure) by the recipient domain's email service or due to an inability to reach that service.
EmailsSuppressed Emails Suppressed count The number of email suppressed for a tenant by the Email Delivery service.
EmailsRelayed Emails Relayed count The number of emails that the Email Delivery service has successfully transferred to a recipient domain.

Using the Console

Email Delivery service metrics are currently only available using the Metrics Explorer feature in the Console. For more information about metrics, see Viewing Metric Charts.

To view Email Delivery metric charts
  1. Open the navigation menu and click Observability & Management. Under Monitoring, click Metrics Explorer.

    For Metric namespace, select oci_emaildelivery.

  2. Select a metric to view from the Metric name field.

  3. Select a qualifier specified in the Dimension Name field. For example, the dimension resourceId is specified in the metric definition for EmailsAccepted.
  4. Select the value you want to use for the specified dimension in the Dimension Value field. For example, the resource identifier for your instance of interest.

  5. Click Update Chart.

    The chart will be updated with the metrics that have been requested.

For more information about monitoring metrics and using alarms, see Monitoring. For information about notifications for alarms, see Notifications.