The Computers view is a display of all the computers you have added to the console. This view is displayed automatically upon the console launch. Besides browsing, searching, grouping and sorting the data, this view allows you to perform a variety of actions on the selected computer(s).
These actions are available when selecting a computer or a group of computers. They can be invoked using either the Ribbon Bar “Actions” button, the context menu (right-click), or the Actions Panel.

Note: ControlUp will only show you actions which are relevant for all selected records. Thus, if one of the computers you selected is currently in Disconnected mode, you will only see actions applicable to disconnected computers. In addition, in case the Security Policy does not allow you to use some of the actions, they will be greyed out and disabled.

Computers View Column Reference

The following information columns are available in the Information Grid while using the Computers View. For more information regarding Citrix XenApp counters, please refer to http://support.citrix.com/article/CTX133540

Active
Memory*
The amount of memory that  has been used by the VM in the past sample period. This is the “true” number of how much memory the VM currently has need  of. (VMware only)
Active
Sessions
Number of user sessions currently in the “Active” state
ASP Request Queued(Citrix Web Interface) For a Citrix Web Interface, the number of requests waiting to be processed by ASP.
ASP Request
Rejected(Citrix Web Interface)
For a Citrix Web Interface, the number of requests rejected because the request queue was
full.
Avg. Disk
Read Time
For all local disks, the average time, in milliseconds, of a read of data from the disk
Avg. Disk
Write Time
For all local disks, the average time, in milliseconds, of a write of data to the disk
Avg. Logon Duration The average logon duration for all user sessions currently established on the computer.
Computer Local Time
The local time on the managed computer
CPU Processor utilization percentage
CPU Count Number of CPUs
CPU Excessive SMP use* The percentage of time during which the VM is ready to run but unable to do so due to co-scheduling constraints. Also known as Co-Stop. Only valid for VMs with more than one vCPU.  (VMware only)
CPU Ready* The amount of time spent by vCPU as ready to process an instruction but unable to do so, due to no physical processor time being available.
CPU Swap Wait*
The percentage of time during which the VM is waiting on swapped memory pages to be read from disk. (Requires statistics level 3 for vCenter) (VMware 5.x only)
CPU System Time*
The percentage of time spent by system services on behalf of the VM. Often caused by high I/O. (Requires statistics level 3 for vCenter) (VMware only)
CSG
Connections
For a Citrix Secure Gateway server, the number of currently active connections
Description A free text field that helps your colleagues identify the purpose of the computer and document additional information. This field is editable by right-clicking the computer in the organization tree and selecting “Properties”.
Disconnected
Sessions
Number of sessions in the “Disconnected” state
Disk Queue Average disk queue length for all physical disks
Disk Reads / sec
Disk Reads/sec is the rate of read operations on the disk. (Disk Reads / sec  performance counter).
Disk Transfers / sec
Disk Transfers/sec is the rate of read and write operations on the disk. (Disk Transfers / sec  performance counter).
Disk Writes / sec
Disk Writes/sec is the rate of write operations on the disk. (Disk Reads / sec  performance counter).
DNS A Records The IP addresses registered in DNS for this computer
Domain DNS DNS suffix of the computer
Domain Role Role of the computer in the domain
Dropped Received Packets* Number of received packets that were dropped in the last collection interval (needs to be explicitly enabled on XenServer).
Dropped Transmitted Packets*
Number of transmitted packets that were dropped in the last collection interval (needs to be explicitly enabled on XenServer).
Error Rate Marginal rate of error events in the system logs
Folder The full name of the computer’s parent folder in the organization tree.
Free Space on
System Drive
The amount of free space available on the system drive
Guest Name* The computer name as reported to the hypervisor by the guest OS.
Host CPU Usage* Amount of actively used virtual CPU as a percentage of total available CPU. This is the host’s view of the CPU usage, not the guest operating system view. It is the average CPU utilization over all available virtual CPUs in the virtual machine.
Host Name* The name of the virtualization host which is hosting the VM.
Hypervisor Platform* The vendor of the virtualization host on which the VM is hosted.
Install Date Date on which the Operating System was installed

IP Addresses

List of all IP addresses currently configured on the computer. Note: By default, IPv6 addresses are not displayed. In order to display IPv6 addresses, please configure the following Registry value on the managed computer(s):

Parent Key (create the Preferences key if it does not exist): 
HKEY_LOCAL_MACHINE\SOFTWARE\Smart-X\ControlUpAgent\Preferences

Value Name: showIPv6

Value Type: REG_DWORD

Value Content: 1

This value may be created simultaneously on multiple computers by using the Registry Controller. The ControlUp Agent (cuAgent) service needs to be restarted for this change to take effect.

Last Boot Date and time of the last system boot
Logon Server
The name of the Active Directory domain controller used to authenticate the computer account.
Manufacturer Hardware manufacturer of the system
Max Free
Space Drive
Amount of free space available on the least occupied fixed drive
Memory Amount of physical RAM on the computer. Note: This column is designed to disregard small differences in RAM reported by some computers, so this column’s value is rounded to the closest 128 MB.
Memory SwapIp rate
Rate at which memory is swapped from disk into active memory during the current interval.
Memory SwapOut Rate
Rate at which memory is being swapped from active memory to disk during the current interval.
Memory
Utilization
RAM utilization percentage
Min Free
Space Drive

Amount of free space available on the most occupied fixed drive. By default, all local fixed drives are evaluated. Note: ControlUp supports excluding drives from free space calculation by creating the following registry value on the managed computer(s):

Parent Key (create the ExclusionRules key if it does not exist):
HKEY_LOCAL_MACHINE\SOFTWARE\Smart-X\ControlUpAgent\ExclusionRules

Value Name: Drives
Value Type: REG_MULTI_SZ
Value Content: Enter a drive letter (without “:”) on a separate line for each excluded drive.

This value may be created simultaneously on multiple computers by using the Registry Controller. The ControlUp Agent (cuAgent) service needs to be restarted for this change to take effect.

Model Hardware model of the system
Name Computer name
Net Bytes
Received / sec
Bytes Received/sec is the rate at which bytes are received over all Ethernet adapters, including framing characters
Net Bytes
Sent / sec
Bytes Sent/sec is the rate at which bytes are sent over all Ethernet adapters, including framing characters
Net Bytes
Total / sec
Bytes Total/sec is the rate at which bytes are sent and received over all Ethernet adapters, including framing characters. Network InterfaceBytes Total/sec is a sum of Network InterfaceBytes Received/sec and Network InterfaceBytes Sent/sec
Operating
System
Operating system version
Organization Company name for the registered user of the operating system
OS Service
Pack
Operating system service pack version
Pages/sec The rate at which pages are read from or written to disk to resolve hard page faults.
Paging File The percentage of the Page File currently in use (Total for all paging file instances).
Physical
Addresses
The physical addresses for all of the computer’s Ethernet adapters
Physical Disk
Time
“Avg. Disk Queue Length” counter multiplied by 100.
Physical Memory Used The amount of machine RAM actually used by the VM.
Processes Total number of running processes on the computer
Processor
Queue Length
The number of threads in the processor queue, divided by the number of cores.
PVS vDisk File Name For a Citrix Provisioning Services target device, the name of the currently active vDisk file.

Registered IP
Addresses

This column shows how many of the computer’s IP addresses are registered in DNS. (e.g. 1/2 means the computer has 2 IP addresses, one of which is registered in DNS).Note: When configuring stress level thresholds for this column, please consider the following:

  • Threshold levels are configured as a percentage of registered addresses out of total addresses
  • Medium level for this counter will be higher than or equal to the High level

For example, this column might be colored yellow if 90% or less of the computer’s IP addresses are registered and red if less than one percent (i.e. none) of the IP addresses are registered.

Sessions Total number of sessions (including system and services)
Status ControlUp agent connection status
Stress Level An aggregated measure of the computer’s performance columns, as configured for the current record in the Stress Settings window.
System Type Bitness (32/64 bit) of the operating system
Uptime Time elapsed since last boot
View Agent Version
The version of the vmWare View agent component, if installed.
Virtual Disk Read IOPS*
Average number of read commands issued per second to the datastore during the collection interval. If the VM has multiple disks attached, the value displayed belongs to the disk with the highest number of IOPS.
Virtual Disk Read Latency*
Average amount of time for a read operation from the virtual disk. If the VM has multiple disks attached, the value displayed belongs to the disk with the highest latency.
Virtual Disk Read KBps*
Average number of kilobytes read from the disk each second during the collection interval. If the VM has multiple disks attached, the value displayed belongs to the disk with the highest value.
Virtual Disk Write IOPS*
Average number of write commands issued per second to the datastore during the collection interval. If the VM has multiple disks attached, the value displayed belongs to the disk with the highest number of IOPS.
Virtual Disk Write Latency*
Average amount of time for a write operation to the virtual disk.  If the VM has multiple disks attached, the value displayed belongs to the disk with the highest latency.
Virtual Disk Write KBps*
Average number of kilobytes written to the disk each second during the collection interval. If the VM has multiple disks attached, the value displayed belongs to the disk with the highest value.
VM Name*
The name of the virtual machine, as seen by the hypervisor.
VM Power State*
The current power state of the virtual machine.
VM Tools State*
The state of the virtualization tools package inside the guest OS. (VMware only)
VM Tools Version*
The current version of the virtualization tools package inside the guest OS.
VM Tools Version State*
Indicates whether the virtualization tools package inside the guest OS is up to date.
Warning Rate Marginal rate of warning events in the system logs
Windows
Directory
Value of the %WINDIR% environment variable
WorkItem Queue Ready Count (XenApp) For Citrix XenApp XML brokers and controllers, the number of work items that are ready to be executed.
XenApp # of
Published Applications

For a Citrix XenApp server, the number of published applications assigned to the server directly or via a Worker Group.Note: In environments with a large number of published applications, retrieving this column may cause unwanted stress on the collecting computers. For this reason, this column is disabled by default and will show N/A until the following registry value is configured on all managed computers:

[HKEY_LOCAL_MACHINE\SOFTWARE\Smart-X\ControlUpAgent\QFarmCounters]“PublishedAppEnabled”=dword:00000001

This value may be created simultaneously on multiple computers by using the Registry Controller. The ControlUp Agent (cuAgent) service needs to be restarted for this change to take effect.

XenApp Datastore Connection Failure For a Citrix XenApp server, the number of minutes that the server has been disconnected from the data store.
XenApp
Edition
For a Citrix XenApp server, the currently installed edition of XenApp.
XenApp Farm For a Citrix XenApp server, the name of the server farm to which the server belongs.
XenApp
License Check-Out Time(Citrix XenApp)
For a Citrix XenApp server, displays the last recorded Citrix license check-out response time in milliseconds.
XenApp
License Server Connection Failure(Citrix XenApp)
For a Citrix XenApp server, displays the number of minutes that XenApp has been disconnected from the License Server.
XenApp Load
Evaluator
For a Citrix XenApp server, the name of the load evaluator assigned to the server.
XenApp Number
of Busy XML Threads(Citrix XML Broker)
For a Citrix XML Broker, the number of XML threads currently being processed.
XenApp
Resolution Time(Citrix XML Broker)
For a Citrix XenApp XML broker server, the time in milliseconds that a published application resolution took to complete.
XenApp
Resolution WorkItem Queue Ready Count(Citrix
XenApp)
For Citrix XenApp XML brokers and controllers, the number of resolution work items (related to application launches) that are ready to be executed.

XenApp Server
Load

For Citrix XenApp servers only, the server load as reported by the qfarm /load command. If the server is not found in the output of this command or if an error occurs while executing the command, an error value is displayed, which is 2147483647 by default. A custom error value may be configured by creating the following registry value on the managed server(s):Parent Key (create the QFarmCounters key if it does not exist):
HKEY_LOCAL_MACHINE\SOFTWARE\Smart-X\ControlUpAgent\QFarmCounters

Value Name: loadErrorValue
Value Type: REG_DWORD
Value Content: A numerical value of choice to represent an error.

If you would like to set a load threshold on this column, you might also want to highlight servers that have no logged on users. To do this, you may configure a custom value to be displayed if the server’s load is zero. To do so, create the following registry value on the managed computers(s):

Parent Key (create the QFarmCounters key if it does not exist)::

HKEY_LOCAL_MACHINE\SOFTWARE\Smart-X\ControlUpAgent\QFarmCounters

Value Name: zeroLoadFactor

Value Type: REG_DWORD

Value Content: A numerical value of choice to replace zero.

XenApp Server
Logon Mode
For Citrix XenApp servers only, logon mode as reported by the qfarm /load command (available starting XenApp version 6.5)
XenApp
Version
For a Citrix XenApp server, the currently installed version of XenApp.
XenApp Worker
Group
For a Citrix XenApp server, the name of the Worker Group to which the server belongs.
XenApp Zone For a Citrix XenApp server, the name of the zone to which the server belongs.
XenApp Zone
Data Collector
For a Citrix XenApp server, the name of the current zone data collector for the zone to which the server belongs.
XenDesktop
Catalog Name
For a Citrix XenDesktop workstation or server, the name of the catalog to which the computer is assigned.

XenDesktop
Database Avg. Transaction Time
For a Citrix XenDesktop Broker, the time on average, in seconds, taken to execute a database transaction.

XenDesktop
Database Connected
Indicates using 1 or 0 whether the Citrix XenDesktop Broker service is in contact with its database.

XenDesktop
Database Transaction Errors / sec
The rate per second at which XenDesktop Database transactions are failing.

XenDesktop
Desktop Group
For a Citrix XenDesktop workstation or server, the name of the desktop group to which the computer belongs.

XenDesktop
Desktop Kind
For a Citrix XenDesktop workstation or server, the kind of desktop for the current computer.

XenDesktop Desktop State
For a Citrix XenDesktop workstation or server, the current registration state of the computer.

XenDesktop
Farm Name
For a Citrix XenDesktop workstation or server, the name of the farm to which the computer belongs.

XenDesktop
MCS Image out of Date
For a Citrix XenDesktop workstation or server using Machine Creation Services (MCS), indicates whether a new updated disk image has been assigned to the current computer.

XenDesktop
VDA Version

For a Citrix XenDesktop workstation or server, the version of Virtual Desktop Agent software installed on the current computer.

* – Additional columns for Computer View retrieved from the virtualization layer. The information for these additional columns  comes from the hypervisor, independent of the agent installed in the guest OS. This means that all VMs, regardless of whether or not the ControlUp agent is installed, will have these columns populated as long as the host is connected  to the console.

 

The Stress Level Column

The purpose of the Stress Level column is to provide the administrator with a concise measure of current load on the resource, be it a computer, a user session or a process. Each performance column in ControlUp (e.g. CPU, Memory usage, Disk queue) has pre-configured ranges of values that influence the color in which the column will be displayed. These settings are customizable for every folder in your organization tree. For more information on customizing the Stress Level column calculation, please see the Stress Settings Pane chapter.

For an informative display (such as control room status screens), you might want to sort the current ControlUp view by the Stress level column. This way, the highly stressed resources will always appear on top of the table.

Investigating the Causes for Stress Level Values

When one of the resources in you information grid shows a certain Stress Level, you might want to investigate the reason for this value. If you click on a Stress Level cell for a particular resource, a small arrow button appears in the corner of the cell:

When clicked, this button invokes the Stress Level Details window, which shows the steps taken by ControlUp to calculate the current Stress Level value for the selected resource. For example:

In this case, you can see that the selected server has crossed three different thresholds configured on the Stress Settings Pane. Namely, when performance data was last sampled (at 12:02), the Memory Utilization counter was beyond its threshold of 80%. Also, the Minimum Free Space for the system drive fell below 200 MB. Each of these violations added 2 points to the Stress Level value, which results in a total Stress Level value of 6, which is considered Critical in the configuration used here.
Each line in the Stress Level Details Window includes a “Settings” link, which you can use to modify the thresholds and weights for every counter and condition. For more information on customizing the Stress Level column calculation, please see the Stress Settings page.

Computers View Actions

Connect Contact the ControlUp Agent on the selected managed computer(s) and start gathering performance data.
Disconnect Close the connection to the ControlUp agent on the selected managed computer(s).
View Related Incidents
Switch to the Incidents Pane and filter the display to show incidents related to the selected computer
Manage Services Allows for comparison and batch management of the Windows Services on the selected computer(s) using the Services Controller.
Manage Registry Allows for comparison and batch management of the Windows Registry on the selected computer(s) using the Registry Controller.
Manage File System Allows for comparison and batch management of the file system on the selected computer(s) using the File System Controller.
Flush DNS
Clears the DNS client cache on the managed computer(s) (ipconfig /flushdns).
Manage Programs and Updates
Allows for comparison and of installed programs and OS updates on the selected computer(s) using the Programs and Updates Controller.
RDP to computer
Switches to the Remote Desktop pane and establishes an RDP connection to the managed computer(s).
Remote Desktop Services > Send Super Message
This action allows administrators to send an enhanced message to all the users on the selected target computer(s). This action can be useful when conveying an important message to the end users and gathering the users’ feedback (for example when testing a recent software fix). The message can be configured:
1.    To include rich-text formatting and graphics
2.    To close the message automatically when a configured timeout has elapsed
3.    To stay on top of all other user’s windows
4.    To not allow the user to close the message window
5.    To allow the user to respond to the message:
6.    To use pre-configured reply buttons (such as Yes;No or OK;Cancel)
7.    To allow free text replies
If the user response option is enabled, a window will open displaying all of the users’ feedback gathered by the Super Message.
Remote Desktop Services > Send Message This action allows administrators to send a plain text message to all the users on the selected target computer(s).
Power Management > Reboot Machine
Performs a soft reboot of the target computer(s) using ControlUp Agent.
Power Management > Send Wake-On-LAN signal
The selected computer(s) will be used to transmit a Wake-On-LAN magic packet. You will be prompted to select the computers to which the packet will be sent.
Power Management > Shutdown Machine
Performs a soft shutdown of the target computer(s) using ControlUp Agent.
Group Policy > Refresh Machine Group Policy This action triggers a Group Policy update on the remote computer using Windows built-in gpupdate.exe utility. You can manipulate the “Force” and “Timeout” parameters using the action window.
Registry > Import Registry
Allows for importing a .reg file to the managed computers’ registry.
Processes > Disable Process Execution This action prevents processes with the configured file name from being executed on the target computer(s). This action can be useful for preventing a program from being run during upgrades or software maintenance.
You are advised to use extreme caution when preventing process execution, since this action affects all users on the selected computer(s) and the execution block will be enforced until explicitly removed using the “Enable Process Execution” action.
It is important to provide the end user who might try to run a disabled process with an explanation that will appear on his/her screen. Using the action’s built in text message capability you can provide such explanation.
Processes > Enable Process Execution This action cancels the “Disable Process Execution” action. You may choose to remove all existing execution blocks previously set on the selected computer(s) or configure a specific process name to be unblocked.
Processes > Run As
This action allows you to launch a process on the target computer. You can run any executable that is accessible on the target computer(s) If using a command-line expression or a batch file, please prepend “cmd.exe /c ” to your command.
Note – processes started using this action are executed in session 0 using Local System and are not visible to the users working on the target computer(s). For executing interactive processes, use the “Start Process in Session” action described in the Sessions View chapter.
Agent Control > Uninstall Remote Agent

This action removes the cuAgent service from the target computer(s), along with all ControlUp-related files and settings. By default, ControlUp agents are installed in a temporary mode, which means that the agents are uninstalled automatically if no connection is made to them for 5 minutes.

Note: ControlUp agents installed using standalone MSI packages cannot be uninstalled using this method.

Agent Control > Upgrade Remote Agent
If the console detects a ControlUp agent running on the target computer(s), a version check is performed and the connection is accepted only if the agent’s version is compatible with the console’s version. If you receive an error message stating that your target computer is running an unsupported version of ControlUp agent, use this action to upgrade the agent.
Agent Control > Start Remote Agent This action starts the cuAgent service on the target computer(s). This may be useful in case you are experiencing issues when connection to the computer using ControlUp.
Agent Control > Stop Remote Agent This action stops the cuAgent service on the target computer(s).
Agent Control > Restart Remote Agent This action stops and then starts the cuAgent service on the target computer(s).
Agent Control > Set Listening Port
Using this option, you can modify the TCP port number used by the ControlUp Agent for communication with the console. If you decide to change the default TCP port number, please consider the following:
–    When selecting a port number, please ensure no other applications on your network are using this port number.
–    After changing the port number on managed computers, you should instruct other administrators using ControlUp in your environment to re-add these computers to ControlUp using the Add Computers Wizard, while providing the updated port number.

Agent Control > Agent Properties*

*only available in the organization tree

You can display the current status of the ControlUp agent on a managed computer by right clicking its icon in the tree view and selecting “Agent Properties”. A window will open presenting the current version of the agent, its installation port, description, auto-connect settings, and the active connections currently established to this managed computer.
Diagnostics > Launch Event Viewer
Launches Windows Event Viewer pointed to the managed computer(s).
Diagnostics > Admin$
Opens the Admin$ share on the managed computer(s).
Diagnostics > NSLookup
Performs a DNS lookup with the managed computer(s) FQDN.
Diagnostics > Ping
Pings the managed computer(s).
Diagnostics > Test WMI
Performs a remote WMI operation (listing system services), while suppressing output and displaying any errors.
Diagnostics > Trace
Executes a tracert command with the FQDN of the managed computer.
Script-based Actions
Invokes any Script-based Actions downloaded or created for use in your organization and configured to be applicable to computers. For more details, please refer to the Script-based Actions chapter.
VM Power Management > Force Power Off VM
Invokes a forceful power off operation on the selected virtual machine using its virtualization infrastructure.
VM Power Management > Force Reset VM Invokes a forceful reset operation on the selected virtual machine using its virtualization infrastructure.
VM Power Management >  Power On VM Turns on the selected virtual machine using its virtualization infrastructure.
VM Power Management > Restart Guest Invokes a graceful restart operation on the selected virtual machine using its virtualization infrastructure and virtual machine tools. This requires the hypervisor tools to be installed on the guest OS.
VM Power Management >  Shutdown Guest Invokes a graceful shutdown operation on the selected virtual machine using its virtualization infrastructure and virtual machine tools. This requires the hypervisor tools to be installed on the guest OS.

Note: If multiple records are selected, not all ControlUp actions may be displayed on the context menu or on the Actions sidebar. When more than one object is selected, both those locations will only display the actions which may be performed on all the selected objects.