Kavi Mailing List Manager Help

Chapter 48. Mail Logs

Overview

The Mail Logs tool is used to retrieve information about an email so you can see if it's been successfully delivered or not. Search for email based on a search string (e.g., an email address, an email domain, an alias) or time range to search (e.g., 'Today', 'Yesterday', 'Last 2 Days', etc.), or both. The information is derived from the raw qmail logs, then refined for ease-of-use before being displayed. Multiple entries from the raw logs that pertain to the same email are combined into a single entry in the Mail Logs results table.

The results display date and time information about an email transfer, such as when the email transfer began, when the transfer to a particular address was attempted and when the transfer process terminated. Other information includes the sender and receiver(s) email addresses, the size of the email transmission and information about the success of the transmission.

You may search by any string, including all or part of an email address (e.g., just the domain), a username, alias (e.g., 'webmaster'). You can also set the number of results to display per page (the default is 20).

Note

Mail Logs searches are compute intensive, so for best results you should only search back as far as you need to, and only one person should perform a search at a time.

Use the Mail Logs page to:

Search and view mail logs to determine if a message has been successfully delivered.

Back to top

How to use the Mail Logs tool

Options

The following fields are displayed:

Search

Enter the text or string for which you'd like to search. This tool will return results for partial matches. For instance, if you entered the partial email domain 'example.', the search would return any user whose email address contains that text string, including 'bob@research.example.com', 'hana@example.co.jp' and 'admin@example.com'.

Search Time

Set the range of dates you'd like to search (e.g., 'Today', 'Yesterday', 'Last 2 Days', 'Last 3 Days', 'Last 4 Days' 'Last 7 Days').

Note

It takes a long time to process a week's worth of logs, so if you select the 'Last 7 Days' option, be prepared to wait a minute or more for the tool to read the raw logs, process and display the content. It's best to select the shortest range that will meet your needs.

Results per page

Set the number of results to display per page (e.g., '10', '20', '50', '100', '200'). The default is 20.

Results

If this were a message posted to a mailing list, the entry for the transfer of the email from the originator to the mailing list's mailbox would look something like this:

2005-06-06 07:38:24 <originator@example.com> ... sent 47957 bytes from qp 6629

2005-06-06 07:38:24 + example-listname@example.org ... success: ezmlm-send: info: qp 6636

2005-06-06 07:38:24 end (1+0+0)

The first line displays the date and time that the email originated, the originator's email address, the size of the message in bytes and a qmail ID. The time is determined by the originating host's time clock, on a twenty-four hour clock (i.e., ANSI or military time), normalized to Universal Time.

The second line displays the date and time that the receiving host began processing the transfer, the receiving host's email address and a message indicating whether the transfer was completed successfully, was deferred (i.e., unable to be completed at this time, in which case the system will try to complete the transfer again later) or a failure. In this example, this line contains the name of the 'ezmlm-send' process and another qmail ID, which means the message has not completed it's journey to its final destination and is being forwarded via ezmlm-send. Since this is a mailing list, this entry shows the leg of the journey from the originator to the mailing list mailbox. As you may have guessed, the second qmail ID represents the next leg of the journey, the transfer from the mailing list to the individual subscribers, as shown in the next sample entry.

The last line displays the date and time that the transfer was completed, the word 'end' to indicate the end of the transfer process, and a set of numbers in parentheses, each of which represents a count of the number of messages that fall into a certain completion status. The first number in the series represents the number of successfully completed transfers, the second is the number of transfers deferred, and the third is the number of failures. In this case, one transfer was completed successfully, and there were no deferrals or failures.

2005-06-06 07:38:24 <listname@example.org 10> ... resent 48021 bytes from qp 6636

2005-06-06 07:38:27 + yoshi@example1.co.jp ... success: XXX.XXX.XXX.XXX accepted message.

2005-06-06 07:38:26 + bob@example2.com ... success: XXX.XXX.XXX.XXX accepted message.

2005-06-06 07:38:29 + dana@research.example2.com ... success: XXX.XXX.XXX.XXX accepted message.

2005-06-06 07:38:28 + jim@example1.com ... success: XXX.XXX.XXX.XXX accepted message.

2005-06-06 07:38:39 + kim@research.example1.com ... success: XXX.XXX.XXX.XXX accepted message.

2005-06-06 07:38:28 + pearl@example3.com ... deferral: Remote host said: 451 HEUR: Error scanning message

2005-06-06 07:45:07 + pearl@example3.com ... success: XXX.XXX.XXX.XXX accepted message.

2005-06-06 07:38:25 + sam@example4.com ... success: XXX.XXX.XXX.XXX accepted message.

2005-06-06 07:45:07 end (7+1+0)

This entry displays information about the transfer of a message that has been posted to a mailing list from the list mailbox to the subscribers mailboxes. This is a small, private list with only seven subscribers.

As in the previous entry, the first line displays the date and time that the email originated, the originator's email address (which in this case is the list name), the size of the message in bytes and a qmail ID. The difference is that this time the status information says that the message was 'resent', indicating it was forwarded by the mailing list. The status information also indicates the message is 'from qp 6636', which is, of course, the ID assigned to this stage of the transfer process during the previous stage of the process. You can use the qmail IDs to follow email through multiple discrete transfer processes until it reaches its final destination.

Each of the next eight lines represents an attempt to transfer the email from the list to a subscriber. The reason there are eight lines instead of seven is that one of the transfer attempts was temporarily deferred, although it was subsequently successful. Each line displays the date and time that the receiving host began processing the transfer, the receiver's email address and a message indicating whether the transfer was completed successfully, was deferred (i.e., unable to be completed at this time so the system will retry the transfer later) or a failure. This information would include the IP addresses of each resolvable email address, represented here by a series of X's.

As before, the last line displays the date and time that the transfer was completed, the word 'end' to indicate the end of the transfer process, and a set of numbers representing the total count of successful transfers, deferred transfers and failed transfers. The string of values in parentheses '(7+1+0)' indicates seven transfers were completed successfully, there was one deferral and no failures. If this final line is missing from a log entry, a deferred transfer was still pending at the time the log was generated.

Back to top