Foglight for Citrix XenDesktop and XenApp 5.6.16.1

The Agents area contains several tabs that allow you to explore and manage the agent instances that monitor your integrated XenDesktop® environment. Each tab provides information about the agents of a specific type.

Figure 18. Agents tabs

•

XenDesktop Agents and NetScaler Agents tabs: These tabs list the existing instances of the XenDesktop and NetScaler type, and allow you to manage them. These agents are provided with Foglight™ for XenDesktop. For more information, see Managing XenDesktop and NetScaler Agent Instances.

•

VMware Performance Agents tab: This tab lists any existing VMware Performance Agent instances, provided with Foglight™ for VMware, if you have Foglight for VMware installed and deployed.


	TIP: Foglight for VMware allows you to monitor VMware virtual centers by tracking resource consumption of individual physical and virtual elements in your integrated environment, and alerts you of issues that are likely to compromise your system stability. For more information, see your Foglight for VMware documentation.

Figure 19. VMware Performance Agents tab

For each VMware Performance Agent instance, the list displays its name, the address of the monitored virtual center, and the monitored XenDesktop site name.

•

Host tab: If you have Foglight for Infrastructure installed and deployed, this tab lists any existing Host Agent instances.


	TIP: Foglight for Infrastructure monitors physical hosts and helps you analyze and prevent potential performance bottlenecks. Use it to understand the state of your system health, and to track the levels of resource utilization such as CPU, network, and memory consumption for individual objects in your integrated environment. For more information, see your Foglight for Infrastructure documentation.

Figure 20. Host Agents tab

The list displays the hosts in your XenDesktop environment, and for each monitored host it shows the name of the Host agent, the host name, and its type. If a host is not monitored, a link is provided to launch the Add Monitored Host wizard and create a Host Agent instance. For more information about this wizard, see your Foglight for Infrastructure documentation.

•

Multi-Host Process Monitoring Agents: If you have Foglight for Infrastructure installed and deployed, this tab lists any existing Multi-Host Process Monitoring Agent instances.

Figure 21. Multi-Host Process Monitoring Agents tab

For each XenDesktop site, the list displays its name, the Multi-Host Process Monitoring agent, and indicates if the Multi-Host Process Monitoring agents currently collect data. It also displays the numbers of monitored hosts and processes.

•

To find out which hosts or processes are monitored, click a value in the Monitored Hosts or Monitored Processes column.

•

To disable or enable the data collection for a Multi-Host Process Monitoring agent, click the Actions column.

•

To limit the number of desktops that are monitored for each agent instance, click Settings, and type the desired value.

For more information about Multi-Host Process Monitoring Agents, see your Foglight for Infrastructure documentation.

Managing XenDesktop and NetScaler Agent Instances

The XenDesktop Agents and NetScaler Agents tabs list the existing agent instances of these agents and allow you to manage them. Each tab contains a set of columns that indicate various states of individual agent instances, along with several commands that you can issue to manage them. For example, to see if an agent instance is collecting data, look at the agent’s Data Collection column. A green check mark a green check mark in this column indicates that the agent is collecting data.

With the exception of the Alarms column that only appears on the XenDesktop Agents tab, the type of information appearing on these two tabs is identical.

Figure 22. XenDesktop Agents tab

Table 1. XenDesktop Agents and NetScaler Agents tab contents
Agent Name	The name of the agent instance.
Foglight Agent Manager Host	The name of the machine on which the Agent Manager process is running.
Active	Indicates if the agent process is running.
Data Collection	Indicates if the agent is collecting data from the monitored environment.
Alarms	The total numbers of Warning, Critical, and Fatal alarms generated against the agent instance. NOTE: This column only appears on the XenDesktop Agents, but not on the NetScaler Agents tab.
Edit Properties	Click to edit the agent’s properties.
Download Log	Click to download the agent’s log file.
Agent Version	Indicates if the agent is running the latest version of the agent package (), or it needs to be updated ().

The toolbar appearing on top of the Agents table provides a set of commands that allow you to manage XenDesktop Agent instances. To issue any of the available commands, simply select one or more agent instances using the check boxes in the left-most column, and click the appropriate button on the tool bar. For example, to start an agent’s data collection, select a XenDesktop Agent instance and click Start Data Collection.

Figure 23. Agents table toolbar

Table 2. Agents table toolbar

Add

Launches a wizard that allows you to create a new agent instances:

•

Create XenDesktop Agent wizard starts from the XenDeskop Agents tab. For more information, see Creating XenDesktop Agent Instances.

•

NetScaler Discovery Wizard starts from the NetScaler Agents tab. For more information, see Creating NetScaler Agent Instances.

Refresh

Refreshes the list of agent instances and their states.

Activate

Activates the selected agent instances. Activating an agent instance starts the agent process on the machine on which the agent is installed.

Deactivate

Deactivates the selected agent instances. Deactivating an agent stops the agent process on the machine on which the agent is installed.

Start Data Collection

Starts the selected agent instances’ data collection. Starting an agent’s data collection causes the agent to begin monitoring the associated XenDesktop site and to send the collected metrics back to the Management Server.

Stop Data Collection

Stops the data collection of the selected agent instances. Stopping an agent’s data collection causes the agent to stop monitoring the associated XenDesktop site.

Remove

Deletes the selected agent instances.

Update Agent

Updates the agent package to the latest version that is available on the Management Server.

Creating XenDesktop Agent Instances

XenDesktop Agents collect information from monitored hosts. When the XenDesktop Agent package is successfully deployed, you can create one or more agent instances, activate them, and start their data collection. To perform these steps in a single operation, use the Create XenDesktop Agent wizard, accessible from the Agents area on the Administration tab of the XenDesktop Environment dashboard.


	NOTE: Unlike the Discover XenDesktop Wizard, the Create XenDesktop Agent wizard does not offer to create VMware Performance agents for the detected vCenters, or to create Windows or Unix agents for the discovered servers. For more information about the Discover XenDesktop Wizard, see Discovering XenDesktop Sites .

To create and activate a XenDesktop Agent instance, and start collecting data:

On the navigation panel, under Dashboards, click XenDesktop.

On the XenDesktop Environment dashboard that appears in the display area, open the Administration tab.

Figure 24. Administration tab

In the Agents area, click Add to launch the Create XenDesktop Agent wizard.

Figure 25. Create XenDesktop Agent wizard

Select the host running the Agent Manager that you want to use to manage the agent instance you are about to create, and click Next.

Figure 26. Agent Properties page

On the Agent Properties page, provide the following information.

•

XenDesktop Domain: The name of the domain to which the monitored XenDesktop® system belongs.

•

XenDesktop Host Name: The name of the machine hosting the XenDesktop site.

•

User Name: The user name the agent instance needs to connect to the XenDesktop site.

•

Password: The password associated with the XenDesktop user.

•

Collect Processes: Select this check box if you want the XenDesktop agent to collect process metrics.

Click Finish.

The wizard closes, and the Agents area refreshes, showing a newly created agent instance.

Select the agent instance in the list and click Activate.

Click Start Data Collection.

Configuring Agent Properties

Foglight™ for XenDesktop and XenApp uses the following agents to collect information from monitored environments:

•

XenDesktop Agent collects information about your integrated XenDesktop® environment. For information about the XenDesktop Agent properties, see the following topics:

•

Configuring XenDesktop Agent Configuration Properties

•

Configuring XenDesktop or NetScaler Agent Data Collection Scheduler Properties

•

NetScaler Agent collects information about user experience data from monitored desktops, using AppFlow extensions. For information about the XenDesktopSession Agent properties, see the following topics:

•

Configuring NetScaler Agent Configuration Properties

•

Configuring XenDesktop or NetScaler Agent Data Collection Scheduler Properties

These agents collect data from the XenDesktop infrastructure and send it to the Management Server. They keep track of resource utilization metrics and alerts you when certain pre-defined thresholds are reached.

When an agent connects to Foglight, it is provided with sets of properties that it uses to configure its correct running state. Each agent is provided with a combination of two types of properties: agent properties and shareable properties.

Default versions of these properties are installed with Foglight for XenDesktop and XenApp. However, you can edit the default shareable and agent properties, configure agent properties that apply only to a specific agent instance, and create edited clones of shareable properties that are used by a subset of agents of a certain type.

For detailed information about working with agent properties, see the Administration and Configuration Help.

To modify agent properties: