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:

  1. Run pmcd (or pmlogger, etc) with the -t option set to at least 10 seconds, such as: pmval -i test_queue qpid.queue.msgTotalEnqueues -t 10; and/or
  2. Reduce the broker's mgmt-pub-interval option to something lower, such as 1. Of course you are responsible for ensuring that this setting does not adversely affect your particular Qpid installation.