You can trace the delivery path of an email sent from a customer's domain to identify where a message may have been delayed or rejected. This process is performed within the WHM interface and is available to users with the appropriate reseller permissions.
Before you begin
You will need:
Reseller access to the WHM interface.
The specific email address of the sender and the recipient.
The domain name associated with the customer's account.
Trace an email in the Exim Mail Queue
Log in to WHM.
Navigate to Email > Mail Delivery Reports.
Enter the sender's email address and the recipient's email address.
Click Search.
Review the results to see the delivery status and the path the email took through the mail servers.
Trace a message in the Exim Mail Queue
If a message is currently stuck in the local mail queue, you can investigate it directly.
Log in to WHM.
Navigate to Email > Mail Queue.
Locate the message in the list by searching for the sender or recipient email address.
Select the message and click Trace.
Review the output to determine if the message is being held by a remote server or if it was rejected by a specific gateway.
If the email is not found in the queue
If a message is not found in the Mail Queue, it may have already been processed or rejected by the local server.
Check the Mail Delivery Reports: Use the search tool described in the first procedure to see if a log exists for the transaction.
Verify DNS Records: Ensure the customer's MX records are correctly pointing to the intended mail server.
Check for Greylisting: If the sending server supports greylisting, the email may be delayed for several minutes before a second attempt is made.
Limitations
This tool provides information based on the logs available to the local mail server.
If a remote server accepts a message but fails to deliver it to the final mailbox, the trace will only show the successful delivery to that remote server.
This procedure does not provide real-time tracking of an email currently in transit; it only shows the history of the delivery attempt.
