HDX User Agents Test

Users can connect to applications/virtual desktops using may client devices – the ICA client, web browsers, mobile phones, tablets, etc. Each such client device is called a user agent. Users using certain types of client devices/user agents may be engaged in bandwidth-intensive communication over ICA, scarring the experience of other users to the XenApp/XenDesktop environment. To capture such problem conditions quickly, it would be best to know what types of client devices users are connecting from and how much bandwidth each of these device types are currently consuming. This is exactly what the HDX User Agents test reveals! This test auto-discovers the types of client devices that are interacting with the applications/virtual desktops, and reports the bandwidth usage of each device type. This way, the test leads administrators to those device types that are consuming bandwidth excessively.

Target of the test : Citrix NetScaler HDX Insight

Agent deploying the test : A remote agent

Outputs of the test : One set of results for each type of client device/user agent users are connecting from

Configurable parameters for the test
  1. Test period - How often should the test be executed. It is recommended that you set the test period to 5 minutes. This is because, the Nitro API using which the eG agent collects metrics from HDX Insight, is capable of capturing only the performance data related to the last 5 minutes.
  2. Host - The host for which the test is to be configured.
  3. insight username,insight password, and confirm password -  To connect to HDX Insight and collect the metrics it captures, the eG agent needs to be configured with the credentials of a user with read-only permissions to HDX Insight. Type the name of this user against insight username and the password of this user against insight password. Then, confirm the password by retyping it in the confirm password text box.
  4. ssl – By default, HDX Insight is not SSL-enabled. This is why, this flag is set to No by default. If it is SSL-enabled, then change this flag to Yes.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Avg bandwidth:

Indicates the rate at which data is transferred over the ICA sessions launched from this device type.


Ideally, the value of this measure should be low.

A high value indicates excessive bandwidth usage by users connecting from the device type.

Compare the value of this measure across device types to know users using which type of device are engaged in bandwidth-intensive communication over ICA. 

Bandwidth consumed in the last measure period:

Indicates the amount of data (in MB) transferred to / received from this device type during the last measurement period.


A consistent increase in the value of this measure over time is indicative of excessive bandwidth usage by a device type.