summary

March 26, 2020 Contributors

Name

summary — show global metrics

Synopsis

summary [ with-mobile ]

Description

Perhaps the most common and useful command for the console, summary will produce global metrics such as queue sizes, message counts and throughput rates since startup or the last reset of statistics.

10:47:35 /tmp/2025> summary
Summary Statistics
        Outbound Concurrency:    2248
        Inbound Concurrency:      90
        Active Domains:   35711
        Active Queue Size:   8793
        Delayed Queue Size: 263175
        Destaged Queue Size:      0
        Total Queue Size: 272334
        DNS A Queries: 565284
        DNS MX Queries: 243281
        Pending DNS Queries: 116
        Query Rate:   9.08 queries/second
        Successfully Delivered Messages: 2102439
        Failed Messages: 2508439
        Rejected Messages:      1
        Received Messages: 4883262
        Delivery Rate:  51.76 messages/second
        Reception Rate:  54.82 messages/second
        Statistics Last Reset:  89081 seconds
        Uptime:  89083 seconds

If you have configured your control listener to listen on the default Unix socket, you can invoke the summary command without opening the system console by issuing the command, ec_console /tmp/2025 summary .

The report fields are as follows:

Outbound Concurrency

The current number of established outbound sessions.

Inbound Concurrency

The current number of established inbound sessions.

Active Domains

The number of domains in the DNS cache.

Active Queue Size

The number of messages in the system that require immediate delivery attempts.

Delayed Queue Size

The number of messages in the system that have been delayed. A message is delayed due to transient delivery failures (4xx SMTP codes) and a retry time is calculated for the message. When that retry time is reached, the message will be moved from the delayed queue to the active queue.

Destaged Queue Size

The number of messages that have been destaged from the system.

Total Queue Size

The sum of all queues.

DNS A Queries

The total number of A/AAAA type queries issued since startup or last summary reset.

DNS MX Queries

The total number of MX type DNS queries issued since startup or last summary reset.

Pending DNS Queries

The total number of DNS queries that are not completed yet.

Query Rate

The average number of DNS queries/second performed since startup or last summary reset.

Successfully Delivered Messages

The number of messages successfully delivered by Momentum since it was started or since the last summary reset.

Failed Messages

The number of outbound messages permanently failed since it was started or since the last summary reset.

Rejected Messages

The number of messages rejected by Momentum since it was started or since the last summary reset.

Received Messages

The number of messages received by Momentum for deliver since it was started or since the last summary reset.

Delivery Rate

The average number of messages/second delivered (successful and unsuccessful) since Momentum was started or since the last summary reset.

Reception Rate

The average number of messages/second received for delivery since Momentum was started or since the last summary reset.

Statistics Last Reset

The number of seconds since statistics were reset using the "summary reset" command (see below).

Uptime

The number of seconds that Momentum has been running continuously.

Use the with-mobile option to display the status of SMPP and MM7 message queues.

See Also

binding summary, summary reset