Brokering Machines Test

Collections of desktops or physical computers are managed as a single entity called a machine catalog. To deliver desktops and applications to users, the machine administrator creates a catalog of machines and the assignment administrator allocates machines from the machine catalog to users by creating delivery groups.

For each catalog managed by a broker, this test reports the number of machines available, the number of registered machines, those machines that are not registered, the machines that are currently powered on, powered off, those in Agent error state etc. In addition, using this test, you can figure out the number of sessions on each catalog, the sessions that are established and the sessions that are currently pending. The load on each catalog can thus be ascertained.

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 catalog 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. By default, this is 80.

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.

Show Total Machines DD

By default, this flag is set to No. This implies that by default, detailed metrics will not be available for the Total sessions measure of this test. To enable detailed diagnosis for this measure, you can set this flag to Yes. In this case, you will be able to view the complete details of all the sessions related to each catalog of the monitored broker.

Show Total Sessions DD

By default, this flag is set to No. This implies that by default, detailed metrics will not be available for the Total sessions measure of this test. To enable detailed diagnosis for this measure, you can set this flag to Yes. In this case, you will be able to view the complete details of all the sessions related to each catalog of the monitored broker.

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 Registered Machines DD

By default, this flag is set to No. This implies that by default, detailed metrics will not be available for Registered machines measure of this test. To enable detailed diagnosis for this measure, you can set this flag to Yes. In this case, you will be able to view the complete details of the machines (in each catalog) that are currently registered with the broker being monitored.

Show Powered On Machines DD

By default, this flag is set to No. This implies that by default, detailed metrics will not be available for Powered on machines measure of this test. To enable detailed diagnosis for this measure, you can set this flag to Yes. In this case, you will be able to view the complete details of the powered on machines in each catalog configured on the monitored broker.

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 machines

Indicates the total number of machines in this catalog.

Number

The detailed diagnosis of this measure, if enabled, reveals the details of each of the machines in a catalog.

Entitled machines

Indicates the total number of machines that are currently assigned to users in this catalog.

Number

Users can be explicitly assigned to the machines or can be assigned based on the first use of the machine.

The detailed diagnosis of this measure if enabled, lists the name of the machine, the delivery group and catalog to which the machine belongs, the power state of the machine, the IP address, the OS on which the machine operates and the version, the location where the changes made by the user is stored, the user active on the session, the version of the agent, the applications published on the machine etc.

Not entitled machines

Indicates the number of machines in this catalog that are not assigned to any users.

Number

 

Registered machines

Indicates the number of machines in this catalog that are currently registered with the broker.

Number

 

Unregistered machines

Indicates the number of machines in this catalog that are currently not registered with the broker.

Number

A high value for this measure indicates that the machines are not provisioned to the users and the applications are not published which eventually results in a poor end user experience.

Agent error machines

Indicates the number of machines in this catalog that are currently in the AgentError state.

Number

An AgentError is reported if the Virtual Desktop Agent itself is experiencing issues in its operations.

Powered on machines

Indicates the number of machines that are currently powered on in this catalog.

Number

 

Powered off machines

Indicates the number of machines that are currently powered off in this catalog.

Number

 

Machines with suspended power state

Indicates the number of machines in this catalog that are currently in the Suspended state.

Number

 

Machines with unknown power state:

Indicates the number of machines in this catalog that are currently in Unknown/Unmanaged/Unavailable states.

Number

 

Maintenance mode machines

Indicates the total number of machines in this catalog that are currently under maintenance - i.e., the maintenance mode of the virtual desktop is enabled.

Number

 

Total sessions

Indicates the total number of user sessions across all the machines available in this catalog.

Number

This measure is a sum of the Established sessions and the Pending sessions measures.

Established sessions

Indicates the number of user sessions that are currently established on the machines of this catalog.

Number

The detailed diagnosis of this measure if enabled, lists the name of the machine, the delivery group and catalog to which the machine belongs, the number of sessions established through each machine, the IP address, the OS on which the machine operates and the version, the location where the changes made by the user is stored, the user active on the session, the version of the agent, the applications published on the machine etc.

Pending sessions

Indicates the number of user sessions that are pending or waiting to be established on the machines of this catalog.

Number

 

 

The detailed diagnosis of the Entitled machines measure if enabled, lists the name of the machine, the delivery group and catalog to which the machine belongs, the power state of the machine, the IP address, the OS on which the machine operates and the version, the location where the changes made by the user is stored, the user active on the session, the version of the agent, the applications published on the machine etc.

Detailed diagnosis for Entitled machines measure

Figure 1 : The detailed diagnosis of the Entitled machines measure

The detailed diagnosis of the Established sessions measure if enabled, lists the name of the machine, the delivery group and catalog to which the machine belongs, the number of sessions established through each machine, the IP address, the OS on which the machine operates and the version, the location where the changes made by the user is stored, the user active on the session, the version of the agent, the applications published on the machine etc.

Detailed diagnosis for Establised sessions measure

Figure 2 : The detailed diagnosis of the Establised sessions measure