Product Documentation

Troubleshoot machines

May 22, 2017

In the Filters > Machines view, select Desktop OS Machines or Server OS Machines to see the machines configured in the Site. The Server OS Machines tab includes the load evaluator index , which indicates the distribution of performance counters and tool tips of the session count if you hover over the link.

Click the Failure Reason of a failed machine to get a detailed description of the failure and actions recommended to troubleshoot the failure. The failure reasons and the recommended actions for machine and connection failures are available in the Citrix Director 7.12 Failure Reasons Troubleshooting Guide.

Click the machine name link to go to the Machine Details page. The Machine Details page lists the machine details, infrastructure details, and details of the hotfixes applied on the machine. The Machine Utilization panel displays the machine utilization graphs.

Machine-based real-time resource utilization

The Machine Utilization panel displays graphs showing real-time utilization of CPU and memory . In addition, disk and GPU monitoring graphs are available for Sites with Delivery Controller(s) and VDA versions 7.14 or later.

Disk monitoring graphs, average IOPS, and disk latency are important performance measurements that help you monitor and troubleshoot issues related to VDA disks. The Average IOPS graph displays the average number of reads and writes to a disk. Select Disk Latency to see a graph of the delay between a request for data and its return from the disk, measured in milliseconds.

localized image

Select GPU Utilization to see percentage utilization of the GPU, the GPU memory, and of the Encoder and the Decoder to troubleshoot GPU-related issues on Server or Desktop OS VDAs. The GPU Utilization graphs are available only for VDAs running 64-bit Windows with NVIDIA Tesla M60 GPUs, and running Display Driver version 369.17 or later.
The VDAs must have HDX 3D Pro enabled to provide GPU acceleration. For more information, see GPU acceleration for Windows Desktop OS and GPU acceleration for Windows Server OS.
When a VDA accesses more than one GPU, the utilization graph displays the average of the GPU metrics collected from the individual GPUs. The GPU metrics are collected for the entire VDA and not for individual processes.

Machine-based historical resource utilization

In the Machine Utilization panel, click View Historical Utilization to view the historical usage of resources on the selected machine.
The utilization graphs include critical performance counters of CPU, memory, peak concurrent sessions, average IOPS, and disk latency.

Note: The Monitoring policy setting, Enable Process Monitoring, must be set to Allowed to collect and display data in the Top 10 Processes table on the Historic Machine Utilization page. The collection is prohibited by default.

The CPU and memory utilization, average IOPS, and disk latency data is collected by default. You can disable the collection by using the Enable Resource Monitoring policy setting.

localized image

1. From the Machine Utilization panel in the Machine Details view, select View Historical Utilization. This opens the Historical Machine Utilization page.

2. Set Time Period to view usage for the last 2 hours, 24 hours, 7 days, month, or year.
Note: Average IOPS and disk latency usage data are available only for the last 24 hours, month, and year ending now. Custom end time is not supported.

3. Click Apply and select the required graphs.

4. Hover over different sections of the graph to view more information for the selected time period.

localized image

For example, if you select Last 2 hours, the baseline period is the 2 hours prior to the selected time range. View the CPU, memory, and session trend over the last 2 hours and the baseline time.
If you select Last month, the baseline period is the previous month. Select to view the Average IOPS and disk latency over the last month and the baseline time.

5. Click Export to export the resource utilization data for the selected period. For more information, see Export reports section in Monitor Deployments.

6. Below the graphs, the table lists the top 10 processes based on CPU or memory utilization. You can sort by any of the columns, which show Application Name, User Name, Session ID, Average CPU, Peak CPU, Average Memory, and Peak Memory over the selected time range. The IOPS and Disk Latency columns cannot be sorted.

Note: The session ID for system processes is displayed as "0000".

7. To view the historical trend on the resource consumption of a particular process, drill into any of the Top 10 processes.