Track Delivery

Valid for versions 84 through the latest version

Version:

82

84


Last modified: October 19, 2020

Overview

This interface displays a report about email message deliveries from your account. You can also use this interface to trace an email’s delivery route. Tracing the route can help you find delivery problems.

The Recipient Email (optional) text box lets you to filter the Delivery Report table results to a specific email address. To do so, perform the following steps:

  1. Enter an email address in the Recipient Email (optional) text box.

  2. Click Run Report. The system will filter the Delivery Report table to only display results for the recipient email address. It will also display the Email Address Trace diagram.

To reset the Delivery Report table’s results, perform the following steps:

  1. Remove the email address from the Recipient Email (optional) text box.

  2. Click Run Report. This will remove the filter from the Delivery Report table and display all email message results.

    Note:

    This will not reset the Email Server Trace diagram.

You can use the following options to filter the results of the Delivery Report table:

  • Show Blocked & Failed — This option will filter the table to only display delivery failures.
  • Show All — Display all deliveries. This will also update the Recipient Email (optional) search results.

Delivery Report

Warning:
  • If the server uses a third-party mail service, such as MailScanner, this feature will return invalid results. Also, if your hosting provider has not enabled this feature, the interface will display an empty table. If you experience issues when you use this feature, contact your hosting provider for more information about your server’s configuration.

  • If you do not see messages displayed in this table, your hosting provider has not enabled this feature. Contact them and ask them to enable it in WHM’s Service Manager interface (WHM >> Home >> Service Configuration >> Service Manager).

  • The table only displays messages for which the eximstats database stores data.

By default, the table lists the 250 most recent messages to and from your cPanel account’s mailboxes. This includes every delivery success and failure. The table sorts the data into the following columns by default:

  • Event — An icon that indicates the message’s delivery status:

    • Success — The system delivered the message.

    • Unknown — The message’s status is unknown, or delivery is in progress.

    • Deferred — The system deferred the message.

    • Error — The message encountered a delivery error.

    • Archived — The system archived the message. For more information, read our Archive documentation.

    • Rejected — The system rejected and discarded the message at Simple Mail Transfer Protocol (SMTP) time. This can occur when the sender’s server does not use a secure configuration or the server is on a Real-time Blackhole List (RBL).

    • Filtered — The mail server accepted the message but it did not deliver the message to the recipient’s inbox. This can occur when spam software filters a message or if a recipient has custom email filters.

  • From Address — The email address on your system that sent the message.

  • Sender — The sender’s cPanel username.

  • Sent Time — The date and time when the user sent the message.

  • Spam Score — The message’s Apache SpamAssassin™ score.

  • Recipient — The email address to which the user sent the message.

  • Result — A message that describes the delivery results.

  • Actions — Click the information icon (Info) to view and print information about the selected message. This information includes information such as a message’s sender, recipient, and username.

The system retains this data for the amount of days that your hosting provider specifies for the The interval, in days, to retain Exim stats in the database (Minimum: 1; Maximum: 365,000) option in the Stats and Logs section of WHM’s Tweak Settings interface (WHM >> Home >> Server Configurations >> Tweak Settings).

Delivery Report table options

You can filter your search results with the following options:

Record selection

To filter the records:

  1. Select any of the following checkboxes:

    • Show Successes
    • Show Deferred
    • Show Failures
    • Show In-Progress
  2. Select the maximum number of results to display from the Max Results/Type menu.

Column selection

To select the columns that you wish to display or hide in the Delivery Report table, click the table options icon (Options). A new window will appear. In this window, select or deselect the checkboxes for the following column headers:

  • Select All — Select all of the available options.

  • Event — An icon that indicates the message’s delivery status.

  • User — The cPanel username of the sender.

  • Domain — The sender’s domain.

  • From Address — The email address on your system that sent the message.

  • Sender — The sender’s cPanel email address.

  • Sent Time — The date and time at which the user sent the message.

  • Sender Host — The sender’s host’s IP address.

  • Sender IP Address — The sender’s IP address.

  • Authentication — A type of SMTP authentication.

  • Spam Score — The email’s Apache SpamAssassin score.

  • Recipient — The email address to which the user sent the message.

  • Delivery User — The cPanel username that owns the recipient’s email address.

  • Delivery Domain — The domain of the recipient.

  • Delivered To — The email address of the recipient.

  • Router — The internal router that handled the delivery of the message.

  • Transport — The recipient’s SMTP method type.

  • Out Time — The date and time at the intended recipient received the message.

  • ID — The outgoing message’s ID.

  • Delivery Host — The hostname of the recipient’s email exchanger.

  • Delivery IP Address — The recipient email exchanger’s IP address.

  • Size — The size of the outgoing message, in bytes.

  • Result — A message that describes the delivery results.

  • Actions — Displays the information icon (Info). This lets you view and print information about a message.

Email Address Trace

This diagram displays how the system would send an email message to the given email address. It traces how the local system routes a message. You can use this feature to find potential problems with message delivery. Each icon displays information about the message’s delivery path:

Note:

The following icons may vary from those that your system uses.

  • Local — The system delivered the message to a local inbox.

  • Remote — The system delivered the message to a remote mailbox.

  • Defer — The system deferred the message.

  • Reject — The system rejected the message.

  • Error — The system encountered a delivery error.

  • Command — The system will receive the message.

  • Discard — The system discarded the message.

Additional Documentation