Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.44

(Home >> Email >> Mail Delivery Reports)

Overview

This feature allows you to search for email messages that users on your system sent and received.

Important

You can only access email messages that belong to accounts that you own.  You must have root user privileges in order to access email messages for all accounts.

How to search for email messages

You can use the Report Inquiry section of the interface to define your search parameters.

To search for email messages, perform the following steps:

  1. Enter the text for which you wish to search in the Search... text box.

    Note

    Search terms are optional.
  2. Select the email message trait for which you wish to search in the menu. The default trait is Recipient.
  3. Select a Search Type.

    Important

    Partial searches may require more time to complete than other search types.
  4. Select a delivery type from the Delivery Type options.
  5. Specify a date range from the Start Date and End Date text boxes. Click the calendar buttons next to each text box to make a selection.

    Important

    • Enter dates with the Month/Day/Year format.
    • An increased range of dates can drastically increase query time for busy mail servers.
  6. Specify the time range with the Start Time and End Time fields. Select AM or PM next to the time text boxes.
  7. Click Run Report.

The results table

By default, results for your query are sorted into eight columns:

ColumnDescription
EventThis column contains an icon that indicates the message's delivery status:
  •  — The message was delivered successfully.
  •  — The message's status is unknown, or delivery is in progress.
  • — The message was deferred.
  •  — The message encountered a delivery error.
  •  — The message was rejected at SMTP time. This typically occurs because the sender's server is configured insecurely or is listed on a RBL.
  •  — The mail server accepted the message but did not deliver it to the recipient's inbox. This typically occurs because the message was filtered by spam software.
SenderThe email address on your system that sent the message.
Sent TimeThe date and time at which the message was sent.
Spam ScoreA score that is based on the number of spam-related traits that are found within the message.
RecipientThe email address to which the message was sent.
IDThe unique identifier for the outgoing email message.
ResultThis column contains a short message about the delivery.
ActionsClick the icon to view and print information about the selected message. This information includes the message's sender, recipient, and username

The Search and Advanced Search features

You can further refine your results in the results table's Search... text box.

Note

The results will remain filtered until you clear the search box.

The results table also features an Advanced Search option. Click Advanced Search to access the four available checkboxes.

 

CheckboxDescription
Show DeliveriesSelect this checkbox if you wish to view the messages that were delivered successfully.
Show DeferralsSelect this checkbox if you wish to view the messages that were deferred.
Show FailuresSelect this checkbox if you wish to view the messages that were not delivered.
Show In-ProgressSelect this checkbox if you wish to view the messages that have been received by the mail transport agent but have not yet been processed (for example, succeeded, failed, or deferred).

You may deselect checkboxes to remove the message types from the results table.

Note

cPanel & WHM limits results to 5000 per Advanced Search type filter.

Adding output results

You may add columns to the results table to view more information. To add columns, perform the following steps:

  • Click the  icon in the top right corner of the results table, and select the information that you wish to view in the table. To hide information from the table, deselect the checkbox.
  • To automatically select the default columns that are described above, click Reset to Default.

Additional columns include:

ColumnDescription
UserThe sender's cPanel username.
DomainThe sender's domain.
Sender HostThe sender's hostname.
Sender IPThe sender's IP address.
AuthenticationThe sender's authentication type.
Delivered ToThe recipient's email address.
Delivery UserThe username that owns the recipient's email address.
Delivery DomainThe recipient's domain.
RouterThe internal router that the mail server uses to determine the message's destination.
TransportThe recipient's SMTP type.
Out TimeThe date and time at which the intended recipient received the message.
Delivery HostThe recipient mail exchanger's hostname.
Delivery IPThe recipient mail exchanger's IP address.
SizeThe size of the outgoing message.