Product Documentation

Surveiller les déploiements

Nov 21, 2016

With full administrator permissions, when you open Director, the Dashboard provides a centralized location to monitor the health and usage of a site.

If there are currently no failures and no failures have occurred in the past 60 minutes, panels stay collapsed. When there are failures, the specific failure panel automatically appears.

Note: Depending on your organization's license and your Administrator privileges, some options or features might not be available.
Panel Description
User Connection Failures Connection failures over the last 60 minutes. Click the categories next to the total number to view metrics for that type of failure. In the adjacent table, that number is broken out by Delivery Groups.
Failed Desktop OS Machines or Failed Server OS Machines Total failures in the last 60 minutes broken out by Delivery Groups. Failures broken out by types, including failed to start, stuck on boot, and unregistered. For Server OS machines, failures also include machines reaching maximum load.
Licensing Status
  • License Server alerts are sent by the License Server and also display the actions required to resolve the alert.
  • Delivery Controller alerts display the details of the licensing state as seen by the controller and are sent by the Delivery Controller.

You can set the threshold for alerts in Studio.

License Server and/or Delivery Controller alerts do not display if your License Server version is earlier than 11.12.1 and/or your Delivery Controller is older than XenApp 7.6 or XenDesktop 7.6.

Sessions Connected Connected sessions across all Delivery Groups for the last 60 minutes.
Average Logon Duration Logon data for the last 60 minutes. The large number on the left is the average logon duration across the hour.

Logon data for VDAs earlier than XenDesktop 7.0 is not included in this average.

Infrastructure Health status of your site's hosts, controllers. and infrastructure. View performance alerts.

For hosts, the connection status and the health of the CPU, memory, bandwidth (network usage), and storage (disk usage) are monitored using information from XenServer or VMware.

For example, you can configure XenCenter to generate performance alerts when CPU, network I/O or disk I/O usage go over a specified threshold on a managed server or virtual machine. By default, the alert repeat interval is 60 minutes, but you can configure this as well. For details, in the XenServer documentation, see Configuring Performance Alerts.

Note: If no icon appears for a particular metric, this indicates that this metric is not supported by the type of host you are using. For example, no health information is available for System Center Virtual Machine Manager (SCVMM) hosts, AWS and CloudStack.

Continue to troubleshoot issues using these options (which are documented below):

  • Control user machine power

  • Prevent connections to machines

Monitor sessions

If a session becomes disconnected, it is still active and its applications continue to run, but the user device is no longer communicating with the server.

Action Description
View a user's currently connected machine or session From the Activity Manager and User Details views, view the user's currently connected machine or session and a list of all machines and sessions to which this user has access. To access this list, click the session switcher icon in the user title bar. See Restore sessions.
View the total number of connected sessions across all Delivery Groups From the Dashboard, in the Sessions Connected pane, view the total number of connected sessions across all Delivery Groups for the last 60 minutes. Then click the large total number, which opens the Filters view, where you can display graphical session data based on selected Delivery Groups and ranges and usage across Delivery Groups.
View data over a longer period of time On the Trends view, select the Sessions tab to drill down to more specific usage data for connected and disconnected sessions over a longer period of time (that is, session totals from earlier than the last 60 minutes). To view this information, click View historical trends.
Note: If the user device is running a legacy Virtual Delivery Agents (VDA), such as a VDA earlier than version 7, Director cannot display complete information about the session. Instead, it displays a message that the information is not available in the User Details view and Activity Manager panel.

Filter data to troubleshoot failures

When you click numbers on the Dashboard or select a predefined filter from the Filter menu, the Filter view opens to display the data based on the selected machine or failure type.

Predefined filters cannot be edited, but you can save a predefined filter as a custom filter and then modify it. Additionally, you can create custom filtered views of machines, connections, and sessions across all Delivery Groups.

  1. Select a view:
    • Machines — Select Desktop OS Machines or Server OS Machines. These views show the number of configured machines. The Server OS Machines tab also 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.
    • Sessions — You can also see the session count from the Machines view.
    • Connections — Filter connections by different time periods, including last 60 minutes, last 24 hours, or last 7 days.
  2. For Failure by, select the criteria.
  3. Use the additional tabs for each view, as needed, to complete the filter.
  4. Select additional columns, as needed, to troubleshoot further.
  5. Save and name your filter.

    To open filter later, from the Filter menu, select the failure type (Machines, Sessions, or Connections), and then select the saved filter.

  6. If needed, for Machines or Connections views, use power controls for all the machines you select in the filtered list. The failure reasons and recommended actions for the Machine and Connection failures are available in Citrix Director 7.6 Failure Reasons Troubleshooting Guide.
  7. For the Sessions view, use the session controls or option to send messages.

Continue to troubleshoot issues using these options (which are documented below):

  • Control user machine power

  • Prevent connections to machines

Monitor historical trends across a site - Feature Pack 1

The Trends view accesses historical trend information for sessions, connection failures, machine failures, logon performance, and load evaluation for each site. To locate this information, click from the Dashboard or Filters view, click Trends.

The zoom-in drilldown feature lets you navigate through trend charts by zooming in on a time period (clicking on a data point in the graph) and drilling down to see the details associated with the trend. This feature enables you to better understand the details of who or what has been affected by the trends being displayed.

To change the default scope of each graph, apply a different filter to the data.

Action

Description

Export graph data

Select the tab containing the data to export. Click Export and select the file format: PDF, Excel, or CSV.

View trends for sessions

From the Sessions tab, select the Delivery Group and time period to view more detailed information about the concurrent session count.

View trends for connection failures

From the Connection Failures tab, select the machine type, failure type, Delivery Group, and time period to view a graph containing more detailed information about the user connection failures across your site.

View trends for machine failures

From the Desktop OS Machine Failures tab or Server OS Machines tab, select the failure type, Delivery Group, and time period to view a graph containing more detailed information about the machine failures across your site.

View trends for logon performance

From the Logon Performance tab, select the Delivery Group and time period to view a graph containing more detailed information about the duration of user logon times across your site and whether the number of logons affects the performance. This view also shows the average duration of the logon phases, such as brokering duration, VM start time, and so on.

This data is specifically for user logons and does not include users trying to reconnect from disconnected sessions.

View trends for load evaluation

From the Load Evaluator Index tab, view a graph containing more detailed information about the load that is distributed among Server OS machines. The filter options for this graph include the Delivery Group or Server OS machine in a Delivery Group, Server OS machine (available only if Server OS machine in a Delivery Group was selected), and range.

View hosted applications usage

The availability of this feature depends on your organization's license.

From the Hosted Applications Usage tab, select the Delivery Group and time period to view a graph displaying peak concurrent usage and a table displaying application based usage. From the Application Based Usage table, you can choose a specific application to see details and a list of users who are using, or have used, the application.

View virtual machine usage

From the Machine Usage tab, select Desktop OS Machines or Server OS Machines to obtain real-time view of your VM usage, enabling you to quickly assess your site’s capacity needs.

Desktop OS availability — displays the current state of Desktop OS machines (VDIs) by availability for the entire site or specific Delivery Group.

Server OS availability — displays the current state of Server OS machines by availability for the entire site or specific Delivery Group.

View network analysis data using HDX Insight

The availability of this feature depends on your organization's license and your administrator permissions.

From the Network tab, monitor your network analysis, which provides a user, application, and desktop contextual view of the network. With this feature, Director provides advanced analytics of ICA traffic in your deployment.

The flag icons on the graph indicate significant events or actions for that specific time range. Hover the mouse over the flag and click to list events or actions.

Note: 

  • HDX connection logon data is not collected for VDAs earlier than 7. For earlier VDAs, the chart data is displayed as 0.
  • Sessions, failures and logon performance trend information is available as graphs and tables when time period is set to Last month or shorter. When time period is set to Last Year, the trend information is available as graphs but not as tables.
  • Export of large data in Director can timeout or produce an unexpected error. This can typically happen when the site monitored by Director has a large number of configured sessions and the data requested for export exceeds 500K rows.

Continue to troubleshoot issues using these options (which are documented below):

  • Control user machine power
  • Prevent connections to machines

Monitor historical trends across a site -  XenApp 7.6 and XenDesktop 7.6

The Trends view accesses historical trend information for sessions, connection failures, machine failures, logon performance, and load evaluation for each site. To locate this information, click from the Dashboard or Filters view, click Trends.

To change the default scope of each graph, apply a different filter to the data.

Action Description
Export graph data Select the tab containing the data to export. Click Export and select the file format: PDF or CSV.
View trends for sessions From the Sessions tab, select the Delivery Group and time period to view more detailed information about the concurrent session count.
View trends for connection failures From the Connection Failures tab, select the machine type, failure type, Delivery Group, and time period to view a graph containing more detailed information about the user connection failures across your site.
View trends for machine failures From the Desktop OS Machine Failures tab or Server OS Machines tab, select the failure type, Delivery Group, and time period to view a graph containing more detailed information about the machine failures across your site.
View trends for logon performance From the Logon Performance tab, select the Delivery Group and time period to view a graph containing more detailed information about the duration of user logon times across your site and whether the number of logons affects the performance. This view also shows the average duration of the logon phases, such as brokering duration, VM start time, and so on.

This data is specifically for user logons and does not include users trying to reconnect from disconnected sessions.

View trends for load evaluation From the Load Evaluator Index tab, view a graph containing more detailed information about the load that is distributed among Server OS machines. The filter options for this graph include the Delivery Group or Server OS machine in a Delivery Group, Server OS machine (available only if Server OS machine in a Delivery Group was selected), and range.
View hosted applications usage The availability of this feature depends on your organization's license.

From the Hosted Applications Usage tab, select the Delivery Group and time period to view a graph displaying peak concurrent usage and a table displaying application based usage. From the Application Based Usage table, you can choose a specific application to see details and a list of users who are using, or have used, the application.

View network analysis data using HDX Insight The availability of this feature depends on your organization's license and your administrator permissions.

From the Network tab, monitor your network analysis, which provides a user, application, and desktop contextual view of the network. With this feature, Director provides advanced analytics of ICA traffic in your deployment.

The flag icons on the graph indicate significant events or actions for that specific time range. Hover the mouse over the flag and click to list events or actions.

Note: 

  • HDX connection logon data is not collected for VDAs earlier than 7. For earlier VDAs, the chart data is displayed as 0.
  • Sessions, failures and logon performance trend information is available as graphs and tables when the time period is set to Last month or shorter. When the time period is set to Last Year, the trend information is available as graphs but not as tables.
  • Export of large data in Director can time out or produce an unexpected error. This can typically happen when the site monitored by Director has a large number of configured sessions and the data requested for export exceeds 500K rows.

Continue to troubleshoot issues using these options (which are documented below):

  • Control user machine power

  • Prevent connections to machines

Monitor hotfixes

To view the hotfixes installed on a specific machine VDA (physical or VM), choose the Machine Details view.

Control user machine power states

To control the state of the machines that you select in Director, use the Power Control options. These options are available for Desktop OS machines, but might not be available for Server OS machines.

Note: This functionality is not available for physical machines or machines using Remote PC Access.
Command Function
Restart Performs an orderly (soft) shutdown of the VM. and all running processes are halted individually before restarting the VM. For example, select machines that appear in Director as "failed to start," and use this command to restart them.
Force Restart Restarts the VM without first performing any shut-down procedure. This command works in the same way as unplugging a physical server and then plugging it back in and turning it back on.
Shut Down Performs an orderly (soft) shutdown of the VM; all running processes are halted individually.
Force Shutdown Shuts down the VM without first performing any shut-down procedure. This command works in the same way as unplugging a physical server. It may not always shut down all running processes, and you risk losing data if you shut down a VM in this way.
Suspend Suspends a running VM in its current state and stores that state in a file on the default storage repository. This option allows you to shut down the VM's host server and later, after rebooting it, resume the VM, returning it to its original running state.
Resume Resumes a suspended VM and restores its original running state.
Start Starts a VM when it is off (also called a cold start).

If power control actions fail, hover the mouse over the alert, and a pop-up message appears with details about the failure.

Prevent connections to machines

Use maintenance mode to prevent new connections temporarily while the appropriate administrator performs maintenance tasks on the image.

When you enable maintenance mode on machines, no new connections are allowed until you disable it. If users are currently logged on, maintenance mode takes effect as soon as all users are logged off. For users who do not log off, send a message informing them that machines will be shut down at a certain time, and use the power controls to force the machines to shut down.

  1. Select the machine, such as from the User Details view, or a group of machines in the Filters view.
  2. Select Maintenance Mode, and turn on the option.

If a user tries to connect to an assigned desktop while it is in maintenance mode, a message appears indicating that the desktop is currently unavailable. No new connections can be made until you disable maintenance mode.