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.
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. |
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. |