Agents Administration - Tests
 

Configuration of JvmSummaryTest

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.

This page depicts the default parameters that need to be configured for the JvmSummaryTest .

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

  • In the HOST text box, specify the host for which the test is to be configured.

  • In the PORT text box, specify the port number at which the specified host listens to.

  • This test can extract metrics from the Java application using either of the following mechanisms:

    • JAR - By contacting the eg_btm.jar file if the Java application is BTM-enabled;

    • By contacting the Java runtime (JRE) of the application via JMX.

  • The JMX REMOTE PORT 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 \jre\lib\management folder used by the target application (see page 1).

  • The JNDI NAME 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.

  • The JMX USER and JMX PASSWORD 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.

  • The PROVIDER 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.

  • In the TIMEOUT text box, 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.

  • If you have registered the JMX connector in an SSL-enabled RMI registry , set the JMX REGISTRY SSL flag to Yes. By default, this is set to No.

  • Once the above values are provided, click on the UPDATE button to register the changes made.

When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of “none” in the parameter value indicates that the corresponding parameter value can be changed if required.