JBoss EJBs Test

A bean is usually an application class that contains business logic. It may be called directly from Java code, or it may be invoked via the Unified EL i.e., Unified Expression language. A bean may access transactional resources. Dependencies between beans are managed automatically by the container. The lifecycle of a bean is always managed by the container. The beans are classified as follows:

stateless session beans
stateful session beans
message driven beans, and
entity beans

This test auto-discovers the EJBs deployed on the JBoss server and reports critical measures relating to each of the EJB in detail. Using this test, you can figure out the number of times each bean has been invoked and the instances of each bean that can be accommodated in the pool. This way, you could figure out the effective utilization of the pool and the bean in particular.

Target of the test : A JBoss AS/EAP server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each EJB of the target JBoss AS/EAP that is to be monitored.

Configurable parameters for the test
Parameter	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 JBoss AS/EAP server being monitored is an SSL-enabled server, then set the SSL flag to Yes. If not, then set the sslflag 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 JBoss EAP 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 JBoss EAP 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 consoleof the target JBoss server. To create a new user, refer to Creating a New User in the JBoss EAP Server.
Confirm Password	Confirm the Management Password by retyping it here.

Measures made by the test
Measurement	Description	Measurement Unit	Interpretation
Number of invocations	Indicates the number of times this bean has been invoked since the start of the server.	Number
Average execution time	Indicates the average time taken to execute the method of this bean during the last measurement period.	Secs	A higher value for this measure is a cause for concern.
Peak concurrent invocations	Indicates the maximum number of times the method of this bean has been invoked.	Number
Pool available count	Indicates the number of instances of this bean that is currently available for use in the pool.	Number	A high value is desired for this measure.
Pool creation count	Indicates the number of bean instances that were created in the pool.	Number
Pool remove count	Indicates the number of bean instances that were removed from the pool.	Number
Pool maximum size	Indicates the maximum number of instances of this bean that can be accommodated in the pool.	Number
Current pool size	Indicates the number of instances of this bean that are currently utilized in the pool.	Number	If the value of this measure is equal to the Pool maximum size measure, then you can increase the Pool maximum size measure to a more desirable value so that the bean instances are readily available for use.
Pool utilization	Indicates the percent of beans that have been utilized from the pool.	Number	A high value is indicative of maximum utilization of the bean instances from the pool.