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 the brokers of this site, 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.
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 site server, 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.
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 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 all the machines in each catalog of every broker in the target site.
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 every broker in the target site.
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 a broker in this site.
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 a broker in this site.
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 that are currently available 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 zone to which the catalog 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.
Machines not entitled	Indicates the number of machines in this catalog that are not assigned to any users.	Number	Use the detailed diagnosis of this measure to know which machines in this catalog are not assigned to any user.
Registered machines	Indicates the number of machines that are currently registered with the broker of this catalog.	Number	If the detailed diagnosis of this measure is enabled, then you can use it to quickly identify the machines in this catalog that are currently registered with the broker.
Unregistered machines	Indicates the number of machines that are currently not registered with the broker of this catalog.	Number	A high value for this measure indicates that the virtual desktops are not provisioned to the users and the applications are not published which eventually results in a poor end user experience. Use the detailed diagnosis of this measure to know which machines in this catalog are not registered with the broker.
Machines with agent errors:	Indicates the number of machines that are currently in the AgentError state during the registration process with the broker.	Number	An AgentError is reported if the Virtual Desktop Agent itself is experiencing issues in its operations. Use the detailed diagnosis of this measure to know which machines in this catalog are currently in the AgentError state.
Powered on machines	Indicates the number of machines that are currently powered on in this catalog.	Number	If the detailed diagnosis of this measure is enabled, then you can use it to quickly identify the machines in this catalog that are currently in the powered on state.
Powered off machines	Indicates the number of machines that are currently powered off in 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 zone to which the catalog belongs, the desktop kind, the hypervisor on which the machine is hosted, the location used for storing the changes made by the user, the user who is currently active on the session, the agent version, the applications published on the machine etc.
Machines with suspended power state	Indicates the number of machines in this catalog that are currently in the Suspended state.	Number	Use the detailed diagnosis of this measure to know which machines in this catalog are currently in the Suspended state.
Machines with unknown power state	Indicates the number of machines in this catalog that are currently in Unknown/Unmanaged/Unavailable states.	Number	Use the detailed diagnosis of this measure to know which machines in this catalog are currently in the Unknown/Unmanaged/Unavailable states.
Machines in maintenance mode	Indicates the total number of machines that are currently under maintenance i.e, the maintenance mode of the virtual desktop is enabled.	Number	Use the detailed diagnosis of this measure to know which machines in this catalog are currently under maintenance.
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. If the detailed diagnosis of this measure is enabled, then you can use it to quickly view the complete details of the sessions on all machines in this catalog.
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 zone to which the catalog 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	Use the detailed diagnosis of this measure for the complete details of the pending sessions.

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 zone to which the catalog 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.

Figure 1 : The detailed diagnosis of the Entitled machines measure for the site

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 zone to which the catalog 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.

Figure 2 : The detailed diagnosis of the Established sessions measure of the site

The detailed diagnosis of the Machines with unknown power state measure if enabled, lists the name of the machine, the delivery group and catalog to which the machine belongs, the zone to which the catalog belongs, the desktop kind, the hypervisor on which the machine is hosted, the location used for storing the changes made by the user, the user who is currently active on the session, the agent version, the applications published on the machine etc.

Figure 3 : The detailed diagnosis of the Machines with unknown power state measure