JVM File Descriptors Test

This test reports useful statistics pertaining to file descriptors.

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.


The IP address of the host for which this test is to be configured.


The port at which the specified host listens. By default, this is NULL.

JMX Port

This parameter appears only if the Measure 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 Java Applications chapter.


This parameter appears only if the Measure 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. 

User, Password,
and Confirm Password

These parameters appear only if the Measure 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 the Java Applications chapter. Confirm the password by retyping it in the Confirm Password text box.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Open file descriptors in JVM

Indicates the number of file descriptors currently open for the application.



Maximum file descriptors in JVM

Indicates the maximum number of file descriptors allowed for the application.



File descriptor usage by JVM

Indicates the file descriptor usage in percentage.