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 whether/not the current state of the Queue is active, ensuring that the size of the messages waiting in the queue and the number of unacknowledged messages is negligible.

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

It indicates the current size of the available messages in this queue.

MB

 

Available data high watermark

It indicates the maximum size of the available messages in this queue.

MB

 

Available messages

It indicates the current number of available messages in this queue.

Messages

 

Available messages high watermark

It indicates the maximum number of available messages in this queue.

Messages

 

Bindings

It 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

It 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

It indicates the maximum number of consumers attached to this queue.

Counts

Oldest message age

It indicates the age of oldest messages that exist in this queue.

Milliseconds

 

Persistent dequeued data

It indicates the size of the persistent messages that were dequeued.

MB

A very high value is desired for these measures.

 

 

 

Persistent dequeued messages

It indicates the number of persistent messages that were dequeued.

Messages

Persistent enqueued data

It indicates the size of the persistent messages that were enqueued.

MB

Persistent enqueued messages

It indicates the number of persistent messages that were enqueued.

Messages

Queue depth data

It indicates the current size of messages waiting in the queue.

MB

A very low value is desired for these measures.

 

 

 

Queue depth data high watermark

It indicates the maximum size of messages waiting in the queue.

MB

Queue depth messages

It indicates the current number of messages waiting in the queue.

Messages

Queue depth messages high watermark

It indicates the maximum number of the messages waiting in the queue.

Messages

Total dequeued data

It indicates the total size of the messages that were dequeued.

MB

 

Total dequeued messages

It indicates the total number of messages that were dequeued.

Messages

 

Total enqueued data

It indicates the total size of messages that were enqueued.

MB

 

Total enqueued messages

It indicates the total number of enqueued messages in this queue.

Messages

 

Total expired data

It indicates the total size of the messages expired in this queue.

MB

A very low value is desired for these measures.

 

 

 

 

 

Total expired messages

It indicates the total number of messages expired in this queue.

Messages

Total malformed data

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

MB

Total malformed messages

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

Messages

Unacknowledged data

It indicates the total size of the unacknowledged messages in this queue.

MB

Unacknowledged messages

It indicates the total number of unacknowledged messages in this queue.

Messages