Troubleshooting the Horizon 7 Environment

You can use a variety of procedures for diagnosing and fixing problems that you might encounter when using Horizon 7. You can use Horizon Help Desk Tool for troubleshooting, use other troubleshooting procedures to investigate and correct problems, or obtain assistance from VMware Technical Support.

VMware has a number of tools available to assist in troubleshooting and we will cover a few in the coming lessons.

  • vRealize Operations for Horizon - end to end visibility in the Health of the Horizon environment.
  • Use Horizon Help Desk Tool - this will be discussed shortly. It is a Web application that you can use to get the status of Horizon 7 user sessions and to perform troubleshooting and maintenance operations
  • Use the VMware Logon Monitor - monitors Windows user logons and reports performance metrics intended to help administrators, support staff, and developers to troubleshoot slow logon performance.
  • Use VMware Horizon Performance Tracker - This will be discussed shortly. It is a utility that runs in a remote desktop and monitors the performance of the display protocol and system resource usage. You can also create an application pool and run Horizon Performance Tracker as a published application.
  • Monitor System Health - This will be discussed shortly. Lets you see quickly any problems that might affect the operation of Horizon 7.
  • Monitor Events in Horizon 7 - events database stores info about events that occur in the connection server host or group, Horizon agent, and horizon administrator.
  • VMware Knowledge base articles

Identifying the Problem Domain

Architectural view of environment.

Common Issues Encountered around Certificates

We will not be covering this in the lab so please reference this document for more information.

  1. Configuring Certificates for Horizon
  2. Troubleshooting Certificates for Horizon 7

Troubleshooting using vRealize Operations for Horizon

VMware vRealize Operations for Horizon provides end-to-end visibility into the health, performance, and efficiency of VMware and Citrix virtual desktop and application environments from the data center and the network, all the way through to devices. It enables desktop administrators to proactively optimize end-user experience, avert incidents, and eliminate bottlenecks. Designed for VMware Horizon and Citrix XenApp and XenDesktop environments, along with NVIDIA GRID powered desktops, vRealize Operations for Horizon reduces costs and expedites time to resolution (TTR) with in-depth monitoring.

vRealize Operations for Horizon provides a single console for administrators with applications and desktop performance metrics and usage insights. The fully customizable dashboards automatically track detailed health of your end user computing deployment, from virtual applications and desktop down to the underlying vSphere infrastructure.

Quickly find and troubleshoot problems across your end user computing environment with in-guest metrics that analyze user and session-centric metrics, including CPU/RAM/disk utilization, logon times, PCoIP and Blast protocol performance and application experience. Easily isolate system weaknesses and proactively optimize performance.

Automatically learn normal operating patterns for Horizon infrastructure and user workloads. Leverage these analytics to set alerts based on dynamic rather than hard thresholds to catch system deficiencies while minimizing false positives. Receive advanced notifications before events impact end users to proactively manage your environment. Take advantage of user-centric dashboards and out-of-the box usage and license-compliance reports, and easily remediate your environment with common commands.

Horizon Connection Server Log Files

As your Horizon deployment grows, the list of logs that may need to be collected for troubleshooting can be extensive as each of these technologies has a logging component.

Horizon 7 creates log files that record the installation and operation of its components.  The Connection Broker logs are located at C:\ProgramData\VMware\VDM\logs

Reference these KB articles that will help you navigate where the logs are and how to change the log levels when you need to debug.  

  • KB1017939 : collecting log locations and diagnostic info
  • KB1025887 : changing log levels

Open Google Chrome Browser

Click on the Main Console Desktop and open the Google Chrome Browser

Open vCenter Server

  1. Click on the vCenter favorites on the Bookmark bar
  2. Select the RegionA vSphere Client (HTML) to connect to the vCenter Server
  3. Click on Use Windows session authentication
  4. Click on Login

Open Connection Server

Open a Remote Console to the Horizon Connection Server

  1. Click on arrow to open the RegionA01-COMP01
  2. Right Click on the Horizon-01 Connection Server
  3. Select Open Remote Console

Note: Horizon-01 is located under RegionA01-COMP01 and not RegionA01-IC01

Sign in to the Connection Server

  1. Click on the Ctrl-alt-del icon at the top of the window to login
  2. Enter the password for the CORP\administrator: VMware1!
  3. Click the arrow to continue

Connection Broker Logs

Make sure you are on the Horizon-01 Remote Console screen. You may want to click on the Minimize button at the top right of the window so it is not in maximum full screen mode. Confirm desktop says Horizon-01

  1. Open Explorer from bottom toolbar
  2. Enter C:\ProgramData\VMware\VDM\logs into the box to see the logs

We will just observe that this is where the logs are located.

Close the connect to Horizon-01

  1. Click on the VMRC pulldown in the top left corner of the window
  2. Click on Exit

Desktop Performance Issues

Some common issues are with Storage I/O bottleneck, CPU or memory contention, and Network Issues. To troubleshoot look at vCenter Server, vRealize Operations for Horizon, ESXTOP and other 3rd party tools to help.


Add your comment

E-Mail me when someone replies to this comment

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.