Desktops Test

If a user complains of issues when accessing or working with a desktop, administrators must be able to quickly zoom into that user’s session to identify the desktop that the user is currently logged into and determine what is wrong with the user’s session – is it inactive? Is it awaiting a refresh? Has the session logged out? The Desktops test provides administrators with this insight. This test auto-discovers all users who are currently logged into desktops and reports on the state of each user’s session, so that problems (if any) with desktop sessions can be isolated and fixed.

Target of the test : A VDI-in-a-Box Manager

Agent deploying the test : A remote agent

Outputs of the test : One set of results for each user session.

Configurable parameters for the test
Parameters Description

Test period

This indicates how often should the test be executed.


The host for which this test is to be configured.


The port at which the specified host listens to.

VDI in a Box Host

The IP address of the vdimanager that is being monitored.

VDI in a Box Username, VDI in a Box Password, and Confirm Password

The test needs to log on to the VDI-in-a-Box appliance to pull out the metrics of interest. For this purpose, you need to configure the test with the credentials of a user with login rights to the appliance. By default, the appliance supports a root user named root (with the default password root) and a Read-only user named kvm (with the default password kaviza123). If you prefer not to expose the credentials of the root user, then you can configure the VDI in a Box Username and VDI in a Box Password parameters with the credentials of the user kvm. Confirm the password of this user by retyping it in the Confirm Password text box.


The default password of user kvm is kaviza123. If this is changed, then make sure you configure the VDI in a box password parameter with the new password.

SSH Port

Specify the SSH port number of the vdimanager. By default, this is 22.

Detailed Diagnosis

To make diagnosis more efficient and accurate, eG Enterprise 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


Indicates the current status of this user’s desktop session.


The values that this measure can take and their corresponding numeric values are discussed in the table below:

Measure Value Description Numeric Value
Active User session is active. It is also current, i.e., the user session has started after the last desktop refresh cycle. 1
Pending refresh User session is active. However, it is active beyond the last desktop refresh cycle. The user had logged in before the last desktop refresh cycle and has not logged out yet 2
On Hold A user had logged in and logged out after the last desktop refresh cycle 3
In Use The desktop session is displaying a login screen on a kiosk-style client 4
Logging in

The desktop session is logged out and ready to accept a new login on a kiosk-style client

The user is in the process of logging in.

Kiosk ready The desktop session is displaying a login screen on a kiosk-style client 6
Kiosk The desktop session is logged out and ready to accept a new login on a kiosk-style client 7


By default, this measure reports the above-mentioned Measure Values while indicating the session state. However, in the graph of this measure, the same will be represented using the corresponding numeric equivalents only.

To know which desktop the user is currently logged into, use the detailed diagnosis of this measure.

Use the detailed diagnosis of the Status  measure to know which desktop the user is logged into, from which client the user logged in, when he/she logged in, and the duration of access.


Figure 1 : The detailed diagnosis of the Status measure of the Desktops test