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 Total Queue Size: 272334 DNS Resolver: ares DNS A Queries: 565284 DNS A Timeouts: 11 DNS AAAA Queries: 0 DNS AAAA Timeouts: 0 DNS MX Queries: 243281 DNS MX Timeouts: 6 DNS TXT Queries: 39841 DNS TXT Timeouts: 0 Pending DNS Queries: 116 Query Rate: 9.08 queries/second DNS Response Time Peak: 469 ms DNS Response Time Average: 0.302 ms 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.
- Total Queue Size
-
The sum of all queues.
- DNS Resolver
-
The library used to resolve DNS queries.
- DNS A Queries
-
The total number of A type queries issued since startup or last summary reset.
- DNS A Timeouts
-
Introduced in Momentum 4.8.
The total number of A type queries that resulted expired since startup or last summary reset.
- DNS AAAA Queries
-
The total number of AAAA type queries issued since startup or last summary reset.
- DNS AAAA Timeouts
-
Introduced in Momentum 4.8.
The total number of AAAA type queries that resulted expired since startup or last summary reset.
- DNS MX Queries
-
The total number of MX type queries issued since startup or last summary reset.
- DNS MX Timeouts
-
Introduced in Momentum 4.8.
The total number of MX type queries that resulted expired since startup or last summary reset.
- DNS TXT Queries
-
Introduced in Momentum 4.8.
The total number of TXT type queries issued since startup or last summary reset.
- DNS TXT Timeouts
-
Introduced in Momentum 4.8.
The total number of TXT type queries that resulted expired 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.
- DNS Response Time Peak
-
Introduced in Momentum 4.8.
The peak of all answers response times since startup or last summary reset, in milliseconds.
- DNS Response Time Average
-
Introduced in Momentum 4.8.
The average of all answers response times since startup or last summary reset, in milliseconds.
- 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
Attention
On a busy system, if this command is run frequently, it may result in a Momentum watchdog restart. If summary data is needed multiple times per hour then it is recommended to use the summary HTTP endpoint instead.