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:

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 metricsbkr 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:

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?

metricsdstMetricType

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

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

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