Agents Administration - Tests
 

Configuration of WVDOsHandleTest

This test monitors and tracks the handles opened by processes running in the chosen Azure Virtual Desktop.

The default parameters associated with this test are as follows:

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

  • In the HOST text box, the IP address of the host for which the test is to be configured has to be specified.

  • Specify the port at which the specified HOST listens to in the PORT text box. By default, this is NULL.

  • The HANDLE GROWTH LIMIT parameter defines the upper limit of the handles opened by any process. By default, this parameter is set to 8000. You can override this default setting by providing a higher or lower value here.

    Those processes that are using more handles than the value specified against this parameter will be considered as processes that are using handles above limit. The count of such processes will then be reported as the value of the Processes using handles above limit measure.

  • The detailed diagnosis of the Processes using handles above limit measure reveals the top-10 processes that are using handles above the configured limit and the number of handles used by each process. If the SHOW SUB HANDLES IN DD flag is set to Yes, then the detailed diagnosis will additionally display 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. 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.

  • If multiple components of the same component type are awaiting configuration, then an APPLY TO OTHER COMPONENTS check box will appear in this page. Clicking on this check box will allow you to apply the configuration to all/selected components of that type.

  • Once the necessary values have been provided, clicking on the UPDATE button will 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.