Guide to Metrics and Logs for Email Delivery

OCI provides the reporting data through the Metrics service using the pre-aggregated time-series count data provided by the OCI Monitoring service. Metrics use the oci_emaildelivery namespace and are filtered by approved sender or email sender domain.

You can view metrics in any of the following locations:

• Email Deliverability Dashboard (top set of boxes)
• Metrics sidebar menu on the detail pages for approved senders or email domains
• Service Metrics page in the Monitoring service
• Metrics Explorer page in the Monitoring service
• Customizable OCI Dashboards by using Monitoring widgets

For API access, use the ListMetrics operation to list available metric names. Use the SummarizeMetricsData operation to retrieve metric data from the oci_emaildelivery namespace.

Setup needed:

Apply metrics monitoring policies for Email Delivery (inspect and read permissions).

Available data:

For full metric details, see Available Metrics: oci_emaildelivery. Metric types include:

• Emails Accepted
• Emails Relayed
• Emails Hard Bounced
• Emails Soft Bounced
• Emails Suppressed (blocked)
• Email Complaints
• Emails ListUnsubscribed
• Total Emails Opened
• Total Emails Clicked

Metrics data can be grouped by the following dimensions:

• resourceId (approved sender)
• resourceDomain (email sender domain)

OCI provides the reporting data using the detailed event log data from the OCI Logging service. Logs are available by email sender domain and you can query logs for up to 14 days at a time.

Setup needed:

EMAIL_DOMAIN_UPDATE and standard logging policies are required. Enable logs on each domain to collect and view log data.

Available data:

For information about log record structure, available fields, and sample log records, see Email log details.