Citrix XA Application Launches Test

To know which published applications on the XeAnApp server are currently accessed by users and how many instances of each application have been launched presently, use the Citrix XA Application Launches test. Detailed diagnostics, if enabled, reveal the users accessing the published applications and the thin clients from which the users are connecting to the Virtual Apps server.

This test is disabled by default. To enable the test, go to the enable / disable tests page using the menu sequence : Agents -> Tests -> Enable/Disable, pick the desired Component type, set Performance as the Test type, choose the test from the disabled tests list, and click on the < button to move the test to the ENABLED TESTS list. Finally, click the Update button.

Target of the test : Any Citrix server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every ‘published application’ on the Virtual Apps server that is currently launched

Configurable parameters for the test
  1. TEST PERIOD – How often should the test be executed
  2. Host – The host for which the test is to be configured
  3. Port Refers to the port used by the Citrix server
  4. domain name, domain user, domain password, and confirm password – A Citrix Virtual Apps server (v6.5) can run in the controller mode or the worker mode. In the controller mode, the Virtual Apps server can perform all farm management tasks. However, in the worker mode, a Virtual Apps server can only host user sessions.

    By default, the domain name, domain user, domain password, and confirm password parameters are set to none. If the Virtual Apps server being monitored is the controller in a farm, then this default value will automatically apply. In other words, in this case, you can leave the values of these parameters as none. On the other hand, if the target Virtual Apps server is a worker in the farm, then first, you will have to configure the name of the domain in which the Virtual Apps server operates in the domain name text box. Then, you need to configure the test with the credentials of a user with Citrix Farm Administrator rights, using the domain user and domain password text boxes. Finally, you will have to confirm the domain password by retyping it in the confirm password text box.


    If the Virtual Apps server is a worker in the farm, then, in addition to configuring the domain name, domain user, domain password parameters, the following pre-requisites should also be fulfilled for this test to report metrics:

    • Make sure that the Citrix Virtual Apps Commands Remoting service is running in the Controller server.
    • The port 2513 must be open on the Controller server in the farm.

  1. report by domain name – By default, this flag is set to Yes. This implies that by default, the detailed diagnosis of this test will display the domainname\username of each user who logged into the Citrix server. This way, administrators will be able to quickly determine which user logged in from which domain. If you want the detailed diagnosis to display the username alone, then set this flag to No
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Application instances running:

Represents the number of instances of this published application that are running currently.


Use the detailed diagnosis of this measure to know which users are currently accessing the application and the clients from which the users are connecting.