Default Parameters for OsHandleTest

This test monitors and tracks the handles opened by processes running in a target host system.

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

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

• The HANDLE GROWTH LIMIT defines the upper limit of the handles opened by any process. By default, this parameter is set to 100000.

• The detailed diagnosis of the Processes using handles above limit measure reveals the top-10 processes that are using handles above the configured limit, the number of handles used by each process, and the break-up of the handle count by sub-handles (i.e., the count of file handles, disk handles, etc.). For processes that typically open thousands of handles, storing granular, sub-handle-level information pertaining to these handles may impose additional strain on the eG database. In such cases, you can reduce the strain on the eG database by configuring in the IGNORE PROCESSES IN DD text box, a comma-separated list of process names/process patterns for which sub-handle-wise breakup need not be collected and stored in the eG database. The default value in this text box is *ccSvcHst.exe*. This implies that, by default, the detailed diagnosis of the Processes using handles above limit measure will only provide the total number of open handles for ccSvcHst.exe process, but not the sub-handle-level information. If required, you can choose to exclude the sub-handle-wise breakup from the detailed diagnosis for more processes by including these process names/patterns as part of the IGNORE PROCESSES IN DD specification. For instance, your specification can be: *ccSvcHst.exe*,*js.exe*,*java.exe*

• By default, the SHOW SUB HANDLES IN DD flag is set to No indicating that this test will not report sub-handle details as part of its detailed diagnostics, by default. This setting will help you to conserve space in the eG database. However, you can set this flag to Yes if you want to see the sub-handles opened by each of the top-10 processes in the detailed diagnosis. To this effect, the Top 10 Open Handles column will be populated with relevant information in the detailed diagnostics reported for the Processes using handles above limit measure.

• In the EXCLUDE PROCESSES IN DD text box, specify a comma-separated list of processes that should be excluded from the scope of reporting as part of the detailed diagnostics of the Processes using handles above limit measure. For instance, your specification can be: *ccSvcHst.exe*,*js.exe*,*java.exe*.

• Once the above value is provided, click on the Update button to register the changes made.

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.