Session States - Site Test

For every type of session (HDX and RDP) on each broker in a site, this test reports the total session count and the status of the sessions.

Target of the test : A Citrix Delivery Controller 7.x

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each OS machine type:protocol that is to be monitored.

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The IP address of the host for which this test is to be configured.

Port

Refers to the port at which the specified host listens to.

Username

In order to monitor the target Delivery Controller 7, eG requires a special user with the following privileges;

  • The All scope and read-only privileges
  • The Allow log on locally security privilege on the Delivery Controller host

The steps for assigning such privileges to a user are discussed in the Pre-requisites for monitoring the Citrix Delivery Controller 7.x. Specify the name of such a user, here.

Password

Specify the password for the user specified in the Username text box, here.

Confirm Password

Confirm the Password by retyping it here.

Domain

Here, specify the domain to which the user specified in the Username text box belongs to.

Report by Machine Type

By default, this flag is set to Yes indicating that the  individual descriptors of this test - i.e., the delivery groups- are classified based on their machine type; in other words, the delivery groups will be listed either under Server OS Machines or Desktop OS Machines based on their machine type. If you do not want to group the delivery groups based on their machine types, set this flag to No.

Show Site Wide Information

By default, this flag is set to Yes, indicating that the monitored server is the site server of a broker site. For a server which is a site, this test will report metrics at the site-level - accordingly, a set of metrics will be reported for each delivery group managed by every broker in the site. On the other hand, if the monitored broker is only a member of a site and not the site server, then set this flag to No. In this case, the test will not report any metrics.

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

Total sessions

Indicates the total number of user sessions of this type across all brokers in this site.

Number

This is a good indicator of the session load on the brokers. If a consistent increase is observed in the value of this measure for the All descriptor, it could hint at a potential overload condition. In such situations, you can compare the value of this measure across session types to figure out which type of session is high on the brokers in this site – HDX or RDP? 

Active sessions

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

Number

A consistent zero value could indicate a connection issue.

To determine the details of the currently active sessions, use the detailed diagnosis of this measure.

Connected sessions

Indicates the number of sessions of this type that are currently connected.

Number

 

Disconnected sessions

Indicates the number of sessions of this type that are currently disconnected.

Number

If all the current sessions suddenly log out, it indicates a problem condition that requires investigation. The detailed diagnosis of this measure lists the sessions that were logged out.

Reconnecting sessions

Indicates the number of sessions of this type that are reconnecting soon after a disconnect.

Number

 

Preparing sessions

Indicates the number of sessions of this type that are currently in the Preparing state.

Number

 

Non-brokered sessions

Indicates the number of user sessions of this type that were not brokered by the machines across this site.

Number

 

Unknown sessions

Indicates the number of sessions of this type that  are currently in Unknown state.

Number

 

Other sessions

Indicates the number of sessions of this type that are currently in Other state.

Number

 

Hidden sessions

Indicates the number of sessions of this type that are currently hidden.

Number

 

Autonomously brokered sessions

Indicates the number of sessions of this type that are brokered without the use of any broker in this site.

Number