VMware Horizon - Zero to Hero Series - Part 2 (Intermediate) - Segment 1
Welcome to the second series of the VMware Horizon Zero to Hero blog posts. In this post, I will be focusing on the Horizon Administrator Console and all the features and options that are available to you.
To cover the whole Horizon Console would make this blog post extremely long and difficult to follow, so I will be breaking it down into bite-size segments, as follows:
Overview, Navigation Pane, Summary and Monitor (this post)
Users and Groups (coming soon)
Inventory (coming soon)
Settings (coming soon)
This blog assumes that the required infrastructure and prerequisites are in place to set up the VMware Horizon environment.
The Horizon Console is a web-based administration portal that allows you to configure your Horizon environment, create your virtual desktop and application pools, set the entitlements and monitor your sessions, plus much more. The Horizon Console is installed as part of the Horizon Connection Server, therefore there is no separate installer for it.
To get started, open your web browser and connect to your Horizon Connection Server’s URL’s admin page, for example https://<connection server name/admin.
Note: You can connect to any Horizon Connection Server URL that is in the same POD to get access to the Horizon Console. Any settings you make are automatically replicated to all the Connection Servers.
Once you log in, the default page displayed is the Dashboard screen as shown in Figure 1 below.
Figure 1: Dashboard
The dashboard provides an instant overview of the Horizon environment, showing information such as issues and number of sessions.
The Horizon Console consists of five (5) navigational sections as shown in Figure 2.
Figure 2: Navigational Menu
These sections are grouped to provide you with following settings and configuration of Horizon, as described in Table 1.
Table 1: Navigational Menu Summary
1. Summary Pane
The first part of the navigational menus provides a snapshot of the environment.
This counter provides the total of all sessions that are connected to the Horizon environment, irrespective if the session is active or not.
Both desktops and applications types contribute towards the session count. When you click on the number of sessions, you are redirected to Monitor > Sessions (All).
1.2 Problem vCenter VMs
The Problem vCenter VMs counter provides the total of all virtual desktops that are reporting an issue.
When you click on the number of Problem vCenter VMs, you are redirected to Inventory > Machines - vCenter (Problem Machines). In the example below, there is a VM reporting that the agent in unreachable and this is flagged as a problem VM.
1.3 Problem RDS Hosts
Just like the Problem vCenter VMs, this counter provides the number of RDS Hosts that are having an issue. When you click on the number of Problem RDS Hosts, you are redirected to Inventory > Machines – RDS Hosts (Problem Machines).
Events provides a summary of all triggered events within the Horizon environment. When you hover your mouse over the number count, a breakdown of the number of events is displayed showing alerts and errors, as shown below.
When you click on the number of Events, you are redirected to Monitor > Events.
1.5 System Health
Last but not least, the system health provides an overview of the health of the Horizon environment. When you hover your mouse over the number count, as shown below, a breakdown of the types of health and the counters for each is displayed.
When you click on the System Health count, you are redirected to Monitor > Dashboard.
This concludes the Summary pane options section. This pane is very useful to get a quick insight to your Horizon environment and provides relevant shortcuts to dig deeper in any problem areas.
The next navigation options we will look at is Monitor. As the name suggests, this section is where you can view information regarding the health, sessions and conduct some troubleshooting with the Help Desk tool.
Note: The Help Desk tool is only available with the Horizon Enterprise license or the Horizon Apps Advanced Editions license.
Whenever you log onto the Horizon Console, the default landing page is always the Dashboard view. Also, as stated previously, if you click on the System Health, you are redirected to the Dashboard page. The dashboard has three (3) specific views: System Health, Workload and Total Sessions, as shown below.
When an issue does occur, the System Health will show the component that has failed, as shown below.
2.1.1 System Health
This section focuses on any issues that are related to the Horizon management components.
When you click on the View link, the number of issues detected with various components that are used with Horizon is displayed.
A number of tabs for Horizon components are selectable to see their status.
The default view is on Connection Servers. This provides an overview of the health of all the Connection Servers in the POD. From this view, you can determine the Horizon Connection Server software version, whether the server as a valid TLS certificate and also how many connections that server is hosting plus much more.
When you select any of the Connection Servers, the View Services Status and the View Sessions Details tabs become available to select.
When you select View Services Status, you are shown the status of the gateway services that are running on the Connection Server.
Note: This does not provide a full list of all the Horizon services that are running on the Connection Server.
The View Sessions Detail tab provides you with the number of sessions that are using gateway and non-gateway services.
The next component is the Gateway.
A gateway can be any solution that allows Horizon traffic to pass through, typically used for external connections. Usually in VMware environments, this may be VMware Unified Access Gateway.
VMware Unified Access Gateway with Horizon Edge Services will be covered in the Expert competency.
The next tab is the Event Database. This provides health status regarding the database configured for Horizon Events.
Next, if you use View Composer Server in your environment to support Horizon Link Clone VMs, the health status for this server is displayed here.
The final component within this section is TrueSSO. TrueSSO integrates with VMware Workspace ONE Access to provide a single sign-on solution when accessing Horizon resources through the Workspace ONE portal. TrueSSO will be covered in the Expert competency.
22.214.171.124 RDS Farms
After Components, the system health status for RDS Farms is displayed. Information such as the type of farm deployed (automated or manual), number of RDS hosts within the farm and the total number of applications that are published within the farm.
The vSphere tab provides health status for; Datastores, ESXi Hosts and vCenter Servers that are used for Horizon.
The Datastores tab provides the following information:
Name (of the datastore)
vCenter Server managing the datastore
Path to the datastore
Capacity in GB
Used Spaced in GB
Free Space in GB
The ESX Hosts tab provides:
FQDN of the host
vCenter Server managing the host
Number of Horizon machines running on the host
vGPU information (if applicable)
The final tab, which is vCenter Servers, provides the following information:
Name (URL of vCenter Server)
vCenter Server version
TLS Certificate status
Use of View Composer Server
Number of desktop pools configured
Number of Horizon machines
126.96.36.199 Other Components
The Other Components section includes the following components:
The Domains tab provides the status of the domain that the Horizon Connection Server is a part of. As covered in my previous post, Basics zero to hero competency, there are different domain trust relationships that Horizon can support.
The SAML 2.0 tab provides information regarding the status of the SAML 2.0 authentication (if configured). Further details are covered in the upcoming Servers blog post as part of this series.
The License Service tab displays information regarding the Horizon license key.
The workload section provides a graphical representation of all the datastores available to Horizon. The View tab provides the exact same information as the Datastores tab under System Health > vSphere.
2.1.3 Total Sessions
This section provides a summary of all sessions that are either active, idle or disconnected. The View tab redirects you to Monitor > Sessions (all).
The Events tab displays all information about events that have occurred within the Horizon environment. The display lists the following columns:
The User column lists the username that the event is registered under. Some events do not have a user against them, but their actions are registered, for example:
The Severity column registers the type of event that has occurred. There are five (5) types of severity events that Horizon reports, they are as follows:
Audit Success - registers operations or configurations that complete successfully, for example:
Audit Failure - registers operations or configurations that fail to complete successfully, for example:
Error - registers operations that failed to complete by VMware Horizon.
Warning - registers operations or configurations that have been flagged with minor issues that require further investigation.
Info - registers normal operations, for example:
The Time column displays the timestamp of when the event occurred.
The Module column displays which component of Horizon the event is associated with. Typically, these will be from:
Vlsi (rated to REST API calls)
The Message column displays the information of the event. For example, the figure below shows the Info event with the message that the agent has contacted the Connection Server.
The Objects column displays information regarding the object that the event is associated with. For example, when you click on the three (3) dots in the objects field, the associated object(s) for that event are shown in a pop-up box.
You can set the time period for the events to show, by default the last 2 days are displayed, however you can change this by using the dropdown options. The time period to be shown are:
Last 2 days
You also have the ability to filter for key words to bring up events associated with the criteria. In the example below, I have filtered for my virtual desktops starting with std-win10 and the results are shown accordingly.
The Sessions menu provides a list of all sessions, whether in an active or disconnected state. From this page, the sessions can be controlled in many ways, such as:
Reset Virtual Machine
When you have many sessions connected, you can use the Filter to search for particular criteria to narrow the information displayed. Furthermore, you can use the dropdown selection for the Sessions to select the type of session you are looking for, as shown below.
2.4 Help Desk
The Help Desk tool is a powerful web application that allows you to conduct troubleshooting against a Horizon user session.
Note: The Help Desk tool is only available with the Horizon Enterprise Edition license or the Horizon Apps Advanced Edition license.
2.4.1 Search for the User
To begin with, use the User Search bar to enter the username of the user session that requires support. You can enter a partial name and hit enter to get a list of all entries that begin with that criteria, as shown below.
Select the user and you will be presented with information belonging to that user, as follows:
The Sessions tab provides the total number of sessions open by the user, including the information described in Table 2.
Table 2: Session Summary