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
Common Issues Encountered around Certificates
We will not be covering this in the lab so please reference this document for more information.
- Configuring Certificates for Horizon https://docs.vmware.com/en/VMware-Horizon-7/7.9/horizon-installation/GUID-80CC770D-327E-4A21-B382-786621B23C44.html
- Troubleshooting Certificates for Horizon 7 https://docs.vmware.com/en/VMware-Horizon-7/7.9/horizon-installation/GUID-1AB8E13E-B82F-4671-A80C-91BD4C5EA7C6.html
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.
Open Google Chrome Browser
Click on the Main Console Desktop and open the Google Chrome Browser
Open vCenter Server
- Click on the vCenter favorites on the Bookmark bar
- Select the RegionA vSphere Client (HTML) to connect to the vCenter Server
- Click on Use Windows session authentication
- Click on Login
Open Connection Server
Open a Remote Console to the Horizon Connection Server
- Click on arrow to open the RegionA01-COMP01
- Right Click on the Horizon-01 Connection Server
- Select Open Remote Console
Note: Horizon-01 is located under RegionA01-COMP01 and not RegionA01-IC01
Sign in to the Connection Server
- Click on the Ctrl-alt-del icon at the top of the window to login
- Enter the password for the CORP\administrator: VMware1!
- 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
- Open Explorer from bottom toolbar
- 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
- Click on the VMRC pulldown in the top left corner of the window
- 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.