Connection Quality Indicator

Connection Quality Indicator

In Citrix environment the published applications would be deployed across the network utilizing physical application servers and numerous workstations and connectivity can be reduced in session basis. Connection Quality Indicator tool provides feedback to the user when the network connectivity has been reduced to the point that the user’s experience is degraded. Displaying this information to the end user will improve overall user experience and users can know the status of the Citrix connection hence reduce the number of calls to help desks for network related user experience issues.


Notifications can be enabled and disabled using Group Policy settings. We can customize notification wording and user preferred notification window location using Group Policy settings. Under real time data users can check available bandwidth


XenApp and XenDesktop 7.7 and higher versions

Microsoft Windows 7 SP1or Windows Server 2008 R2 SP 1 or higher.

Microsoft .NET Framework 4.5.1

Citrix Virtual Delivery Agent 7.6.300 or higher must be installed.

Group Policy Configuration

It is recommended to use Windows Group Policy editor to configure CQI. CQI includes administrative templates files (CitrixCQI.admx CitrixCQI.adml) in the installation directory.

See below information on policy templates files and their respective location.

File Type Location

CitrixCQI.admx Configuration

CitrixCQI.adml Configuration[MUIculture]

CitrixBase.admx Configuration

CitrixBase.adml Configuration[MUIculture]

NOTE: You can use admx/adml template files to configure Local GPO and/or Domain-Based

To add the CitrixCQI.admx/adml template files to the local GPO

After installing Connection Quality Indicator, copy the template files.
From : ConfigurationCitrixCQI.admx
To : %systemroot%policyDefinitions

From : ConfigurationCitrixBase.admx
To : %systemroot%policyDefinitions

From: Configuration[MUIculture]CitrixCQI.adml
To: %systemroot%policyDefinitions[MUIculture]

From : Configuration[MUIculture]CitrixBase.adml
To : %systemroot%policyDefinitions[MUIculture]

CQI template files are available on local GPO “Administrative Templates > Citrix Components > Virtual Desktop Agent > CQI” folder when the user adds the CitrixBase.admx/CitrixBase.adml to the policyDefinitions folder.

Launching CQI on Session Startup

The CQI installer modifies the system in order to launch the tool automatically on session startup. Depending on the type of Virtual Delivery Agent, the method used to launch the tool can vary:

For Server OS Virtual Delivery Agents, the AppSetup registry value is modified and CQI’s Launcher.cmd script is appended to it. The location of the registry key containing this value is as follows:


For Desktop OS Virtual Delivery Agents, a value is added to the Run key which contains a path to CQI’s executable. The location of the registry key containing this value is as follows:


To ensure sessions are logged off properly, The LogoffCheckSysModules registry value is modified and CQI’s executable name is appended to it. The location of the registry key containing this value is as follows:


In order for CQI to be launched for Published applications hosted on Desktop OS Virtual Delivery Agent, the following policy must be applied to the VDA.

Create the user profile by first launching a full desktop session.

Start the Runonce.exe file together with the /AlternateShellStartup switch.

· In the server Group Policy Management Console, navigate to Local Computer Policy > User Configuration > Windows Settings.

· Click Scripts (Logon/Logoff), and then double-click Logon.

· Click Add.

· In the Script name box, type runonce.exe.

· In the Script parameters box, type /AlternateShellStartup.

· Click OK two times

If wfshell is not loaded, the default.profile is not created correctly. This behavior occurs because when the explorer shell is not loaded with the Run registry entry, the RunOnce registry entry and the startup applications are not loaded. If you start a published application which depends on wfshell, it might fail to load because of dependencies executed in the runonce command.


How to Use Connection Quality Indicator

CQI is launched on session startup and continues to run for the life of the session notifying the user of changes to network performance. Notifications are used by CQI to alert the user about network state.

There is a difference when end user interacts with CQI when using a Published Desktop or Application.

When using a Published Desktop, CQI notifications are displayed in two different areas, system tray and standard notifications.

For Published Applications, since there’s no desktop, only standard notifications are shown. If more than one Published Application is in use within the same session, only the foreground application will display the notification.

We can access the Options Panel by clicking on the gear located upper right hand corner of the Notification window, We can snooze notifications for a predetermined amount of time or to reposition notifications to another area of the screen. When snooze is selected, the timer chosen by the user is highlighted in green as shown below. Once the timer has expired, standard notifications will be shown on the next state change. The user can also access the last notification by clicking on the CQI system tray icon for Published Desktops or by using the hot key combination Ctrl+Alt+H for Published Applications. Notifications accessed by the user using these methods will remain visible until explicitly closed.

The position setting can be used to move the notification display area in the screen. Selection of a new notification position takes effect on the next state change or if the user closes the current notification and opens the last notification manually by clicking on the system tray icon (Published Desktop) or hot key combination Ctrl+Alt+H (Published Applications). The user selection is retained by CQI per session type.

Options Panel

System Tray Icon

Notifications are shown to the user and remain visible for a predefined interval when a degraded network condition has been present for a prolonged period of time. Short lived degraded network conditions, although detected by the tool, will not trigger notifications. This behavior is by design and prevents the tool from over notifying the user.

How CQI Uses Counters

CQI uses three counters to monitor the connection quality between an endpoint and the VDA. Each counter contains a low and high threshold that the tool uses to determine which type of notification to display. The counters used by CQI and displayed in the Options Panel under “Real Time Data” section are:

Available bandwidth – Reports how much bandwidth is available for a session to use. CQI monitors this counter to determine if the amount of available bandwidth has fallen, as this may indicate a change in network conditions between an endpoint and the VDA.

Latency – A calculation by the VDA that allows CQI to understand network conditions between an endpoint and the VDA. Unlike ICA Round Trip (ICA Rdtrp), Latency measurements are passive and rely on input activity from the endpoint. As a result, Latency times could be lower than ICA Round Trip (ICA Rdtrp) in some cases, such as variable networks.

ICA Round Trip (ICA Rdtrp) – An active check by the endpoint that allows CQI to understand the screen response time to user input into the session. Unlike Latency, an Administrator can determine how often ICA Round Trip checks are performed by modifying “ICA round trip calculation interval” policy in Studio, default is 15 seconds. ICA Round Trip times tend to be higher than Latency since they also take into consideration processing of user activity on both the VDA and endpoint. For ICA Round Trip calculations to take place, the version of Citrix Receiver on the endpoint must support EUEM (End User Experience Monitoring).


CQI utilizes two logging options, a plain text file maintained per user session and Windows Event Log shared across all user sessions running on VDA.

The plain text log is named Citrix.CQI.log and stored in the temp directory, %temp%CitrixCQI. Application also maintains a single archived log file named Citrix.CQI.{YYYY-MM-DD_HH-MM-SS}.0.log in the same location. Log file size limit is 5 MB.

The same logging information is written to Windows Event log. There are two event log channels, Admin and Debug. To see Debug channel, ensure “Show Analytic and Debug Logs” option is enabled.

The CQI logs can be found under Application and Services LogsCitrixVDACQI directory within Event Viewer application:

Event logs combines messages from all user sessions on VDA.

· Admin channel contains only critical messages, error / warnings.

· Debug channel contains same information as file logs.


About Murugan B Iyyappan

Working as a Consultant - Citrix solutions architect with 18 years of experience in the IT industry. Expertise in Citrix products and Windows platform.
This entry was posted in Citrix XenApp, Citrix XenDesktop. Bookmark the permalink.