Overview

The Reporting Dashboard offers an incredible amount of metrics - both accumulated counts and calculated rates - that can be broken down further by dimension (i.e. meaningful groupings of data, for example, per IP or by domain).

As such, the information below seeks to help you fully understand what this data actually means. There are three tables that comprehensively cover:

Counts
Rates
Dimensions (And Filters)

Locating The Metrics

To view the metrics on your account:

First, log in to the Mailgun Control Panel (if you have not already done so).
Then, within the Navigation Menu on the left side of the Mailgun Control Panel, click the Metrics option. (If needed, click the Send product first to expand the drop-down list of options; Metrics is an option within the Reporting section of the Send product).

Counts

By clicking on the Metrics button, you can to choose up to 10 of the following counts to report on. The Apply button must be clicked for the changes to take effect.

Type API Variable Name & Calculation Category & Description

Accepted

API Variable Name:
accepted_count

Calculation:
accepted_incoming_count + accepted_outgoing_count

Category:
Engagement counts

Description:
A sum of incoming and outgoing accepted events. This includes all accepted emails to be sent as well as routes, forwards, mailing lists, and batch events.

To only view accepted events on emails sent to recipients, use the Accepted Outgoing metric.

Accepted events are not associated to IP addresses. The “processed” metric can be used in place of accepted to view similar data by IP.

Accepted incoming

API Variable Name:
accepted_incoming_count

Calculation:
Sum of all raw accepted_incoming events.

Category:
Accepted counts

Description:
Mailgun accepted the API request to forward, and the message has been put in your queue. These accepted events only cover routes, forwards, and mailing lists. Mailing lists will record a single accepted incoming event, with emails sent to recipients recording their own accepted outgoing events.

Accepted outgoing

API Variable Name:
accepted_outgoing_count

Calculation:
Sum of all raw accepted_outgoing events.

Category:
Accepted counts

Description:
Mailgun accepted the API request to send, and the message was put in your queue. Batch sends will result in one additional accepted outgoing event to record the initial batch request.

Accepted events are not associated to IP addresses. The “processed” metric can be used in place of accepted to view data by IP.

Bounced (all)

API Variable Name:
bounced_count

Calculation:
permanent_failed_count -(suppressed_bounced_count
+ suppressed_complaints_count
+ suppressed_unsubscribed_count)

Category:
Failed counts

Description:
A sum of all soft and hard bounces. Permanent failures fall into three categories, soft bounces, hard bounces, and suppressions. This field is equal to permanent failures minus suppressions.

Clicked

API Variable Name:
clicked_count

Calculation:
Sum of all raw clicked events.

Category:
Engagement counts

Description:
The email recipient clicked on a link in the email. Click tracking must be turned on and the CNAME record must be pointing to mailgun.org.

Complained

API Variable Name:
complained_count

Calculation:
Sum of all raw complained events.

Category:
Engagement counts

Description:
The email recipient clicked on the spam complaint button and the recipient's email server provides feedback loops to Mailgun for these complaints.

Delayed bounces

API Variable Name:
delayed_bounce_count

Calculation:
Sum of all raw failed events with a severity equal to “permanent” and is-delayed-bounce equals true.

Category:
Failed counts

Description:
Emails were initially marked as delivered, but later received a permanent failure from the mailbox provider.

Delayed first attempt

API Variable Name:
delayed_first_attempt_count

Calculation:
delivered_two_plus_attempts_count + permanent_failed_old_count

Category:
Failed counts

Description:
Emails that were temporarily rejected on the first delivery attempt. These emails will have been retried until delivery or until a “too old” permanent failure is generated.

Delivered

API Variable Name:
delivered_count

Calculation:
delivered_http_count + delivered_smtp_count