Horizon Pools Test
Horizon Pools represent a centralized management collection 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 Omnissa Horizon Cloud Control Plane. The Horizon Pools test can help administrators in this regard. This test monitors the desktop pools configured on the target Omnissa Horizon Cloud Control Plane, and for each desktop pool, it reports the count of desktops in different state and sessions established to the desktops. This test also helps the administrators to track different types of sessions for each desktop pool.
Target of the test : Omnissa Horizon Cloud Control Plane
Agent deploying this test : A remote agent
Outputs of the test :One set of results for each desktop pool configured on the target Omnissa Horizon Cloud Control Plane being monitored.
| Parameters | Description |
|---|---|
|
Test period |
How often should the test be executed. |
|
Host |
The host for which the test is to be configured. |
|
Port |
The port to which the specified host listens. |
|
API Token |
The API token acts as a temporary credential that validates the identity of the client making the API request. After the client successfully authenticates using the API Client ID and Client Secret, the system issues an API token. Specify the API token value that was generated using the Omnissa Connect console. To know how to generate the API token in Omnissa Connect console, refer to Creating a new API token in Omnissa Connect console topic in How Does eG Enterprise Monitor Omnissa Horizon Cloud Control Plane?. |
|
ProxyHost and ProxyPort |
In some environments, all communication with the Omnissa Horizon Cloud Control Plane be routed through a proxy server. In such environments, you should make sure that the eG agent connects to the Omnissa Horizon Cloud Control Plane via the proxy server and collects metrics. To enable metrics collection via a proxy, specify the IP address of the proxy server and the port at which the server listens against the ProxyHost and ProxyPort parameters. By default, these parameters are set to none, indicating that the eG agent is not configured to communicate via a proxy, by default. |
|
ProxyUsername, ProxyPassword, Confirm Password |
If the proxy server requires authentication, then, specify a valid proxy user name and password in the Proxy Username and Proxy Password parameters, respectively. Then, confirm the password by retyping it in the Confirm Password text box. If no proxy server is used, or if the proxy server used does not require authentication, then the default setting - none - of these parameters, need not be changed. |
|
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:
|
| Measurement | Description | Measurement Unit | Interpretation | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
Status |
Indicates the current status of this desktop pool. |
|
The numeric values and their corresponding State values are mentioned in the table below:
Note: By default, this measure reports the above-mentioned states while indicating the current status of the desktop pool. However, the graph of this measure will be represented using the corresponding numeric equivalents only. The detailed diagnosis for this measure provides the pool details such as Pool Group name, Horizon Edge, Created time, and Modified time. |
||||||||
|
Type |
Indicates the type of this desktop pool. |
|
The numeric values and their corresponding State values are mentioned in the table below:
Note: By default, this measure reports the above-mentioned states while indicating the type of this desktop pool. However, the graph of this measure will be represented using the corresponding numeric equivalents only. |
||||||||
|
Connectivity status |
Indicates the connectivity status of this desktop pool. |
|
The numeric values and their corresponding State values are mentioned in the table below:
Note: By default, this measure reports the above-mentioned states while indicating the connectivity status of this desktop pool. However, the graph of this measure will be represented using the corresponding numeric equivalents only. |
||||||||
|
Consumed VMs |
Indicates the number of desktops in this pool that are currently in the Consumed state. |
Number |
If a desktop that is set to refresh on log off is reset, the desktop goes into the Consumed state. |
||||||||
|
Deleting VMs |
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. |
||||||||
|
Error VMs |
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. |
||||||||
|
Free sessions |
Indicates the number of unused sessions in this desktop pool. |
Number |
|
||||||||
|
Maintenance VMs |
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. |
||||||||
|
Provisioned sessions |
Indicates the number of allocated sessions in this desktop pool. |
Number |
|
||||||||
|
Provisioning VMs |
Indicates the number of desktops in this pool that are currently in the Provisioning state. |
Number |
The provisioning state refers to the current status of the virtual machine indicating whether the VM is being created, deployed, or has any issues. A non-zero value for this measure indicates that desktops in the pool are being provisioned. The detailed diagnosis for this measure provides the Provisioned VM details such as Assigned Users, Subscription ID, VM Name, Status, IPV4 address, Machine identity/vNet/Subnet, VM Model, Life Cycle Status, Agent Version, Agent Status, Session allocation status, OS disk size(GB), and OS disk type. |
||||||||
|
Provisioned VMs |
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. |
||||||||
|
Agent updating VMs |
Indicates the number of agent updating VMs. |
Number |
An agent updating VMs is software that automates the process of keeping virtual machines updated, whether it's for security patches, software upgrades, or configuration changes. |
||||||||
|
Agent reinstalling VMs |
Indicates the number of agent reinstalling VMs. |
Number |
An agent reinstalling itself typically refers to a process where a software agent (used for updates, monitoring, security, etc.) on a virtual machine automatically installs or reinstalls itself. This might occur for software updates, to fix issues with the current agent, or as part of a larger automated infrastructure management process. |
||||||||
|
Outdated agent VMs |
Indicates the number of outdated agent VMs. |
Number |
An outdated agent on a VM can cause various issues ranging from security vulnerabilities to loss of functionality and performance monitoring. Keeping agents up to date is crucial for maintaining a secure and efficient environment. Regularly check for agent updates, automate the process where possible, and ensure monitoring and patch management practices are in place to avoid outdated agent issues. |
||||||||
|
Total sessions |
Indicates the total number of sessions in this desktop pool. |
Number |
The detailed diagnosis for these measures provide details such as User name, VM name, Login time, Session duration(days:hours:min), Protocol, Client ID, Agent session ID, View agent version, Edge name, Site name, and Client session ID.
|
||||||||
|
Total desktop sessions |
Indicates the total number of active desktop sessions in this desktop pool. |
Number |
|||||||||
|
Connected desktop sessions |
Indicates the number of desktops in this pool that are in active sessions and have active remote connections to a view client. |
Number |
The detailed diagnosis of this measure provides the details of the connected desktops. |
||||||||
|
Disconnected desktop sessions |
Indicates the number of desktops in this pool that are in active sessions but are disconnected from the View client. |
Number |
The detailed diagnosis of this measure provides the details of disconnected desktops. |
||||||||
|
Total application sessions |
Indicates the total number of application sessions in this desktop pool. |
Number |
The detailed diagnosis for this measure provides the Application Session details such as User name, VM name, Login time, Session duration (days:hours:min), Protocol, Client ID, Agent session ID, View agent version, Edge name, Site name, and Client session ID. |
||||||||
|
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 |
The detailed diagnosis for this measure provides the Connected Application Session details such as User name, VM name, Login time, Session duration(days:hours:min), Protocol, Client ID, Agent session ID, View agent version, Edge name, Site name, and Client session ID. |
||||||||
|
Disconnected application sessions |
Indicates the number of applications in this pool that are in active sessions but are disconnected from the View client. |
Number |
The detailed diagnosis for this measure provides the Disconnected Application Session details such as User name, VM name, Login time, Session duration(days:hours:min), Protocol, Client ID, Agent session ID, View agent version, Edge name, Site name, and Client session ID.
|
||||||||
|
Sessions utilization |
Indicates the percentage of desktop sessions actively used in this pool. |
Percent |
Ideally, the value of this measure should be high. |
||||||||
|
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 |
|
||||||||
|
Limit desktops |
Indicates the number of limit desktops in this desktop pool. |
Number |
Limit desktop usually refers to the maximum number of virtual desktops that can be assigned, created, or supported in a desktop pool or environment. |
||||||||
|
Blast Sessions |
Indicates the number of Blast sessions in this desktop pool. |
Number |
Blast session refers to a protocol designed to optimize the performance of virtual desktops and applications, particularly for scenarios where users access desktops from various devices, such as PCs, smartphones, or thin clients. The details of the Blast sessions can be viewed in the detailed diagnosis. |
||||||||
|
RDP sessions |
Indicates the number of RDP sessions in this desktop pool. |
Number |
RDP session refers to a remote desktop session that is established using the Remote Desktop Protocol (RDP) to access a virtual machine (VM) or virtual desktop in a virtual desktop infrastructure (VDI) environment. The details of the RDP sessions can be viewed in the detailed diagnosis. |
||||||||
|
Used sessions |
Indicates the number of desktop sessions actively used in this pool. |
Number |
|
||||||||
|
Total applications |
Indicates the number of applications actively running in desktops of this pool. |
Number |
The detailed diagnosis for this measure provides the Application details such as Display Name, and Version Publisher Path. |
||||||||
|
Reconnected desktop sessions |
Indicates the number of desktop sessions that were reconnected in this pool. |
Number |
The detailed diagnosis for this measure provides the Reconnected Desktop Session details such as User name, VM name, Login time, Session duration (days:hours:min), Protocol, Client ID, Agent session ID, View agent version, Edge name, Site name, and Client session ID. |
||||||||
|
Reconnected application sessions |
Indicates the number of application sessions that were reconnected in this pool. |
Number |
The detailed diagnosis for this measure provides the Reconnected Application Session details such as User name, VM name, Login time, Session duration (days:hours:min), Protocol, Client ID, Agent session ID, View agent version, Edge name, Site name, and Client session ID. |