Handles Usage - OS Test

This test monitors and tracks the handles opened by processes running in a target Windows virtual desktop.

Target of the test : A Windows virtual desktop on the cloud

Agent deploying the test : A remote agent

Outputs of the test : One set of results for each user_on_virtualdesktop

Configurable parameters for the test
Parameter	Description
Test Period	How often should the test be executed.
Host	The nick name of the Cloud Desktops component for which this test is to be configured.
Port	Refers to the port at which the specified host listens to. By default, this is NULL.
Inside View Using	To obtain the 'inside view' of performance of the cloud-hosted Windows desktops - i.e., to measure the internal performance of the Windows virtual desktops - this test uses a light-weight eG VM Agent software deployed on each of the desktops. Accordingly, this parameter is by default set to eG VM Agent (Windows).
Report Powered OS	This flag is relevant only for those tests that are mapped to the Inside View of Desktops layer. If this flag is set to Yes (which is the default setting), then the 'inside view' tests will report measures for even those Windows virtual desktops that do not have any users logged in currently. Such desktops will be identified by their name and not by the username_on_virtualdesktopname. On the other hand, if this flag is set to No, then this test will not report measures for those Windows virtual desktops to which no users are logged in currently.
Is Cloud VMs	Since this test runs for a 'Cloud Desktops' component, this flag is set to Yes by default.
Handles Growth Limit	This defines the upper limit of the handles opened by any process. By default, this parameter is set to 100000.
DD Frequency	Refers to the frequency with which detailed diagnosis measures are to be generated for this test. For instance, if you set to 1:1, it means that detailed measures will be generated every time this test runs, and also every time the test detects a problem.
Detailed Diagnosis	To make diagnosis more efficient and accurate, the eG suite embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option. The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled: The eG manager license should allow the detailed diagnosis capability Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
Handles used by processes	Indicates the number of handles opened by various processes running in a target Windows virtual desktop in the last measurement period.	Number	Use the detailed diagnosis of this measure to determine the top-10 processes in terms of number of handles opened. This information brings to light those processes with too many open handles. By closely tracking the handle usage of these processes over time, you can identify potential handle leaks.
Processes using handles above limit in the VM	Indicates the number of processes that have opened the handles on or above the value defined in the input parameter - HANDLES GROWTH LIMIT.	Number	Using the detailed diagnosis of this measure, you can accurately isolate the process(es) that has opened more handles than the permitted limit. A high value of this measure indicates that too many processes are opening handles excessively. You might want to closely observe the handle usage of these processes over time to figure out whether the spike in usage is sporadic or consistent. A consistent increase in handle usage could indicate a handle leak.

The detailed diagnosis of the Handles used by processes measure, if enabled, lists the names of top-10 processes in terms of handle usage, the number of handles each process uses, the process ID, and the ID of the parent process.

Figure 6 : The detailed diagnosis of the Handles used by processes measure

The detailed diagnosis of the Processes using handles above limit in VM measure, if enabled, lists the details of processes that are using more handles than the configured limit.

Figure 7 : The detailed diagnosis of the Processes using handles above limit in VM measure