Add CVAD Integration

This article covers how to configure a CVAD connection and monitor your CVAD components with ControlUp.

Data Collector

We strongly recommend that you use a dedicated data collector for all EUC environment connections. A data collector can be any machine that has the ControlUp Agent installed. To learn more, visit ControlUp Data Collector.

Prerequisites

Component Requirements

• Citrix Virtual Desktops (XenDesktop) 7.5 or higher
• Citrix Virtual Desktops (XenDesktop) PowerShell SDK installed on Monitor machines, Data Collector machines, and all machines running the Real-Time Console. You can download the necessary Snap-ins 7.9 here. Alternatively, install Citrix Studio to automatically install the Citrix Virtual Desktops (XenDesktop) PowerShell SDK. We require the following PowerShell SDK Snap-ins:
  • AD Identity
  • Broker
  • Configuration
  • Configuration Logging
  • Delegated Admin
  • Host
  • Machine Creation Services
  • Monitor

Network Requirements

Enable TCP port 80/443 (HTTP/S) from all Real-Time Console machines, Monitor machines, and Data Collector machines to the Citrix Virtual Desktops (XenDesktop) Broker.

Service Account Requirements

The Read Only Administrator right to all managed farms is sufficient for all monitoring purposes. If you want to perform built-in CVAD management actions, then the service account needs the following permissions:

• Edit Application Group Policies
• Edit Application Properties (Application Group)
• Edit Delivery Group Properties
• Edit Machine Catalog Properties

Add your credentials to your shared credentials before you add the CVAD integration.

Data Collector Requirements

The data collector machine must have the CVAD PowerShell SDK installed. See Component Requirements above for details.

Add a CVAD Connection to ControlUp

To add a CVAD connection in your ControlUp environment, perform the following steps:

1. In the Real-Time Console, go to Home > Add EUC Environment to open the Add EUC Environment Connection window.
   
2.  Set the Solution / Platform to Citrix Virtual Apps and Desktops.
    
3. Enter the Broker Name / IP (FQDN, hostname, or IP address) of your CVAD Broker site.
4. Optionally, change the Port used to communicate to the Broker. The default port is 80.
5. Select Credentials for your CVAD environment from your shared credentials. The required permissions for the credentials are described above. You should have added these credentials as shared credentials in your Monitor Settings.
6. Expand the Data Collectors tab to configure a data collector for the CVAD connection.
   
   1. Select the default data collector and click Remove.
      
   2. Click Add and select the machine that you want to use as a data collector.
   3. Optionally, add another machine to use as a backup data collector in case the primary data collector is down. Note that the first machine in the list is the primary data collector.
7. Click OK to save the CVAD connection.

After ControlUp connects to your CVAD site, the Site Name field automatically populates, and the Brokers Failover List tab contains the names of all the Broker servers assigned to the CVAD site.

CVAD Monitoring

After you add a CVAD connection, ControlUp discovers Virtual Desktop Agents (VDAs), delivery groups, and brokers associated with your CVAD environment. In the Real-Time Console, you can see:

• VDAs and brokers in the Machines view.
• Open sessions on the VDAs or broker in the Sessions view.
• Running processes of open sessions in the Processes view.
• Information about published applications in the Applications view.

Resources monitored with ControlUp will be enriched with CVAD-related metrics and metadata. For example, the Machines view has the column CVAD Machine Availability to show if VDAs are accessible by users, and the Sessions view has the column CVAD Launched Via HostName to show the name of the StoreFront server used to launch each session.

The CVAD site appears in the organization tree under EUC Environments. You can see the delivery groups and brokers under the CVAD site. Select one of these folders to show information relevant to only that folder.

For a reference of the CVAD information you can monitor, visit CVAD Integration: Columns & Grids Overview.

To monitor performance metrics of your VDAs and broker machines, you can install the ControlUp Agent on these machines.

Monitor Broker Health

You can monitor the health of each broker in the CVAD site.

The CVAD Broker Health column is based on a list of services, databases, and hypervisors. If all of these are running and available, the broker's health is 100%. The health percentage decreases if some parameters are not healthy.

Each of the parameters that the calculation is based on can be excluded from the registry (by default the % hypervisors available is excluded).

The CVAD site itself shows an aggregated calculation of how many % of brokers are 100% healthy.