Chapter 18 Metrics Reference
This chapter describes the metric information that a Message QueueTM message broker can provide for monitoring, tuning, and diagnostic purposes. This information can be made available in a variety of ways:
-
In a log file (see Sending Metrics Data to Log Files)
-
Via the Command utility’s metrics bkr command (see Broker Management)
-
In metrics messages sent to a metrics topic destination (see Writing an Application to Monitor Brokers)
The tables in this chapter list the kinds of metric information available and the forms in which it can be provided. For metrics provided through the Command utility’s metrics bkr command, the tables list the metric type with which they can be requested; for those provided in metrics messages, the tables list the metrics topic destination to which they are delivered. The chapter consists of the following sections:
JVM Metrics
Table 18–1 shows the metric information that the broker reports for the broker process JVM (Java Virtual Machine) heap.
Table 18–1 JVM Metrics|
Metric Quantity |
Description |
Log File? |
metrics bkrMetricType |
Metrics Topic |
|---|---|---|---|---|
|
JVM heap: total memory |
Current total memory, in bytes |
Yes |
cxn |
mq.metrics.jvm |
|
JVM heap: free memory |
Amount of memory currently available for use, in bytes |
Yes |
cxn |
mq.metrics.jvm |
|
JVM heap: max memory |
Maximum allowable heap size, in bytes |
Yes |
None |
mq.metrics.jvm |
Brokerwide Metrics
Table 18–2 shows the brokerwide metric information that the broker reports.
Table 18–2 Brokerwide Metrics|
Metric Quantity |
Description |
Log File? |
metrics bkrMetricType |
Metrics Topic |
|---|---|---|---|---|
|
Connections |
||||
|
Num connections |
Total current number of connections for all connection services |
Yes |
cxn |
mq.metrics.broker |
|
Num threads |
Total current number of threads for all connection services |
Yes |
cxn |
None |
|
Min threads |
Total minimum number of threads for all connection services |
Yes |
cxn |
None |
|
Max threads |
Total maximum number of threads for all connection services |
Yes |
cxn |
None |
|
Stored Messages |
||||
|
Num messages |
Current number of payload messages stored in memory and persistent store |
No |
mq.metrics.broker |
|
|
Total message bytes |
Total size in bytes of payload messages currently stored in memory and persistent store |
No |
None |
mq.metrics.broker |
|
Message Flow |
||||
|
Num messages in |
Cumulative number of payload messages received since broker started |
Yes |
ttl |
mq.metrics.broker |
|
Num messages out |
Cumulative number of payload messages sent since broker started |
Yes |
ttl |
mq.metrics.broker |
|
Rate messages in |
Current rate of flow of payload messages into broker |
Yes |
rts |
None |
|
Rate messages out |
Current rate of flow of payload messages out of broker |
Yes |
rts |
None |
|
Message bytes in |
Cumulative size in bytes of payload messages received since broker started |
Yes |
ttl |
mq.metrics.broker |
|
Message bytes out |
Cumulative size in bytes of payload messages sent since broker started |
Yes |
ttl |
mq.metrics.broker |
|
Rate message bytes in |
Current rate of flow of payload message bytes into broker |
Yes |
rts |
None |
|
Rate message bytes out |
Current rate of flow of payload message bytes out of broker |
Yes |
rts |
None |
|
Num packets in |
Cumulative number of payload and control packets received since broker started |
Yes |
ttl |
mq.metrics.broker |
|
Num packets out |
Cumulative number of payload and control packets sent since broker started |
Yes |
ttl |
mq.metrics.broker |
|
Rate packets in |
Current rate of flow of payload and control packets into broker |
Yes |
rts |
None |
|
Rate packets out |
Current rate of flow of payload and control packets out of broker |
Yes |
rts |
None |
|
Packet bytes in |
Cumulative size in bytes of payload and control packets received since broker started |
Yes |
ttl |
mq.metrics.broker |
|
Packet bytes out |
Cumulative size in bytes of payload and control packets sent since broker started |
Yes |
ttl |
mq.metrics.broker |
|
Rate packet bytes in |
Current rate of flow of payload and control packet bytes into broker |
Yes |
rts |
None |
|
Rate packet bytes out |
Current rate of flow of payload and control packet bytes out of broker |
Yes |
rts |
None |
|
Destinations |
||||
|
Num destinations |
Current number of physical destinations |
No |
None |
mq.metrics.broker |
Connection Service Metrics
Table 18–3 shows the metric information that the broker reports for individual connection services.
Table 18–3 Connection Service Metrics|
Metric Quantity |
Description |
Log File? |
metrics svcMetricType |
Metrics Topic |
|---|---|---|---|---|
|
Connections |
||||
|
Num connections |
Current number of connections |
No |
None |
|
|
Num threads |
Current number of threads |
No |
cxn |
None |
|
Min threads |
Minimum number of threads assigned to service |
No |
cxn |
None |
|
Max threads |
Maximum number of threads assigned to service |
No |
cxn |
None |
|
Message Flow |
||||
|
Num messages in |
Cumulative number of payload messages received through connection service since broker started |
No |
ttl |
None |
|
Num messages out |
Cumulative number of payload messages sent through connection service since broker started |
No |
ttl |
None |
|
Rate messages in |
Current rate of flow of payload messages into broker through connection service |
No |
rts |
None |
|
Rate messages out |
Current rate of flow of payload messages out of broker through connection service |
No |
rts |
None |
|
Message bytes in |
Cumulative size in bytes of payload messages received through connection service since broker started |
No |
ttl |
None |
|
Message bytes out |
Cumulative size in bytes of payload messages sent through connection service since broker started |
No |
ttl |
None |
|
Rate message bytes in |
Current rate of flow of payload message bytes into broker through connection service |
No |
rts |
None |
|
Rate message bytes out |
Current rate of flow of payload message bytes out of broker through connection service |
No |
rts |
None |
|
Num packets in |
Cumulative number of payload and control packets received through connection service since broker started |
No |
ttl |
None |
|
Num packets out |
Cumulative number of payload and control packets sent through connection service since broker started |
No |
ttl |
None |
|
Rate packets in |
Current rate of flow of payload and control packets into broker through connection service |
No |
rts |
None |
|
Rate packets out |
Current rate of flow of payload and control packets out of broker through connection service |
No |
rts |
None |
|
Packet bytes in |
Cumulative size in bytes of payload and control packets received through connection service since broker started |
No |
ttl |
None |
|
Packet bytes out |
Cumulative size in bytes of payload and control packets sent through connection service since broker started |
No |
ttl |
None |
|
Rate packet bytes in |
Current rate of flow of payload and control packet bytes into broker through connection service |
No |
rts |
None |
|
Rate packet bytes out |
Current rate of flow of payload and control packet bytes out of broker through connection service |
No |
rts |
None |
Destination Metrics
Table 18–4 shows the metric information that the broker reports for individual destinations.
Table 18–4 Destination Metrics|
Metric Quantity |
Description |
Log File? |
metrics dstMetricType |
Metrics Topic |
|---|---|---|---|---|
|
Message Consumers |
||||
|
Num consumers |
Current number of associated message consumers For queue destinations, this attribute includes both active and backup consumers. For topic destinations, it includes both nondurable and (active and inactive) durable subscribers and is equivalent to “Num active consumers.” |
No |
con |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Peak num consumers |
Peak number of associated message consumers since broker started For queue destinations, this attribute includes both active and backup consumers. For topic destinations, it includes both nondurable and (active and inactive) durable subscribers and is equivalent to “Peak num active consumers.” |
No |
con |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Avg num consumers |
Average number of associated message consumers since broker started For queue destinations, this attribute includes both active and backup consumers. For topic destinations, it includes both nondurable and (active and inactive) durable subscribers and is equivalent to “Avg num active consumers.” |
No |
con |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Num active consumers |
Current number of associated active message consumers For topic destinations, this attribute includes both nondurable and (active and inactive) durable subscribers and is equivalent to “Num consumers.” |
No |
con |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Peak num active consumers |
Peak number of associated active message consumers since broker started For topic destinations, this attribute includes both nondurable and (active and inactive) durable subscribers and is equivalent to “Peak num consumers.” |
No |
con |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Avg num active consumers |
Average number of associated active message consumers since broker started For topic destinations, this attribute includes both nondurable and (active and inactive) durable subscribers and is equivalent to “Avg num consumers.” |
No |
con |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Current number of associated backup message consumers |
No |
con |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
|
Peak num backup consumers |
Peak number of associated backup message consumers since broker started |
No |
con |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Avg num backup consumers |
Average number of associated backup message consumers since broker started |
No |
con |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Stored Messages |
||||
|
Num messages |
Current number of messages stored in memory and persistent store |
No |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
|
Peak num messages |
Peak number of messages stored in memory and persistent store since broker started |
No |
conttlrts |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Avg num messages |
Average number of messages stored in memory and persistent store since broker started |
No |
conttlrts |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Total message bytes |
Current total size in bytes of messages stored in memory and persistent store |
No |
ttlrts |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Peak total message bytes |
Peak total size in bytes of messages stored in memory and persistent store since broker started |
No |
ttlrts |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Avg total message bytes |
Average total size in bytes of messages stored in memory and persistent store since broker started |
No |
ttlrts |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Message Flow |
||||
|
Num messages in |
Cumulative number of messages received since broker started |
No |
ttl |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Num messages out |
Cumulative number of messages sent since broker started |
No |
ttl |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Msg bytes in |
Cumulative size in bytes of messages received since broker started |
No |
ttl |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Msg bytes out |
Cumulative size in bytes of messages sent since broker started |
No |
ttl |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Peak message bytes |
Size in bytes of largest single message received since broker started |
No |
ttlrts |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Rate num messages in |
Current rate of flow of messages received |
No |
rts |
None |
|
Rate num messages out |
Current rate of flow of messages sent |
No |
rts |
None |
|
Rate msg bytes in |
Current rate of flow of message bytes received |
No |
rts |
None |
|
Rate msg bytes out |
Current rate of flow of message bytes sent |
No |
rts |
None |
|
Disk Utilization |
||||
|
Amount of disk space, in bytes, reserved for destination |
No |
dsk |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
|
Disk used |
Amount of disk space, in bytes, currently in use by destination |
No |
dsk |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
|
Disk utilization ratio |
Ratio of disk space in use to disk space reserved for destination |
No |
dsk |
mq.metrics.destination.queue.queueNamemq.metrics.destination.topic.topicName |
- © 2010, Oracle Corporation and/or its affiliates