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
  1. TEST PERIOD - How often should the test be executed
  2. Host – The host for which the test is to be configured
  3. port– The port at which the specified HOSTlistens. By default, this is 9990.
  4. SSLIf the WildFly JBoss server being monitored is an SSL-enabled server, then set the sslflag to Yes. If not, then set the sslflag to No.
  5. 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.
  6. 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.
  7. 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. 
  8. 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.
  9. 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.