Horizon Desktop Pools Test

Horizon Desktop Pools are basis of centralized management collections of virtual desktops that are managed as a single entity. These pools allow administrators to group desktops with similar configurations and deliver them to users based on their roles, requirements, or organizational structure. As multiple desktops are delivered to multiple users from the desktop pool, it is necessary for administrators to ensure that the desktops are powered on and ready to be delivered to users without any errors and failures. If errors or failures occur or desktops are powered off/disabled/unreachable when the desktops are being provisioned from the pool, it will adversely impact the desktop delivery and also overall user experience with the pool. This is why administrators should continuously monitor the desktop pools configured in the target Horizon Cluster/Pod. The Horizon Desktop Pools test can help administrators in this regard. This tests auto-discovers the desktop pools configured on the target Horizon Cluster/Pod, and for each desktop pool, it reports the count of desktops in different state and sessions established to the

Target of the test : An Omnissa 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 Omnissa 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 Omnissa Horizon Cluster/Pod. By default, this is set to NULL.

Connection Server Name

By default, this test connects to every Horizon Connection Server configured in the Omnissa Horizon Cluster/Pod remotely and collects the required metrics. For this, it is necessary to specify valid credentials of the 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 Omnissa Horizon Connection Servers for Monitoring.

User Name, Password and Confirm Password

By default, this test uses Omnissa Horizon Restful APIs to collect the required metrics from the target Omnissa Horizon Cluster/Pod. For this, the eG agent should be configured with read-only user privileges that will allow the agent to communicate with the Horizon Connection Server in a particular domain and extract statistics. Therefore, specify the credentials of the user who is authorized to access the Horizon Connection Server against the User Name, Password and Confirm Password text boxes.

Domain Name

Specify the name of the domain to which the Horizon Connection Server belongs to.

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.

Idle Duration Time (Mins)

Specify the duration (in minutes) of inactivity beyond which a session is considered to be “idle” by this test. By default, this parameter takes the value 10 (minutes); this implies that by default, the test considers all sessions that have been inactive for beyond 10 minutes as idle sessions.

Show Entitlements

In large environments where thousands of users or groups are entitled to access multiple desktops and applications across multiple pods, this test may take longer duration to count all the entitlements and report them within the configured test period. To avoid such inconveniences, administrators can decide whether this test should collect the count of entitlements in the target environment or not using this flag. By default, this flag is set to No indicating that this test will not report entitlements by default. However, if you want this test to report count of entitlements, then set this flag to Yes.

Use Pool ID For Descriptor

By default, this flag is set to Yes indicating that the test will report metrics for each desktop pool ID i.e., the desktop pool ID will be reported as the descriptor of the test. If you wish to view the metrics for each desktop pool, then, set this flag to No.

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 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

This measure will appear only if the Show Entitlements flag is set to Yes.

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

Total entitled local users in pool

Indicates the total number of local users who have been entitled to use this pool.

Number

This measure will appear only if the Show Entitlements flag is set to Yes.

Local users refer to users defined within the Horizon environment or connected directory service (such as Active Directory) and are part of the organization’s internal user management system.

Total entitled global users in pool

Indicates the total number of global users who have been entitled to use this pool.

Number

This measure will appear only if the Show Entitlements flag is set to Yes.

Global user entitlements in Horizon allow administrators to grant users or groups access to desktop pools across multiple Horizon pods within a cloud environment.

Administrators manages global user entitlements through the Horizon Console to ensure secure and efficient access to resources for users and groups, regardless of their location. This capability enhances flexibility, scalability, and availability in virtual desktop environments.

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

Agent Unreachable status occurs when the View Connection Server is unable to establish communication with the View Agent on a Omnissa Horizon View virtual machine in a pool. The communication failure may occur due to one or more of the following reasons:

  • Virtual desktop computer is unreachable.

  • VDI desktop agent unreachable.

  • Virtual machine (VM) is unresponsive.

  • The operating system freezes or fails.

  • The virtual machine shuts down or boots up, the agent service is not running.

  • Incorrect network configuration or connection issues between View Connection Server and the View Agent.

  • Lookup failure on the machine for the DNS name of the Connection Server host.

  • The ports for JMS, RDP, or AJP13 communication being blocked by firewall rules.

  • The failure of the JMS router on the Connection Server host.

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.

 

 

Sessions via PCoIP

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.

Sessions via Blast

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.

Sessions via RDP

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 application sessions

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

Number

 

Disconnected application sessions

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

This measure will be reported only if the value of the Total desktops registered measure is greater than 1.

Ideally, the value of this measure should be high.

The value of this measure is obtained using the formula:

(Connected desktops / Total desktops registered)*100

Note that this measure is not applicable if the pool type is RDS.

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.

When provisioning

Indicates how the desktops in this pool are being provisioned.

 

When provisioning the horizon desktop pools in the target Horizon environment, administrators can create desktops using on demand or up front method based on the requirements.

Up-front method - This method enables creating all the desktops in the pool at once, based on the total number of users who will be accessing the pool.

On-demand a.k.a dynamic method - In this method, the desktops are provisioned as they are required by the users. When a user logs in for the first time, a desktop is provisioned specifically for him/her.

The numeric values that correspond to the above-mentioned states are as follows:

Measure Value Numeric Value
On demand 1
Up front 2

Note:

By default, this measure reports the above-mentioned Measure Values while indicating whether the desktops in this pool are provisioned using up-front or on-demand method. However, the graph of this measure will be represented using the corresponding numeric equivalents as mentioned in the table above.

Provisioning type

Indicates which type of provisioning is used in this pool.

 

The numeric values that correspond to the above-mentioned states are as follows:

Measure Value Numeric Value
vCenter 1
View composer 2
Instant clone engine 3
Unmanaged 4

Note:

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

User assignment

Indicates the number of users assigned to access this pool.

Number

 

Enable automatic assignment

Indicates whether/not automatic assignment is enabled for this pool.

 

The numeric values that correspond to the above-mentioned states are as follows:

Measure Value Numeric Value
Yes 1
No 0

Note:

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

Is vCenter enabled?

Indicates whether/not this pool is enabled with vCenter integration.

 

The numeric values that correspond to the above-mentioned states are as follows:

Measure Value Numeric Value
Yes 1
No 0

Note:

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

Desktops in startup progress state

Indicates the number of desktops that are in startup progress state in this pool.

 

The value of this measure should be low.

If desktops in a Horizon desktop pool are stuck in the "Startup Progress" state, it indicates that the desktops are not fully booting up or not successfully connecting to the Horizon environment. Therefore, a high value for this measure is a cause for concern.

Desktops in disabled state

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

Number

When desktops in the target environment are in the "Disabled" state, it indicates that the desktops are not available for users to connect to, either due to manual intervention or underlying issues that prevent the desktops from being operational.

Desktops in disable progress state

Indicates the number of desktops that are in Disable Progress state in this pool.

Number

If the desktops in the target Horizon environment are in a "Disable Progress" state, it indicates that the system is currently in the process of disabling those desktops. This state is usually temporary and should eventually result in the desktops either being fully disabled or encountering an error if something goes wrong during the process.

Desktops in validating state

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

Number

If the desktops in the target Horizon environment are in a "Validating" state, it means that a series of checks are being performed on those virtual desktops before they can be fully operational. The validation process ensures that the desktops are properly configured, powered on, and ready for user connections. If the desktops are stuck in the "Validating" state, it may indicate an issue preventing the validation from completing.

Powered on desktops

Indicates the number of desktops in this pool that are currently powered on.

Number

 

Powered off desktops

Indicates the number of desktops in this pool that are currently powered off.

 

 

Suspended desktops

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

 

 

Internal gateway sessions

Indicates the number of sessions established to the desktops in this pool using internal gateway configuration.

Number

Internal gateway configuration gives the ability for end users located inside a corporate network to have trusted HTML Access (Blast) connections to their desktops and applications. This ensures that the users can connect to their virtual desktops or applications without having to traverse external networks or VPNs.

External gateway sessions

Indicates the number of sessions established to the desktops in this pool using external gateway configuration.

Number

External gateway configuration gives the ability to provide access to desktops and applications for end users who are located outside of the corporate network.

Unknown gateway sessions

Indicates the number of sessions established to the desktops in this pool that are in Unknown state.

Number

In the target Horizon environment, Unknown Gateway Sessions are the sessions that appear in the Horizon Administrator Console with an "Unknown" status under the gateway column. This status usually indicates that Horizon is unable to determine the gateway through which the session was established. The sessions may be reported as unknown sessions due to various issues, ranging from configuration errors to communication problems between the Horizon components.

HTML client type sessions

Indicates the number of sessions during which the users access the desktops in this pool through a web browser using the Omnissa Horizon HTML Access client.

Number

 

Windows client type sessions

Indicates the number of sessions during which the users access the desktops in this pool using the Omnissa Horizon Client installed on a Windows operating system.

Number

Administrators commonly use this method for accessing the desktops in the pools as this method offers users with the complete set of features and seamless connectivity compared to other client types (e.g., HTML Client).

Other client type sessions

Indicating the number of sessions during which the users access the desktops in this pool using the Omnissa Horizon Client installed on a Windows operating system.

Number

 

Idle sessions

Indicates the number of sessions that have been idle beyond the time duration specified against the Idle Duration Time (Mins) parameter.

Number

The value of this measure should be very low.

Total unique user sessions

Indicates the number of sessions established to the desktops in this pool by unique users.

Number

 

Total problematic desktops

Indicates the total number of problematic desktops in this pool.

Number

Compare the value of this measure across the pools to identify the pool that has maximum number of problematic desktops.

Sessions brokered from remote POD

Indicates the number of sessions to the desktops in this pool that are brokered from remote POD.

Number

 

Sessions using remote POD resources

Indicates the number of sessions established to the desktops in this pool that are using remote POD resources.

Number

Compare the value of this measure across the pools to find out which pool has sessions that use maximum amount of remote POD resources.

Unauthenticated user sessions

Indicates the number of sessions to the desktops in this pool that are established by unauthenticated users.

Number

 

Agents unreachable

Indicates the percentage of desktops in this pool that are in Agents unreachable state.

Percent

The value of this measure should very low or zero. A high value for this measure indicates that more number of desktops will not be reachable to the users.

Unassigned available desktops

Indicates the number of desktops in this pool that are not assigned to users.

Number