Qpid Management - pcolby/pcp-pmda-qpid GitHub Wiki
Qpid Options
Qpid brokers include a number of options for configuring how they broadcast management data (including metrics) to applications like Qpid PMDA.
qpidd --help | grep mgmt -A1
-m [ --mgmt-enable ] yes|no (1) Enable Management
--mgmt-publish yes|no (1) Enable Publish of Management Data ('no'
implies query-only)
--mgmt-qmf2 yes|no (1) Enable broadcast of management
information over QMF v2
--mgmt-qmf1 yes|no (1) Enable broadcast of management
information over QMF v1
--mgmt-pub-interval SECONDS (10) Management Publish Interval
Publish Interval
Most of the options required to make Qpid PMDA work are on by default. But you might want to adjust the mgmt-pub-interval
option.
By default, mgmt-pub-interval
is set to 10
seconds. This means that QMF clients, like Qpid PMDA, will receive metrics updates approximately once every 10 seconds. Consequently, if you run PCP's pmval
command with a default time interval of 1 second, on counter metrics, pmcd
will show spikes in throughput around about every 10 seconds, with zero throughput in between, like this:
pmval -i test_queue qpid.queue.msgTotalEnqueues
metric: qpid.queue.msgTotalEnqueues
host: localhost
semantics: cumulative counter (converting to rate)
units: count (converting to count / sec)
samples: all
test_queue
123.4
0.0
0.0
0.0
0.0
0.0
0.0
0.0
0.0
0.0
567.8
0.0
0.0
0.0
So it makes sense to either:
- Run
pmcd
(orpmlogger
, etc) with the-t
option set to at least 10 seconds, such as:pmval -i test_queue qpid.queue.msgTotalEnqueues -t 10
; and/or - Reduce the broker's
mgmt-pub-interval
option to something lower, such as1
. Of course you are responsible for ensuring that this setting does not adversely affect your particular Qpid installation.