Qpid Queues Test

Queues are named entities within a virtual host that hold/buffer messages for later delivery to consumer applications. Messages arrive on queues either from Exchanges, or when using the AMQP protocol, the producing application can direct messages straight to the queue. Consumers subscribe to a queue in order to receive messages from it. The Broker supports different queue types, each with different delivery semantics. Queues also have a range of other features such as the ability to group messages together for delivery to a single consumer. This test helps the administrators to monitor the status of the queue, total number of messages available in the queue, and the type of messages - eg., unacknowledged, expired, malformed - in each queue, so administrators can precisely pinpoint queues that are growing in length at an alarming rate, know what type of messages are in such queue, and accordingly decide on how to control the growth in queue length.

Target of the test : Apache Qpid Java Broker

Agent deploying the test : An internal/remote agent

Outputs of the test : One set of results for each Queue in the target Apache Qpid Java Broker.

Configurable parameters for the test
Parameter	Description
Test period	How often should the test be executed.
Host	The IP address of the target server that is being monitored.
Port	The port number through which the Apache Qpid Java Broker communicates. The default port is 8080.
Username	By default, the eG agent executes REST APIs on the target component to collect the required metrics. For the eG agent to execute the REST APIs, a user with monitoring privilege is required. Specify the name of such a user in this text box.
Password	Specify the password corresponding to the user mentioned in the Username text box here.
Confirm Password	Confirm the password by retyping it here.
SSL	By default, the SSL flag is set to No, indicating that the target Apache Qpid Java Broker is not SSL-enabled by default. To enable the test to connect to an SSL-enabled Apache Qpid Java Broker, set the SSL flag to Yes.
Timeout	Specify the duration (in seconds) within which the query executed by this test should time out in this text box.

Measurements made by the test

Measurement

Description

Measurement Unit

Interpretation

State

Indicates the current state of this queue.

The values reported by this measure and its numeric equivalents are mentioned in the table below:

Measure Value	Numeric Value
Stopped	0
Quiesced	50
Uninitialized	60
Unavailable	70
Errored	80
Deleted	90
Active	100

Note:

By default, this measure reports the Measure Values listed in the table above to indicate the current state of this queue.

Available data

Indicates the current size of the available messages in this queue.

Available data high watermark

Indicates the maximum size of the available messages in this queue.

Available messages

Indicates the current number of available messages in this queue.

Messages

Available messages high watermark

Indicates the maximum number of available messages in this queue.

Messages

Bindings

Indicates the total number of bindings in this queue.

Counts

A very high value is desired for this measure since bindings are rules that exchanges use to route messages to queues.

Consumers

Indicates the current number of consumers attached to this queue.

Counts

A very low value is desired for this measure. When multiple consumers access a queue, the load-balancing among them takes into account each consumer's capacity and message processing rate.

Consumers with credit

Indicates the maximum number of consumers attached to this queue.

Counts

Oldest message age

Indicates the age of oldest messages that exist in this queue.

Milliseconds

Persistent dequeued data

Indicates the size of the persistent messages that were dequeued.

A very high value is desired for these measures.

Persistent dequeued messages

Indicates the number of persistent messages that were dequeued.

Messages

Persistent enqueued data

Indicates the size of the persistent messages that were enqueued.

Persistent enqueued messages

Indicates the number of persistent messages that were enqueued.

Messages

Queue depth data

Indicates the current size of messages waiting in the queue.

A very low value is desired for these measures.

Queue depth data high watermark

Indicates the maximum size of messages waiting in the queue.

Queue depth messages

Indicates the current number of messages waiting in the queue.

Messages

Queue depth messages high watermark

Indicates the maximum number of the messages waiting in the queue.

Messages

Total dequeued data

Indicates the total size of the messages that were dequeued.

Total dequeued messages

Indicates the total number of messages that were dequeued.

Messages

Total enqueued data

Indicates the total size of messages that were enqueued.

Total enqueued messages

Indicates the total number of enqueued messages in this queue.

Messages

Total expired data

Indicates the total size of the messages expired in this queue.

A very low value is desired for these measures.

Total expired messages

Indicates the total number of messages expired in this queue.

Messages

Total malformed data

Indicates the total size of the messages that were distorted in this queue.

Total malformed messages

Indicates the total number of messages that were distorted in this queue.

Messages

Unacknowledged data

Indicates the total size of the unacknowledged messages in this queue.

Unacknowledged messages

Indicates the total number of unacknowledged messages in this queue.

Messages