HDX Gateways Test

Multiple ADM appliances may be configured in an environment for the purpose of load-balancing. By tracking the ICA sessions and applications launched via every ADM appliance, administrators can effortlessly determine whether/not load is uniformly distributed across the appliances. This is what the HDX Gateways test helps administrators achieve. This test auto-discovers the ADM appliances configured in an environment and measures the session and application load handled by each appliance. In the process, the test indicates how effective the load-balancing algorithm is and whether/not it needs to be tweaked.


This test will not report metrics for a Citrix ADM HDX Insight component that is of v10.5 (or above).

Target of the test : Citrix ADM HDX Insight

Agent deploying the test : A remote agent

Outputs of the test : One set of results for every ADM appliance configured in the environment

Parameter Description

Test period

How often should the test be executed. It is recommended that you set the test period to5 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.


The host for which the test is to be configured.

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.


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.

DD Frequency

Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD Frequency.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Total session launches

Indicates the total number of unique user sessions handled by this ADM appliance.


Compare the value of this measure across ADMs to know which ADM is overloaded with sessions.

Use the detailed diagnosis of this measure to know the name and IP address of each ADM appliance configured in the environment and the count of unique sessions and applications that were launched through each.

Total applications

Indicates the total number of unique applications launched via this ADM appliance.


Compare the value of this measure across ADMs to know which ADM was used to launch most of the applications.