File Descriptors Test

A file descriptor is a handle created by a process when a file is opened. A new descriptor is created each time the file is opened. The File Descriptor test monitors the descriptors created by an application. This test is disabled by default. To enable the test, go to the enable / disable tests page using the menu sequence : Agents -> Tests -> Enable/Disable, pick Oracle WebLogic as the desired Component type, set Performance as the Test type, choose the test from the disabled tests list, and click on the < button to move the test to the ENABLED TESTS list. Finally, click the Update button.

Target of the test : A WebLogic Application Server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every descriptor 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.


Specify the path to the ps command (The default location is /usr/ucb). The eG user must be vested with execute permissions in order to execute the ps command.

PFilesPath Specify the path to the pfiles command (The default is /usr/ucb).

Takes a process name and process pattern in the format: processName:processPattern. While the processName is a display name, the processPattern should uniquely identify the application's process ID (PID of the application). The processPattern can be of the form - *expr* or expr or *expr or expr* or *expr1*expr2*... or expr1*expr2, etc. A leading '*' signifies any number of leading characters, while a trailing '*' signifies any number of trailing characters. For instance, the Process parameter can be configured as: iplanet:*Xms*, where iplanet is the name that will be displayed in the eG monitor interface, and *Xms* is the process pattern that needs to be monitored. *Xms* will monitor only those processes which contain the string "Xms". Multiple processes can be defined as a comma-separated list.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Rlimit fd current

The current limit of file descriptors associated with a particular application. Each application has a limit on the number of file descriptors which it can use. The default is 256.



Number of file descriptors open

The number of file descriptors which are open at present


A consistent increase in the value of this measure over a period of time could indicate that file handles are not being released properly. If the problem is not addressed soon, it could seriously hamper application performance.

Usage of file descriptors

The percentage usage of the file descriptors for the application