• Surj Randhawa

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.

Horizon Console

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.

1.1 Sessions









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 > MachinesRDS Hosts (Problem Machines).


1.4 Events






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.

2. Monitor








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.

2.1 Dashboard








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.

2.1.1.1 Components















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.

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


2.1.1.3 vSphere















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:

  • Status

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

  • Status

  • FQDN of the host

  • ESXi version

  • vCenter Server managing the host

  • Cluster name

  • Number of Horizon machines running on the host

  • vGPU information (if applicable)

The final tab, which is vCenter Servers, provides the following information:

  • Status

  • 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

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


2.1.2 Workload

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


2.2 Events










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)

  • Agent

  • Connection Server

  • Client

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

  • Last week

  • Last month

  • All








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.


2.3 Sessions

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:

  • Disconnect Session

  • Logoff Session

  • Restart Desktop

  • Reset Virtual Machine

  • Send Message

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:


2.4.1.1 Sessions


The Sessions tab provides the total number of sessions open by the user, including the information described in Table 2.

Table 2: Session Summary

2.4.1.2 Desktops