JBoss Servlet Test

This test monitors the servlets deployed on the WildFly JBoss server and reports the following:

  • The number of incoming requests to each servlet;

  • The time taken to load each servlet;

  • The time taken by each servlet to to process the requests and the rate at which the requests are processed

This way, the administrators can identify the servlet that is handling the maximum number of requests.

Target of the test : A WildFly JBoss server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each servlet of the WildFly JBoss server that is to be 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 at which the specified HOST listens. By default, this is 9990.

SSL

If the WildFly JBoss server being monitored is an SSL-enabled server, then set the SSL flag to Yes. If not, then set the SSL flag to No.

Is JBoss Running In Domain Mode?

Specify whether the server to be monitored is currently running in Domain Mode or not. By default, this flag is set to No which implies that the server is currently running in Standalone Mode. If you have started the target JBoss server using the default web profile configuration in domain mode i.e, if you have executed the ./domain.sh command from the <JBoss_INSTALL_DIR>/bin directory, then specify Yes against this flag.

JBoss Host Name

Specify whether the target server to be monitored is a master or a slave in a JBoss cluster. By default, none will be specified here which implies that the target JBoss server is a standalone server. Refer to Identifying the host name and server instance name of the WildFly JBoss server running in Domain mode to know how to identify whether the target server is a master or slave in your environment.

JBoss Server Instance Name

Specify the name of the server instance that is to be monitored. By default, none will be specified here. Refer to Identifying the host name and server instance name of the WildFly JBoss server running in Domain mode to identify the name of the server instance that is to be monitored. 

Management User and Management Password

Specify the credentials of the user who is authorized to access the management console of the target JBoss server. To create a new user, refer to Creating a new management user in the WildFly JBoss server of this document.

Confirm Password

Confirm the Management Password by retyping it here.

Measures made by the test:

Measurement

Description

Measurement Unit

Interpretation

Request count

Indicates the number of incoming requests that were handled by this servlet.

Number

This value is a good indicator on the load of the servlet.

Load time

Indicates the total time taken to load this servlet.

Secs

A low value is desired for this measure.

Processing time

Indicates the time taken to process the incoming requests to this servlet during the last measurement period.

Secs

If the value taken to process the requests is higher, then it may be due to a request taking too long to be processed, a connection issue where the servlet failed to load, etc.

Request processing rate

Indicates the rate at which the requests were processed by this servlet during the last measurement period.

Number/Sec

A high value is desired for this measure.