Citrix Sessions Test

This test reports performance statistics related to Citrix user sessions of the Citrix XenApp server.

Target of the test : Citrix XenApp

Agent deploying the test : An internal agent

Outputs of the test : One set of results for the Citrix XenApp that is to be monitored

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 – The port number at which the specified HOST listens to. By default, this is 1494.
  4. ignore down session ids - By default, this parameter is set to 65536,65537,65538– these are nothing but the default ports at which the listener component listens. If any of these ports go down, then by default, this test will not count any of the sessions that failed when attempting to connect to that port as a Down session. You can override this default setting by adding more ports or by removing one/more existing ports.
  5. REPORT USING MANAGERTIME – By default, this flag is set to Yes. This indicates that the user login time displayed in the detailed diagnosis page for this test and in the Thin Client reports will be based on the eG manager's time zone by default. Set this flag to No if you want the login times displayed in the  detailed diagnosis page for this test and in the Thin Client reports to be based on the Citrix server’s local time.
  6. 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 session that logged out. This default setting ensures that administrators are able to quickly determine the domains to which the users who logged out belonged. You can set this flag to No if you want detailed diagnosis to display only the username of the users who logged out.

  7. 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.

  8. DETAILED DIAGNOSIS – To make diagnosis more efficient and accurate, the eG Enterprise suite 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

Established sessions:

Indicates the number of user sessions that are currently active on this server.

Number

This measure gives an idea of the server workload in terms of active sessions. Tracking the number of active sessions with time, a Citrix administrator can obtain information that can help him/her plan the capacity of their Citrix environment. The detailed diagnosis capability, if enabled, lists the active and inactive sessions on the Citrix XenApp server.

Idle sessions:

Indicates the number of sessions that are initialized and are currently ready to accept connections.

Number

To optimize the performance of a server, two default (idle) sessions are initialized before any client connections are made. For performance reasons, the number of idle sessions should be less than ten. Note that this test does not differentiate between RDP and ICA sessions.

Connected sessions:

Indicates the current number of sessions that are connected, but no user has logged on to the server.

Number

A consistent increase in the value of this measure could indicate that users are having trouble logging in. Further investigation may hence be required. Note that this test does not differentiate between RDP and ICA sessions.

Connecting sessions:

Indicates the number of sessions that are in the process of connecting.

Number

A very high value for this measure indicates a problem with the session or connection. Note that this test does not differentiate between RDP and ICA sessions.

Disconnected sessions:

Indicates the number of sessions from which users have disconnected, but which are still active and can be reconnected.

Number

Too many disconnected sessions running indefinitely on a Citrix XenApp server cause excessive consumption of the server resources. To avoid this, a session limit is typically configured for disconnected sessions on the Citrix XenApp server. When a session limit is reached for a disconnected session, the session ends, which permanently deletes it from the server. Note that this test does not differentiate between RDP and ICA sessions.

Listen sessions:

Indicates the current number of sessions that are ready to accept connections.

Number

Note that this test does not differentiate between RDP and ICA sessions.

Shadow sessions:

Indicates the current number of sessions that are remotely controlling other sessions.

Number

A non-zero value for this measure indicates the existence of shadow sessions that are allowed to view and control the user activity on another session. Such sessions help in troubleshooting/resolving problems with other sessions under their control.

Down sessions:

Indicates the current number of sessions that could not be initialized or terminated.

Number

Ideally, the value of this measure should be 0.

By default, if sessions to any of these ports  – 65536, 65537, 65538 – could not be initialized or terminated, they will not be counted as a ‘down session’.

Init sessions:

Indicates the current number of sessions that are initializing.

Number

A high value for this measure could indicate that many sessions are currently experiencing initialization problems.

Desktop sessions

Indicates the number of sessions that are established from desktops.

Number

 

Mobile sessions

Indicates the number of sessions that are established from mobile devices.

Number

 

The detailed diagnosis capability of the Established sessions measure, if enabled, lists the active and inactive sessions on the Citrix XenApp server.

Figure 1 : The detailed diagnosis of the Established sessions measure of the Citrix XenApp