org.apache.qpid.qmf2.tools

Class QpidQueueStats

java.lang.Object

org.apache.qpid.qmf2.tools.QpidQueueStats

All Implemented Interfaces:

QmfCallback, QmfEventListener

public final class QpidQueueStats
extends Object
implements QmfEventListener

Collect and print queue statistics.

 Usage: QpidQueueStats [options]
 
 Options:
   -h, --help            show this help message and exit
   -a <address>, --broker-address=<address>
                         broker-addr is in the form:  [username/password@]
                         hostname | ip-address [:<port>]   ex:  localhost,
                         10.1.1.7:10000, broker-host:10000,
                         guest/guest@localhost
   -f <filter>, --filter=<filter>
                         a list of comma separated queue names (regex are
                         accepted) to show
   --sasl-mechanism=<mech>
                         SASL mechanism for authentication (e.g. EXTERNAL,
                         ANONYMOUS, PLAIN, CRAM-MD5, DIGEST-MD5, GSSAPI). SASL
                         automatically picks the most secure available
                         mechanism - use this option to override.
 

Author:

Fraser Adams

Constructor Summary

Constructors

Constructor and Description
QpidQueueStats(String url, String connectionOptions, List<Pattern> filter) Basic constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static void	main(String[] args) Runs QpidQueueStats.
void	onEvent(WorkItem wi) Main Event handler.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

QpidQueueStats

public QpidQueueStats(String url,
              String connectionOptions,
              List<Pattern> filter)

Basic constructor. Creates JMS Session, Initialises Destinations, Producers & Consumers and starts connection.

Parameters:

url - the connection URL.

connectionOptions - the options String to pass to ConnectionHelper.

filter - a list of regex Patterns used to choose the queues we wish to display.

Method Detail

onEvent

public void onEvent(WorkItem wi)

Main Event handler. Checks if the WorkItem is a SubscriptionIndicationWorkItem, if it is it stores the object in a Map and uses this to maintain state so we can record deltas such as enqueue and dequeue rates.

The AgentHeartbeatWorkItem is used to periodically compare the elapsed time against the Subscription duration so that we can refresh the Subscription (or create a new one if necessary) in order to continue receiving queue Management Object data from the broker.

When the AgentRestartedWorkItem is received we clear the state to remove any stale queue Management Objects.

Specified by:

onEvent in interface QmfEventListener

Parameters:

wi - a QMF2 WorkItem object

main

public static void main(String[] args)

Runs QpidQueueStats.

Parameters:

args - the command line arguments.