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.