Horizon Desktop Pools Test

This test monitors the status and usage of each desktop pool configured on the target VMware Horizon Cluster/Pod.

Target of the test : A VMware Horizon Cluster/Pod

Agent deploying the test : A remote agent

Outputs of the test : One set of results for each desktop pool configured on the VMware Horizon Cluster/Pod being monitored

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The host for which the test is to be configured.

Port

Refers to the port used by the target VMware Horizon Cluster/Pod. By default, this is set to NULL.

Connection Server Name

By default, this test connects to every VMware Horizon Connection Server configured in the VMware Horizon Cluster/Pod remotely and collects the required metrics. For this, it is necessary to specify valid credentials of the VMware Horizon Connection Servers. To help administrators provide these credentials quickly and easily, the eG administrative interface embeds a special configuration page. To access this page, simply click on the encircled '+' icon that appears alongside this parameter in the test configuration page. To know how to use this special page, refer to Configuring the VMware Horizon Connection Servers for Monitoring.

Total Session DD

By default, this flag is set to No, indicating that this test will not report detailed diagnostics for the Total Sessions measure. This means that the test, by default, will not capture and store the details of every session initiated on the desktops of each desktop pool, in the eG database. This default setting is ideal for desktops characterized by the initiation of thousands of sessions simultaneously, as it helps conserve space in the eG database and reduce the strain on the database. However, if your eG database is well-sized and you want to view the complete list of sessions initiated by the desktops in a desktop pool, enable the detailed diagnosis capability of the Total Sessions measure by setting this flag to Yes.

Show Total Desktop DD

By default, this flag is set to No, indicating that this test will not report detailed diagnostics for the Total Desktops registered measure. This means that the test, by default, will not capture and store the details of the total number of desktops registered in each desktop pool, in the eG database. This default setting is ideal for desktops characterized by the initiation of thousands of sessions simultaneously, as it helps conserve space in the eG database and reduce the strain on the database. However, if your eG database is well-sized and you want to view the complete list of sessions initiated by the desktops in a desktop pool, enable the detailed diagnosis capability of the Total Desktops registered measure by setting this flag to Yes.

Disconnected Desktop DD

By default, this flag is set to No, indicating that this test will not report detailed diagnostics for the Disconnected Desktop Sessions measure. This means that the test, by default, will not capture and store the details of the desktop sessions that were disconnected in each desktop pool, in the eG database. This default setting is ideal for desktops characterized by the disconnection of thousands of sessions simultaneously, as it helps conserve space in the eG database and reduce the strain on the database. However, if your eG database is well-sized and you want to view the complete list of desktop sessions that were disconnected in a desktop pool, enable the detailed diagnosis capability of the Disconnected Desktop Sessions measure by setting this flag to Yes.

Disconnected Application DD

By default, this flag is set to No, indicating that this test will not report detailed diagnostics for the Disconnected Desktop Sessions measure. This means that the test, by default, will not capture and store the details of the applications in each desktop pool that were disconnected from the View Client, in the eG database. This default setting is ideal for desktops characterized by the disconnection of thousands of applications simultaneously, as it helps conserve space in the eG database and reduce the strain on the database. However, if your eG database is well-sized and you want to view the complete list of applications that were disconnected in a desktop pool, enable the detailed diagnosis capability of the Disconnected Applications measure by setting this flag to Yes.

Maintenance Desktop DD

By default, this flag is set to No, indicating that this test will not report detailed diagnostics for the Maintenance desktops measure. This means that the test, by default, will not capture and store the details of the desktops that were in the maintenance mode, in the eG database. This default setting is ideal for desktop pools that contained thousands of desktops in maintenance mode simultaneously, as it helps conserve space in the eG database and reduce the strain on the database. However, if your eG database is well-sized and you want to view the complete list of desktops that were in maintenance mode, enable the detailed diagnosis capability of the maintenance desktops measure by setting this flag to Yes.

DD Frequency

Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD Frequency.

Detailed Diagnosis

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

Is pool enabled?

Indicates whether this desktop pool is enabled or not.

 

This measure reports either Enabled or Disabled as the status of this desktop pool. The numeric values that correspond to the above-mentioned states are as follows:

State Numeric Value
Enabled 1
Disabled 0

Note:

By default, this measure reports the above-mentioned states while indicating the status of this desktop pool. However, the graph of this measure will be represented using the corresponding numeric equivalents of the states as mentioned in the table above.

Is pool entitled?

Indicates whether any users or groups have been entitled to access this pool or not.

 

This measure reports either Entitled or UnEntitled as the status of the user in this desktop pool. The numeric values that correspond to the above-mentioned states are as follows:

State Numeric Value
Entitled 1
UnEntitled 0

Note:

By default, this measure reports the above-mentioned states while indicating whether any users or groups have been entitled to access this pool or not. However, the graph of this measure will be represented using the corresponding numeric equivalents of the states as mentioned in the table above.

Total entitled users in pool

Indicates the total number of entitled users presents in this pool.

Number

The detailed diagnosis of this measure displays the details of entitled users present in this desktop pool.

Total sessions

Indicates the total number of remote sessions to the desktops in this desktop pool.

Number

The details of the remote sessions can be viewed in the detailed diagnosis.

Total desktops registered

Indicates the total number of registered desktops present in this desktop pool.

Number

The detailed diagnosis of this measure provides the details of the registered desktops.

Desktop source

Indicates the source of this desktop pool.

 

The values reported by this measure and its corresponding numeric equivalents are mentioned in the table below:

State Numeric Value
Remote Desktop Services 1
vCenter (instant clone) 2
vCenter (linked clone) 3
vCenter 4
Others 0

Note:

By default, this measure reports the above-mentioned states while indicating the source of this desktop pool. However, the graph of this measure will be represented using the corresponding numeric equivalents of the states as mentioned in the table above.

Pool type

Indicates the type of this desktop pool.

 

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

Measure Value Description Numeric Value
Manual desktop pool Manual desktop pools are a collection of existing vCenter Server virtual machines, physical computers, or third-party virtual machines. In automated or manual pools, each Windows machine is available for one user to access remotely at a time.  2
RDS desktop pool RDS desktop pools are not a collection of Windows machines, but instead, provide users with desktop sessions on RDS hosts. Multiple users can have desktop sessions on an RDS host simultaneously. 1
Automated Desktop Pool   3

Note:

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

Agent unreachable desktops

Indicates the number of desktops in this pool that are currently in the Agent unreachable state.

Number

 

Provisioned desktops

Indicates the number of desktops in this pool that are currently in the Provisioned state.

Number

A non-zero value for this measure indicates that one/more desktops in the pool are powered-off or suspended.

Available desktops

Indicates the number of desktops in this pool that are currently in the Available state.

Number

This refers to the number of desktops that are powered on and ready for an active connection.

Agent disable desktops

Indicates the number of desktops in this pool that are currently in the Agent Disabled state.

Number

 

Invalid ip desktops

Indicates the number of desktops in this pool that are currently in the Invalid IP state.

Number

 

Agent needs reboot desktops

Indicates the number of desktops in this pool that are currently in the Agent needs reboot state.

Number

 

Protocol failure desktops

Indicates the number of desktops in this pool that are currently in the Protocol failure state.

Number

 

Domain failure desktops

Indicates the number of desktops in this pool that are currently in the Domain failure state.

Number

 

Already used desktops

Indicates the number of desktops in this pool that are currently in the Already used state.

Number

If a desktop that is set to refresh on log off is reset, the desktop goes into the Already Used state. 

Desktops with configuration error

Indicates the number of desktops in this pool that are currently experiencing configuration errors.

Number

A high value for this measure indicates that many errors occurred during desktop configuration. This is worrisome and should be investigated.

Desktops with provisioning error

Indicates the number of desktops in this pool that are currently experiencing provisioning errors.

Number

A high value for this measure indicates that many errors occurred during desktop provisioning. This is worrisome and should be investigated.

Error desktops

Indicates the number of desktops in this pool that are in the Error state currently.

Number

A non-zero value for this measure is a cause for concern, as it indicates that one/more desktops in the pool have experienced an unknown error.

Unassigned user connected desktops

Indicates the number of desktops in this desktop pool that are currently in the Unassigned user connected state.

Number

 

Unassigned user disconnected desktops

Indicates the number of desktops in this desktop pool that are currently in the Unassigned user disconnected state.

Number

 

Unknown desktops

Indicates the number of desktops in this pool that are currently in an Unknown state.

Number

Ideally, the value of this measure should be 0.

Provisioning desktops

Indicates the number of desktops in this pool that are currently in the Provisioning state.

Number

A non-zero value for this measure indicates that desktops in the pool are being provisioned.

Customizing desktops

Indicates the number of desktops in this pool that are presently in the Customizing state.

Number

A non-zero value for this measure indicates that one/more desktops in an automated pool are being customized.

Waiting for agent desktops

Indicates the number of desktops in this pool that are currently in Waiting for agent state.

Number

 

Deleting desktops

Indicates the number of desktops in this pool that are currently in the Deleting state.

Number

A non-zero value for this measure indicates that one/more desktops in the pool have been marked for deletion, and will be deleted soon.

Maintenance desktops

Indicates the number of desktops in this pool that are in the Maintenance mode presently.

Number

When a desktop is in the Maintenance mode, users cannot log in or use that desktop.

Startup desktops

Indicates the number of desktops in this pool that are currently in the Startup state.

 

 

PCoIP connected sessions

Indicates the number of PCoIP sessions to the desktops in this desktop pool.

Number

The details of the PCoIP sessions can be viewed in the detailed diagnosis.

Blast connected sessions

Indicates the number of Blast sessions to the desktops in this desktop pool.

Number

The details of the Blast sessions can be viewed in the detailed diagnosis.

RDP connected sessions

Indicates the number of RDP sessions to the desktops in this desktop pool.

Number

The details of the RDP sessions can be viewed in the detailed diagnosis.

Connected desktop sessions

Indicates the number of desktops in this pool that are currently in Connected state i.e., the desktops are in active sessions and have active remote sessions to a Horizon client.

Number

 

Disconnected desktop sessions

Indicates the number of desktops in this pool that are currently in Disconnected state i.e., the desktops are in active sessions but are disconnected from the Horizon client.

Number

 

Connected applications

Indicates the number of applications in this pool that are in active sessions and have active remote connections to a View client.

Number

 

Disconnected applications

Indicates the number of applications in this pool that are in active sessions but are disconnected from the View client.

Number

 

Spare desktops

Indicates the number of spare (powered on) desktops that are to be maintained in this pool.

Number

Generally, you want the number of spare desktops at least to equal the number of users that log in within a short time span (usually a few minutes). These reserves ensure that users have an available desktop. You should monitor user-login activity and adjust the settings accordingly.

Maximum desktops

Indicates the maximum number of desktops that can be accommodated in this pool.

Number

 

Minimum desktops

Indicates the minimum number of desktops to be maintained in this pool.

Number

 

Percentage of disconnected desktop sessions

Indicates the percentage of disconnected desktops in this pool.

Percent

A value close to 100% for this measure could indicate that almost all the desktops in the pool are disconnected from the View client. This is a cause for serious concern and requires immediate attention.

Desktop utilization

Indicates the percentage of desktops actively used in this pool.

Percent

Ideally, the value of this measure should be high.

Is provisioning enabled?

Indicates whether provisioning is enabled for this desktop pool or not.

 

This measure reports either Enabled or Disabled as the status of this desktop pool. The numeric values that correspond to the above-mentioned states are as follows:

State Numeric Value
Enabled 1
Disabled 0

Note:

By default, this measure reports the above-mentioned states while indicating whether/not the provisioning is enabled for this desktop pool. However, the graph of this measure will be represented using the corresponding numeric equivalents of the states as mentioned in the table above.