WebSphere Liberty Queues Test

This test auto-discovers the queues on the target IBM WebSphere Liberty server and reports the current state and maximum configured size of each queue. This test also helps the administrators to figure out whether get operations are allowed on each queue and the number of outstanding I/O requests in each queue. Using this test, administrators can figure out the queue that is latent and is unable to process requests at a faster pace!

Target of the test : An IBM WebSphere Liberty

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each queue on the target IBM WebSphere Liberty server being monitored.

Configurable parameters for the test
Parameters Description

Test Period

How often should the test be executed.

Host

The host for which the test is to be configured.

Port

The port number at which the specified host listens.

Service URL Path

For the eG agent to collect metrics from the target IBM WebSphere Liberty server, the local connector should be enabled on the target server. Once the connector is enabled, a com.ibm.ws.jmx.local.address file will be created in the ${server.output.dir}/logs/state folder. The eG agent uses this file to connect to the target server and collect the required metrics from it. Therefore, specify the exact path to this file in the Service URL text box. For example, in case of Windows environments, the Service URL Path can be C:\wlp\usr\servers\server1\logs\state and in case of Linux environments, the Service URL Path can be /opt/wlp/ur/servers/server1/logs/state.

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
Active 0
Inactive 1

Note:

By default, this measure reports the Measure Values listed in the table above to indicate the current state of this queue. The graph of this measure however, represents the status of a server using the numeric equivalents only - 0 or 1.

Send allowed

Indicates whether/not get operations were allowed in this queue.

 

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

Measure value Numeric Value
True 0
False 1

Note:

By default, this measure reports the Measure Values listed in the table above to indicate whether/not get operations were allowed in this queue. The graph of this measure however, represents the status of a server using the numeric equivalents only - 0 or 1.

Depth

Indicates the number of outstanding read/write(I/O) requests in this queue.

Number

If the value of this measure keeps increasing steadily and significantly for each queue, it could indicate that the queue is latent, and is unable to process I/O requests quickly.

The value of this measure therefore should be low at all times.

Maximum queue size

Indicates the maximum configured size of this queue.

Number