Knowledgebase: WHM > Email > Mail Delivery Reports
Mail Delivery Reports
Posted by Matthew Jeffels, Last modified by Matthew Jeffels on 24 December 2016 12:16 PM

Mail Delivery Reports

This interface allows you to search for emails that users on your system have sent and received. Only users that have root-level access privileges can access the emails for all accounts. Resellers can access the emails that belong to accounts that they own.

Search For Emails

The report inquiry section of this interface allows you to search for specific emails through a range of defined parameters that you may specify. 

To search for emails you will need to perform the following;

First you should enter the text that you wish to search for in the "Search" textbox. Search terms are optional.

Select the part of the email that you wish to query. The default trait that is selected should be "Recipient".

Select a "Search Type" button. Partial searches may cause the search to take more time to complete compared to other searches. 

Select a "Delivery Type" button.

Enter a date range in the "Start Date" and "End Date" textboxes, or you can click the calendar icons to select dates. Dates need to be entered in the MM/DD/YYYY format, where MM is the two-digit month, DD is the two-digit day, and YYYY is the four-digit year. A large date range will drastically increase query time for busy mail servers.

Enter a time range in the Start Time and End Time text boxes. Select AM or PM next to each text box.

Finally click "Run Report".

Results

By default, results for your query appear in the following columns:

Event This column contains an icon that indicates the email's delivery status;

Green Tick — The system delivered the email successfully.
Blue Question mark — The email's status is unknown, or delivery is in progress.
Yellow Exclamation mark— The email was deferred.
Red cross — The email encountered a delivery error.
Black Exclamation mark— The email was rejected at SMTP time. This typically occurs because the sender's server is configured insecurely or is listed on a RBL.

Sender - This column displays the email address that sent the email.
Sent Time - This column displays the date and time at which the email was sent.
Spam Score - This column displays a score that the system bases on the number of spam-related traits that the email contains.
Recipient - This column displays the email address to which the email was sent.
ID - This column displays the unique identifier for the outgoing email.
Result - This column contains a short email about the delivery.
Actions - This column allows you to click the magnifying glass icon to view and print information about the selected email. This information includes the email's sender, recipient, and username.

Search and Advanced Search Features

You are able to further refine your results in the results table's "Search" text box. These 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 additional checkboxes;

Show Deliveries - Selecting this checkbox allows you to view the emails that the system delivered successfully.
Show Deferrals - Selecting this checkbox allows you to view the emails that were deferred.
Show Failures - Selecting this checkbox allows you to view the emails that were not delivered.
Show In-Progress - Selecting this checkbox allows you to view the emails that were received by the mail transport agent but that the system has not yet processed (for example, succeeded, failed, or deferred).

You may deselect checkboxes to remove the email types from the results table. cPanel & WHM limits the results to 5000 per Advanced Search type filter.

Additional Results Columns

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

Click the "gear icon" in the top right corner of the results table. This will allow you to select the checkbox for the information that you wish to view in the table. In order to hide information from the table, deselect the checkbox.
To automatically select the default columns you should click "Reset to Default".

You can choose to add any of the additional columns;

User - This allows you to view the sender's cPanel username.
Domain - This allows you to view the sender's domain.
Sender - Host The sender's hostname.
Sender IP - This allows you to view the sender's IP address.
Authentication - This allows you to view the sender's authentication type.
Delivered To - This allows you to view the recipient's email address.
Delivery User - This allows you to view the username that owns the recipient's email address.
Delivery Domain - This allows you to view the recipient's domain.
Router - This allows you to view the internal router that the mail server uses to determine the email's destination.
Transport - This allows you to view the recipient's SMTP type.
Out Time - This allows you to view the date and time at which the intended recipient received the email.
Delivery Host - This allows you to view the recipient mail exchanger's hostname.
Delivery IP - This allows you to view the recipient mail exchanger's IP address.
Size - This allows you to view the size of the outgoing email, in bytes.

Thanks

Matt Jeffels
PAC Web Hosting

(0 vote(s))
Helpful
Not helpful

Comments (0)