JVM Summary Test

This test continuously monitors the Java application and reports the count of objects that are waiting to be finalized as well as the time taken to compile the objects.

Target of the test : A Java application

Agent deploying the test : An internal/remote agent

Outputs of the test : One set of results for the Java application being 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 number at which the specified host listens to
Metric Collection Type	This test can extract metrics from the Java application using either of the following mechanisms: Using the eg_btm.jar file available in the <eG_INSTALL_DIR>\lib\apm\java\default folder; By contacting the Java runtime (JRE) of the application via JMX To configure the test to collect metrics from the eg_btm.jar file, select the JAR option. On the other hand, to configure the test to use JMX options, choose the JMX option. By default, JAR option is chosen here.
JMX Remote Port	This parameter appears only if the Metric Collection Type 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 in the <JAVA_HOME>\jre\lib\management folder used by the target application (see page 1).
JNDI Name	This parameter appears only if the Metric Collection Type is set to JMX. The JNDI Name 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 user, JMX Password, and Confirm password	These parameters appear only if the Metric Collection Type is set to JMX. If JMX requires authentication only (but no security), then ensure that the user and 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 Configuring the eG Agent to Support JMX Authentication. Confirm the password by retyping it in the Confirm Password text box.
Provider	This parameter appears only if the Metric Collection Type is set to JMX. This test uses a JMX Provider to access the MBean attributes of the target Java application 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 target Java application. If there is no response from the target beyond the configured duration, the test will timeout. By default, this is set to 240 seconds.
JMX Registry SSL	If you have registered the JMX connector in an SSL-enabled RMI registry , set this flag to Yes. By default, this is set to No.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
Pending Finalization	Indicates the number of objects for which finalization is pending for the JVM.	Number	Sometimes an object will need to perform some action when it is destroyed. For example, if an object is holding some non-java resource such as a file handle or window character font, then you might want to make sure these resources are freed before an object is destroyed. To handle such situations, Java provides a mechanism called finalization. By using finalization, you can define specific actions that will occur when an object is just about to be reclaimed by the garbage collector. A high value for this measure indicates the existence of many objects that are still occupying the JVM memory space and are unable to be reclaimed by GC. A consistent rise in this value is also a sign of a memory leak.
Compilation Time	Indicates the time taken for compiling the objects.	Milliseconds