Sun Java System Message Queue 3 2005Q4 Administration Guide |
Chapter 18
Metrics ReferenceThis chapter lists and describes metrics produced by the Message Queue product. This chapter contains the following sections:
JVM MetricsTable 18-1 lists and describes the metrics data that the broker generates for the broker process JVM heap. For each metric, the table shows which metrics monitoring tools provide it.
Table 18-1 JVM Metrics
Metric Quantity
Description
imqcmd metrics bkr
(metricType)Log File
Metrics Message
(metrics topic)1JVM heap: free memory
Amount of free memory available for use in the JVM heap
Yes
(cxn)Yes
Yes
(…jvm)JVM heap: total memory
Current JVM heap size
Yes
(cxn)Yes
Yes
(…jvm)JVM heap: max memory
Maximum to which the JVM heap size can grow.
No
Yes2
Yes
(…jvm)
1For metrics topic destination names, see Table 10-7.
2Shown only at broker startup.
Brokerwide MetricsTable 18-2 lists and describes the data the broker reports regarding brokerwide metrics information. It also shows which of the data can be obtained using the different metrics monitoring tools.
Table 18-2 Brokerwide Metrics
Metric Quantity
Description
imqcmd metrics bkr
(metricType)Log File
Metrics Message
(metrics topic)1Connection Data
Num connections
Number of currently open connections to the broker
Yes
(cxn)Yes
Yes
(…broker)Num threads
Total number of threads currently in use for all connection services
Yes
(cxn)Yes
No
Min threads
Number of threads, which once reached, are maintained in the thread pool for use by connection services
Yes
(cxn)Yes
No
Max threads
Number of threads, beyond which no new threads are added to the thread pool for use by connection services
Yes
(cxn)Yes
No
Stored Messages Data
Num messages
Number of payload messages currently stored in broker memory and persistent store
No
Use query bkrNo
Yes
(…broker)Total message bytes
Number of payload messages bytes currently stored in broker memory and persistent store
No
Use query bkrNo
Yes
(…broker)Message Flow Data
Num messages in
Number of payload messages that have flowed into the broker since it was last started
Yes
(ttl)Yes
Yes
(…broker)Message bytes in
Number of payload message bytes that have flowed into the broker since it was last started
Yes
(ttl)Yes
Yes
(…broker)Num packets in
Number of packets that have flowed into the broker since it was last started; includes both payload messages and control messages
Yes
(ttl)Yes
Yes
(…broker)Packet bytes in
Number of packet bytes that have flowed into the broker since it was last started; includes both payload messages and control messages
Yes
(ttl)Yes
Yes
(…broker)Num messages out
Number of payload messages that have flowed out of the broker since it was last started.
Yes
(ttl)Yes
Yes
(…broker)Message bytes out
Number of payload message bytes that have flowed out of the broker since it was last started
Yes
(ttl)Yes
Yes
(…broker)Num packets out
Number of packets that have flowed out of the broker since it was last started; includes both payload messages and control messages
Yes
(ttl)Yes
Yes
(…broker)Packet bytes out
Number of packet bytes that have flowed out of the broker since it was last started; includes both payload messages and control messages
Yes
(ttl)Yes
Yes
(…broker)Rate messages in
Current rate of flow of payload messages into the broker
Yes
(rts)Yes
No
Rate message bytes in
Current rate of flow of payload message bytes into the broker
Yes
(rts)Yes
No
Rate packets in
Current rate of flow of packets into the broker; includes both payload messages and control messages
Yes
(rts)Yes
No
Rate packet bytes in
Current rate of flow of packet bytes into the broker; includes both payload messages and control messages
Yes
(rts)Yes
No
Rate messages out
Current rate of flow of payload messages out of the broker
Yes
(rts)Yes
No
Rate message bytes out
Current rate of flow of payload message bytes out of the broker
Yes
(rts)Yes
No
Rate packets out
Current rate of flow of packets out of the broker; includes both payload messages and control messages
Yes
(rts)Yes
No
Rate packet bytes out
Current rate of flow of packet bytes out of the broker; includes both payload messages and control messages
Yes
(rts)Yes
No
Destinations Data
Num destinations
Number of physical destination in the broker
No
No
Yes
(…broker)
1For metrics topic destination names, see Table 10-7.
Connection Service MetricsTable 18-3 lists and describes the metrics data the broker reports for individual connection services. It also shows which of the data can be obtained using the different metrics monitoring tools.
Destination MetricsTable 18-4 lists and describes the metrics data the broker reports for individual destinations. It also shows which of the data can be obtained using the different metrics monitoring tools.
Table 18-4 Destination Metrics
Metric Quantity
Description
imqcmd metrics dst
(metricType)Log File
Metrics Message
(metrics topic)1Consumer Data
Num consumers
Current number of consumers
For a topic, this value includes non-durable subscriptions, active durable subscriptions, and inactive durable subscriptions. For a queue, this value includes active consumers and backup consumers.
Yes
(con)No
Yes
(…destName)Avg num consumers
Average number of consumers since the broker was last started
Yes
(con)No
Yes
(…destName)Peak num consumers
Peak number of consumers since the broker was last started
Yes
(con)No
Yes
(…destName)Num active consumers
Current number of active consumers
Yes
(con)No
Yes
(…destName)Avg num active consumers
Average number of active consumers since the broker was last started
Yes
(con)No
Yes
(…destName)Peak num active consumers
Peak number of active consumers since the broker was last started
Yes
(con)No
Yes
(…destName)Num backup consumers
Current number of backup consumers (applies only to queues)
Yes
(con)No
Yes
(…destName)Avg num backup consumers
Average number of backup consumers since the broker was last started (applies only to queues)
Yes
(con)No
Yes
(…destName)Peak num backup consumers
Peak number of backup consumers since the broker was last started (applies only to queues)
Yes
(con)No
Yes
(…destName)Stored Messages Data
Num messages
Number of payload messages currently stored in destination memory and persistent store
Yes
(con)
(ttl)
(rts)
Also query dstNo
Yes
(…destName)Avg num messages
Average number of payload messages stored in destination memory and persistent store since the broker was last started
Yes
(con)
(ttl)
(rts)No
Yes
(…destName)Peak num messages
Peak number of payload messages stored in destination memory and persistent store since the broker was last started
Yes
(con)
(ttl)
(rts)No
Yes
(…destName)Total message bytes
Number of payload message bytes currently stored in destination memory and persistent store
Yes
(ttl)
(rts)
Also query dstNo
Yes
(…destName)Avg total message bytes
Average number of payload message bytes stored in destination memory and persistent store since the broker was last started
Yes
(ttl)
(rts)No
Yes
(…destName)Peak total message bytes
Peak number of payload message bytes stored in destination memory and persistent store since the broker was last started
Yes
(ttl)
(rts)No
Yes
(…destName)Peak message bytes
Peak number of payload message bytes in a single message received by the destination since the broker was last started
Yes
(ttl)
(rts)No
Yes
(…destName)Message Flow Data
Num messages in
Number of payload messages that have flowed into this destination since the broker was last started
Yes
(ttl)No
Yes
(…destName)Msg bytes in
Number of payload message bytes that have flowed into this destination since the broker was last started
Yes
(ttl)No
Yes
(…destName)Num messages out
Number of payload messages that have flowed out of this destination since the broker was last started
Yes
(ttl)No
Yes
(…destName)Msg bytes out
Number of payload message bytes that have flowed out of this destination since the broker was last started
Yes
(ttl)No
Yes
(…destName)Rate num messages in
Current rate of flow of payload messages into the destination
Yes
(rts)No
No
Rate num messages out
Current rate of flow of payload messages out of the destinatio
Yes
(rts)No
No
Rate msg bytes in
Current rate of flow of payload message bytes into the destination
Yes
(rts)No
No
Rate Msg bytes out
Current rate of flow of payload message bytes out of the destination
Yes
(rts)No
No
Disk Utilization Data
Disk reserved
Disk space, in bytes, used by all message records (active and free) in the destination file-based store
Yes
(dsk)No
Yes
(…destName)Disk used
Disk space, in bytes, used by active message records in destination file-based store
Yes
(dsk)No
Yes
(…destName)Disk utilization ratio
Ratio of used disk space to reserved disk space. The higher the ratio, the more the disk space is being used to hold active messages
Yes
(dsk)No
Yes
(…destName)
1For metrics topic destination names, see Table 10-7.