Agents Administration - Tests
 

Default Parameters for JmxConnectorTest

The JmxConnectorTest reports the real-time connectivity statistics to the java application via JMX agent.

The parameters of this test are as follows:

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

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

    • Using SNMP-based access to the Java runtime MIB statistics;
    • By contacting the Java runtime (JRE) of the application via JMX

    To configure the test to use SNMP, select the SNMP option. On the other hand, choose the JMX option to configure the test to use JMX instead. By default, the JMX option is chosen in the MODE text box.

  • The JMX REMOTE PORT text box appears only if the 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 in the <JAVA_HOME>\jre\lib\management folder used by the target application.

  • The JNDINAME text box appears only if the 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.

  • The USER, PASSWORD and CONFIRM PASSWORD text boxes,appear only if the MODE 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 Section 1.1.1.2 of the Monitoring Java Applications document. Confirm the password by retyping it in the CONFIRM PASSWORD text box.

  • Finally, click the Update button.

When changing default configurations of tests, the values with “$” indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to “xyz” and $port will be changed to “80” when configuring a test.