Jboss EJBs Test
This test monitors the EJBs deployed on the JBoss server. If the JBoss server hosts a large number of EJBs, then managing the individual EJBs would be quiet a challenge. Therefore, to enable administrators to manage EJBs easily, the eG Enterprise system allows the configuration of EJB groups. The eG agent executing this test will then, by default, report measures for every group that is configured. To configure EJB groups, click on the Click here hyperlink in the test configuration page of the Jboss Ejbs test.
Target of the test : A JBoss application server
Agent deploying the test : An internal agent
Outputs of the test : By default, the test reports one set of results for each EJB group that is configured using the eG administrative interface.
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 number at which the specified host listens to. |
Measurement Mode |
This test can extract metrics from JBoss using either of the following mechanisms:
To configure the test to usethe EgJBossAgent.sar and egjboss.war files, first, select the War File option. Then, refer to the How to Monitor JBoss Application Server Using eG Enterprise? chapter to know how to deploy these files on the target JBoss server. On the other hand, if you want the test to use JMX instead, then first, select the jmx option. Then, follow the procedure detailed in the How to Monitor JBoss Application Server Using eG Enterprise? chapter to configure the test to use jmx. By default, the jmx option is chosen here. |
JNDIName |
This parameter appears only if the Measurement Mode is set to jmx. The JNDIName is a lookup name for connecting to the JMX connector. By default, this is jmxrmi. If you have registered the JMX connector in the RMI registry using a different lookup name, then you can change this default value to reflect the same. |
JMX Remote Port |
This parameter appears only if the Measurement Mode is set to jmx. Here, specify the port at which the jmx listens for requests from remote hosts. Ensure that you specify the same port that you configured in the management.properties file of the target JBoss server (refer to the How to Monitor JBoss Application Server Using eG Enterprise? chapter for more details). |
JMX User, JMX Password, and Confirm Password |
These parameters appear only if the Measurement Mode is set to jmx. If JMX requires authentication only (but no security), then ensure that the JMX User and JMX Password parameters are configured with the credentials of a user with read-write access to JMX. To know how to create this user, refer to the How to Monitor JBoss Application Server Using eG Enterprise? chapter. Confirm the password by retyping it in the Confirm Password text box. |
SSL |
This parameter appears only if the Measurement Mode is set to War File. Indicate Yes if the JBoss server is SSL-enabled. |
URL |
This parameter appears only if the Measurement Mode is set to War File. Specify the URL to be accessed to collect metrics pertaining to the JBoss server. By default, this test connects to a managed JBoss server and attempts to obtain the metrics of interest by accessing the local Mbeans of the server. Accordingly, by default, this parameter is set to http://<JBossServerIP>:<JbossServerPort>. |
JMX Provider |
This parameter appears only if the Measurement Mode is set to jmx. This test uses a JMX Provider to access the MBean attributes of the JBoss server and collect metrics. Specify the package name of this JMX Provider here. By default, this is set to com.sun.jmx.remote.protocol. |
Timeout |
Specify the duration (in seconds) for which this test should wait for a response from the JBoss server. If there is no response from the server beyond the configured duration, the test will timeout. By default, this is set to 240 seconds. |
Measurement | Description | Measurement Unit | Interpretation |
---|---|---|---|
Creation rate |
Indicates the rate of creation of beans. |
EJBs/Sec |
|
Removal rate |
Indicates the rate at which the EJBs are removed. |
EJBs/Sec |
|
Message rate |
Indicates the rate at which messages are handled. |
Msgs/Sec |
|
Method ready count |
Indicates the number of EJBs where the methods are currently in the ready state to service clients. A Method is a function invoked by clients on the EJB to perform a specific task. |
Number |
|
Ready count |
Indicates the number of EJBs that are currently ready to service clients. |
Number |
|
Pooled count |
Indicates the number of EJBs that are in the pool, currently. |
Number |
|
Passive count |
Indicates the number of EJB instances that have been passivated, currently. Passivation is the act of storing an EJB instance in a permanent store like a hard disk for future activation. |
Number |
|