Show Stat Mail

Shows messaging statistics regarding dispatch requests and other messaging statistics.

Details

If you issue a tell router quit command followed by a load router command, or if you issue a restart task router command, all mail.* statistics are reset to zero (0).

You can also see the messaging statistics from the Domino® Administrator by clicking Mail on the Server > Statistics tab.

Syntax

 Show Stat Mail

Examples

show stat mail

The following table lists and describes the statistics that show how much memory is in use for open messages.

Table 1. Statistics that show memory in use
Statistic Description

Mail.MessageCache.Memory.Cache.Max

This is constant. The limit in bytes of the size of note memory used for in-process messages beyond which notes will no longer be cached in the message queue entry. If a value is provided for RouterMaxQueueMemorySizeBytes, this statistic will have that value. If a value is not provided for RouterMaxQueueMemorySizeBytes, this statistic will contain the default calculated value.

MAIL.MessageCache.Memory.Current

The amount of note memory currently in use on behalf of the router. It includes notes on the MailEvent queue, in the main queue entry, and in process by transfer and delivery threads. It also includes any copies of messages prepared and cached for delivery if multiple delivery recipients are receiving the message.

Mail.MessageCache.Memory.Event.Max

This is constant. The limit in bytes of the size of note memory used for in-process messages beyond which copies of notes will not be put onto the mailbox event queue. If a value is provided for RouterMaxEventMemorySizeBytes, then this statistic will have that value. If a value is not provided for RouterMaxEventMemorySizeBytes, this statistic will contain the default calculated value.

Mail.MessageCache.Memory.Peak

The highest value seen for MAIL.MessageCache.Memory.Current

MAIL.MessageCache.Messages.Aged

The number of notes cached in the mail queue entry that were closed out due to age. For example, this can occur when a message is pending in a transfer queue in retry, or waitiing for low priority mail.

MAIL.MessageCache.Messages.Current

Current® count of notes cached in all mail queue entries.

MAIL.MessageCache.Messages.Peak

The highest value seen for MAIL.MessageCache.Messages.Current

MAIL.MessageCache.Opens.Copied

Count of message copies taken including copies of messages ready for delivery. This is an optimized way to obtain the message; therefore, higher numbers here are good. The note passed via the MailEvent is considered a copy.

MAIL.MessageCache.Opens.Current

Count of open message instances (notes), whether obtained by copy or full note open.

MAIL.MessageCache.Opens.Current.Peak

The highest value seen for MAIL.MessageCache.Opens.Current

MAIL.MessageCache.Opens.Opened

Count of message instances that required a full note open including copies of messages ready for delivery. This is an unoptimized way to obtain a copy of the message; therefore, smaller numbers here are good.

Note: Every message found in the mailboxes on startup will be opened in this way.

The following table lists and describes the statistics that show how many messages are discovered by means of the event mechanism versus search.

Table 2. Statistics that show messages discovered by means of the event mechanism

Statistic

Description

MAIL.Messages.Read.Event.New

Number of messages discovered by mailbox event notification.

MAIL.Messages.Read.Event.IntUpdate

Number of message updates by event notification done by the router to reflect completed recipients.

MAIL.Messages.Read.Event.ExtUpdate

Number of updates or deletes of messages in mailboxes not done by the router and found by event notification.

MAIL.Messages.Read.Search.New

Number of messages discovered by searching.

MAIL.Messages.Read.Search.IntUpdate

Number of message updates found by search and done by the router to reflect completed recipients.

MAIL.Messages.Read.Search.ExtUpdate

Number of updates or deletes of messages in mailboxes not done by the router and found by search.

The following table lists and describes mail event statistics.

Table 3. Mail event statistics

Statistic

Description

Mail.Queue.Event.Processed = 1

Number of mail events (i.e. note update, delete) processed

Mail.Queue.Event.ProcessTime.Average = 60

Average process time (from dequeue to delete)

Mail.Queue.Event.ProcessTime.MostRecent = 60

Most recent process time

Mail.Queue.Event.ProcessTime.Peak = 60

Peak process time

Mail.Queue.Event.ProcessTime.Peak.Time =

Time of the peek process time

Mail.Queue.Event.Total = 1

Total events created (only displayed if Debug_Router_Extra_Queue_Statistics notes.ini is non-zero)

Mail.Queue.Event.Waiting = 0

Number of events waiting in queue

Mail.Queue.Event.Waiting.Peak = 1

Peak number of events waiting in queue

Mail.Queue.Event.Waiting.Peak.Time =

Time of peak

Mail.Queue.Event.WaitTime.Average = 60

Average wait time (from creation to dequeue)

Mail.Queue.Event.WaitTime.MostRecent = 60

Most recent wait time

Mail.Queue.Event.WaitTime.Peak = 60

Peak wait time

Mail.Queue.Event.WaitTime.Peak.Time =

Time of peak wait time

In the following table, all time units are in milliseconds.

Table 4. Other mail statistics

Statistic

Description

Mail.MessagesReenumerated

Number of messages re-enumerated since router startup

Mail.Queue.Dispatch.Processed

Number of dispatch requests that have been completely processed by the router

Mail.Queue.Dispatch.ProcessTime.Average

The time to process a dispatch request once removed from the queue

Mail.Queue.Dispatch.ProcessTime.Current

The time to complete processing of the most recent dispatch request

Mail.Queue.Dispatch.ProcessTime.Peak

The longest time to process a dispatch request after removal from the queue

Mail.Queue.Dispatch.Total

Number of dispatch requests created by the router since starting

Note: This includes both Processed and Waiting requests.

Mail.Queue.Dispatch.Waiting

Number of dispatch requests currently in the queue waiting to be processed

Note: An increasing number generated over a period of time indicates a backup in dispatching messages on the server.

Mail.Queue.Dispatch.Waiting.Peak

Maximum number of dispatch requests waiting in the queue to be processed since the router was started

Note: An increasing number generated over a period of time indicates a backup in dispatching messages on the server.

Mail.Queue.Dispatch.WaitTime.Average

The average time that router requests have waited in the queue since the router was started

Mail.Queue.Dispatch.WaitTime.Current

The time that the most-recently processed dispatch request spent in the queue waiting to be processed

Mail.Queue.Dispatch.WaitTime.Peak

The longest time a dispatch request waited in the queue