WebSphere Liberty Connection Pools Test

This test auto-discovers the connection pools on the target IBM WebSphere Liberty server and for each connection pool, this test reports the rate at which connections were created. This test also reports the rate at which connections were destroyed and the average time taken for a connection to be granted from each connection pool. Using this test, administrators can figure out the connection pool that is busy and the connection pool on which maximum number of requests were created.

Target of the test : An IBM WebSphere Liberty

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every connection pool 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

Connection create rate

Indicates the rate at which connections were created in this connection pool.

Connections/sec

This measure is a good indicator of load on each connection pool.

Compare the value of this measure across connection pools to figure out the connection pool on which maximum number of connections were created.

Connection destroy rate

Indicates the rate at which connections were destroyed in this connection pool.

Connections/sec

 

Managed connection count

Indicates the number of managed connection objects that were in use in this connection pool.

Number

 

Average wait time

Indicates the average waiting time until a connection from this connection pool was granted.

Milliseconds

A low value is desired for this measure.

Compare the value of this measure across the connection pools to figure out the connection pool that takes too long to grant a connection i.e., in other words you can figure out the connection pool that is too busy to grant a connection.

Connection handled count

Indicates the number of connection objects that were handled by this connection pool.

Number

 

Free connection count

Indicates the number of connections that were available for use in this connection pool.

Number

A high value is desired for this measure.

A sudden/gradual decrease in the value of this measure indicates that the connection pool is busy. If too many connection requests are received continuously to this connection pool, then administrators may try increasing the number of connections in the connection pool.