Chapter 18 Metrics Reference

Chapter 18
Metrics Reference

This chapter lists and describes metrics produced by the Message Queue product. This chapter contains the following sections:

JVM Metrics

Brokerwide Metrics

Connection Service Metrics

Destination Metrics

JVM Metrics

Table 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)1
JVM 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 Metrics

Table 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)1
Connection 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 bkr	No	Yes (…broker)
Total message bytes	Number of payload messages bytes currently stored in broker memory and persistent store	No Use query bkr	No	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 Metrics

Table 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.

Table 18-3 Connection Service Metrics
Metric Quantity	Description	imqcmd metrics svc (metricType)	Log File	Metrics Message (metrics topic)
Connection Data
Num connections	Number of currently open connections	Yes (cxn) Also query svc	No	No
Num threads	Number of threads currently in use	Yes (cxn) Also query svc	No	No
Min threads	Number of threads, which once reached, are maintained in the thread pool for use by connection services, totaled across all connection services	Yes (cxn)	No	No
Max threads	Number of threads, beyond which no new threads are added to the thread pool for use by connection services, totaled across all connection services	Yes (cxn)	No	No
Message Flow Data
Num messages in	Number of payload messages that have flowed into the connection service since the broker was last started	Yes (ttl)	No	No
Message bytes in	Number of payload message bytes that have flowed into the connection service since the broker was last started	Yes (ttl)	No	No
Num packets in	Number of packets that have flowed into the connection service since the broker was last started; includes both payload messages and control messages	Yes (ttl)	No	No
Packet bytes in	Number packet bytes that have flowed into the connection service since the broker was last started; includes both payload messages and control messages	Yes (ttl)	No	No
Num messages out	Number of payload messages that have flowed out of the connection service since the broker was last started	Yes (ttl)	No	No
Message bytes out	Number of payload message bytes that have flowed out of the connection service since the broker was last started	Yes (ttl)	No	No
Num packets out	Number of packets that have flowed out of the connection service since the broker was last started; includes both payload messages and control messages	Yes (ttl)	No	No
Packet bytes out	Number packet bytes that have flowed out of the connection service since the broker was last started; includes both payload messages and control messages	Yes (ttl)	No	No
Rate messages in	Current rate of flow of payload messages into the broker through the connection service	Yes (rts)	No	No
Rate message bytes in	Current rate of flow of payload message bytes into the connection service	Yes (rts)	No	No
Rate packets in	Current rate of flow of packets into the connection service; includes both payload messages and control messages	Yes (rts)	No	No
Rate packet bytes in	Current rate of flow of packet bytes into the connection service; includes both payload messages and control messages	Yes (rts)	No	No
Rate messages out	Current rate of flow of payload messages out of the connection service	Yes (rts)	No	No
Rate message bytes out	Current rate of flow of payload message bytes out of the connection service	Yes (rts)	No	No
Rate packets out	Current rate of flow of packets out of the connection service; includes both payload messages and control messages	Yes (rts)	No	No
Rate packet bytes out	Current rate of flow of packet bytes out of the connection service; includes both payload messages and control messages	Yes (rts)	No	No

Destination Metrics

Table 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)1
Consumer 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 dst	No	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 dst	No	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.

Previous Contents Index Next

Previous Contents Index Next
Sun Java System Message Queue 3 2005Q4 Administration Guide