The folders view is a display of managed computers separated by their parent folders in the organization tree. This is useful in case you would like to see aggregated measures for computers located in the same folder. For example, if you would like to see how many user sessions are active in your RDS farm, you can place all RDS in one folder and look at the “Total Active User Sessions” column for that folder’s row.All the folders and subfolders are presented in a flat hierarchy, so you can see aggregated performance and data for any folder in the organization.

Hypervisor folders

The Hypervisor folder is where all hypervisor connections are created and maintained. From the top-level Hypervisors folder, you can add either more hypervisor folders (to help organize your management of your hypervisor environment and for security policy purposes) or add a hypervisor connection. All objects in the hypervisor folders branch of the tree are treated as regular folders in the Information Grid, and therefore show up in the Folders View the same as regular ControlUp folders.

Because of this new type of folder and additional information that comes from the hypervisors, there are new columns that are specific to a virtualization environment. Non-hypervisor folders will have “N/A” in these columns.

Folders View Hypervisor Columns Reference

Avg. Host CPU

Avg. percentage of CPU on all virtualization hosts in the folder

Avg. Host Memory Usage

Avg. percentage of memory usage on all virtualization hosts in the folder

Hypervisor Platform

The hypervisor platform of hosts in this folder

Source

The data collector agent that is collecting information for this folder

Stress Distribution Columns

The stress levels (Low, Medium, High, Critical) now include the new types of records, Hosts and Unmanaged VMs.

Unmanaged VMs

Total number of unmanaged VMs

Virtualization hosts

Total number of hosts

Folders View Column Reference

Avg. App Load Time

Average load time for selected user-mode applications running on all computers in the folder, as defined in App Load Time tab of the Settings window

Average GPU Frame Buffer Usage

Average frame buffer usage for all GPUs

Average GPU Usage

Average usage of all GPUs

Avg. Logon Duration

The average logon duration for all user sessions currently established on all computers in the folder.

Average Sessions per Computer

The average number of user sessions (including System and Console sessions) per computer in the folder.

AWS Alarms in Alarm Status

Total number of CloudWatch alarms in Alarm status for all EC2 instances in the folder

AWS Alarms in Insufficient Data Status

Total number of CloudWatch alarms in Insufficient Data status for all EC2 instances in the folder

AWS Alarms in OK Status

Total number of CloudWatch alarms in OK status for all EC2 instances in the folder

AWS Attached Elastic IP Hourly Cost

Sum of AWS Elastic IP Hourly Cost for all instances in this folder

AWS Attached Snapshot Hourly Cost

Sum of AWS Attached Snapshots Hourly Cost for all instances in this folder

AWS Attached Storage Hourly Cost

Sum of AWS Storage Hourly Cost for all storage volumes attached to instances in this folder

AWS Avg. CPU Utilization

Average CPU utilization of EC2 instances in the folder, from the cloud hosting perspective

AWS Days to Next RI Expiration Date

For an AWS folder, the number of days to the next RI expiration date

AWS Detached Elastic IP Hourly Cost

The total hourly cost for detached elastic IP addresses

AWS Detached Snapshot Hourly Cost

Total estimated hourly cost for all snapshots of volumes detached from instances in this folder, based on the total size of a single snapshot per volume.

AWS Detached Storage Hourly Cost

The total hourly cost for all storage volumes detached from instances in this folder

AWS Disk Read Operations

Total number of disk read IOPS consumed by EC2 instances in the folder

AWS Disk Write Operations

Total number of disk write IOPS consumed by EC2 instances in the folder

AWS EC2 Instance Hourly Cost

Sum of AWS EC2 Instance Hourly Cost for all instances in this folder

AWS Instances with Failed Status Checks

Number of powered on EC2 instances in this folder that have failed status checks

AWS Monthly Run Rate

The estimated monthly rate that you will be charged with, based on the calculation: [total hourly cost] * [number of days in month] * [24 hours]

AWS Network In

Total incoming network bandwidth consumed by EC2 instances in the folder

AWS Network Out

Total outgoing network bandwidth consumed by EC2 instances in the folder

AWS Next RI Expiration Date

For an AWS folder, date of the next RI expiration date

AWS Number of Unutilized RIs

For an AWS folder, the number of RIs for which no qualifying instances were found

AWS Region

Name of the AWS region

AWS RI Upfront Hourly Cost

Sum of AWS RI Upfront Hourly Cost for all instances in this folder

AWS Running EC2 instances

Number of EC2 instances in this folder that are currently running

AWS Stopped EC2 instances

Number of EC2 instances in this folder that are currently stopped

AWS Total Hourly Cost

The total hourly EC2 cost associated with this folder (sum of instances, attached storage, snapshots, and elastic IP costs)

AWS Unutilized RI Hourly Cost

For all RIs for which no qualifying instances were found, this is the upfront sum payed from the RIs divided by the number of hours in the reservation period.

Computers

The total number of computers in the folder (including computers which are currently disconnected, down or otherwise inaccessible).

Computers CPU

Average percentage of CPU consumed on all managed computers in this folder

Computers with GPU

Number of computers with GPUs

Connected Computers

The total number of computers with active ControlUp agent communication.

Description

A free-text description which will be seen by other members of your team

Disconnected Computers

The total number of computers for which ControlUp agent communication is currently inactive.

Average percentage of CPU consumed on all virtualization hosts in this folder

Hosts Memory

Average percentage of memory utilized on all virtualization hosts in this folder

Information Source

Name of the hypervisor data collector

Max Sessions per Computer

The maximum number of sessions (including Console and Services sessions) currently established on a single connected computer in the folder.

Min Sessions per Computer

The minimum number of sessions (including Console and Services sessions) currently established on a single connected computer in the folder.

Name

A free text name of the folder

NetScaler Appliances

Total count of NetScaler appliances in the folder

NetScaler Appliances with Unsaved Config

Percentage of appliances with unsaved configurations out of the total appliances

NetScaler Gateway Total Bytes In / sec

Total rate of requests received on all NetScaler gateways, per second

NetScaler Gateway Total Bytes Out / sec

Total rate of requests sent from all NetScaler gateways, per second

NetScaler LB Bytes In / sec

Total rate of incoming request bytes to all NetScaler load balancers, per second

NetScaler LB Bytes Out / sec

Total rate of outgoing response bytes from all NetScaler load balancers, per second

NetScaler LB Total Hit Rate

The rate per second of total requests received by all NetScaler load balancers in the folder

NetScaler Total Traffic In

Total rate of incoming traffic to all NICs on the NetScaler appliance, per second

NetScaler Total Traffic Out

Total rate of outgoing traffic to all NICs on the NetScaler appliance, per second

NetScaler Total HDX Sessions

Total number of HDX sessions on all NetScaler appliances in the folder

NetScaler Total LB Users Connections

Total number of load balancer connections on all NetScaler appliances in the folder

NetScaler Total SSL Users

Total number of SSL users for all gateways on all NetScaler appliances in the folder

Page Faults/sec

The average of the current reading from the Page Faults/sec counter on all connected computers in the folder.

NetScaler % of GWs Up

Percentage of NetScaler gateways in Up state out of the total count of gateways

NetScaler % of LBs Up

Percentage of NetScaler load balancers in Up state out of the total count of load balancers

Processes

The total number of processes running on all connected computers in the folder.

Sessions

The total number of sessions (including Console and Services sessions) currently established on all computers in the folder.

Stress Distribution Columns

The Folders view includes a column for every stress level (Low, Medium, High, Critical) and type of record (Computers, Sessions, Processes).

Stress Level

An aggregated value resulting from the stress indicators as configured in the Stress Settings pane.

Unmanaged VMs

Total number of unmanaged VMs (virtual machines with no ControlUp agent installed)

User Sessions

The total number of user sessions currently established on all computers in the folder.

XD % Available Computers

Percentage of available XenDesktop computers

XD % Available Delivery Groups

Percentage of available XenDesktop Delivery Groups

XD % Available Desktops

Percentage of the available XenDesktop computers, out of the total number of computers in the desktop group

XD % Healthy Brokers

Percentage of available XenDesktop brokers

XD Agentless Computers

Total number of XenDesktop Machines who are still unmanaged

XD Available Computers

The number of desktop computers in the XenDesktop delivery group in "Available" state

XD Average Logon Duration

Average logon duration for all computers the XenDesktop delivery group

XD Computers

Total number of computers in the XenDesktop delivery group

XD Computers In Use

The number of published desktops currently in use in the XenDesktop delivery group

XD Delivery Group Availability

Indicates whether the XenDesktop delivery group is available (enabled, not in maintenance mode and has available computers)

XD Delivery Group Enabled

Specifies whether the XenDesktop delivery group is enabled (shown to users)

XD Delivery Groups

Total number of Delivery Groups

XD Delivery Type

The type of resources published in the XenDesktop delivery group (desktops only, apps only or desktops and apps)

XD Desktop Kind

The kind of desktops published in the XenDesktop delivery group (Private or Shared)

XD Disconnected Sessions

The number of published desktops with disconnected user sessions in the XenDesktop delivery group

XD Failed Computers

Count of XenDesktop computers in "Unregistered", "Stuck on Boot" or other failed states

XD in Use / Published Apps Ratio

Percentage of published XenDesktop applications currently in use on all computers in the folder

XD Is Remote PC

Specifies whether the computers in the XenDesktop delivery group are personal published desktops with a VDA agent for remote access

XD Maintenance Mode

Specifies whether the XenDesktop delivery group is in maintenance mode

XD Never Registered Computers

The number of published desktops that never registered in the XenDesktop delivery group

XD Preparing Computers

The number of published desktops in the XenDesktop delivery group whose PvD disk image is being prepared

XD Published Applications

The total number of published applications in the XenDesktop delivery group

XD Session Support

Specifies the session support (single/multi) of the machines in the XenDesktop delivery group. Computers with the incorrect session support for the desktop group will be unable to register with the Citrix Broker Service

XD Site Name

For a XenDesktop computer, the name of the XenDesktop Site

XD Unregistered Computers

The number of published desktops in the XenDesktop delivery group that are currently unregistered

XD User Connection Failures Per Hour

Rate of failed user connections to XenDesktop in the last hour

Folders View Actions

Besides browsing, searching, grouping and sorting the data, this view allows you to perform a variety of actions on the selected folders(s).These actions are available when selecting a folder or a group of folders. They can be invoked using either the Ribbon Bar “Actions” button, the context menu (right-click), or the Actions Panel.

Connect

Contact the ControlUp Agent on all managed computers in the selected folder(s) and start gathering performance data.

Disconnect

Close the connection to the ControlUp agent on all managed computers in the selected folder(s).

Flush DNS

Clears the DNS client cache (ipconfig /flushdns) on all managed computers in the selected folder(s).

Send MessageThis action allows administrators to send a plain text message to all the users on all managed computers in the selected folder(s).

Send Super MessageThis action allows administrators to send an enhanced message to all the users on all managed computers in the selected folder(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 graphics2. To close the message automatically when a configured timeout has elapsed3. To stay on top of all other user’s windows4. To not allow the user to close the message window5. 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 repliesIf the user response option is enabled, a window will open displaying all of the users’ feedback gathered by the Super Message.

Refresh Machine Group PolicyThis action triggers a Group Policy update on all managed computers in the selected folder(s) using Windows built-in gpupdate.exe utility. You can manipulate the “Force” and “Timeout” parameters using the action window.

Import Registry

Allows for importing a .reg file to the registry of all managed computers in the selected folder(s).

Disable process executionThis action prevents processes with the configured file name from being executed on all managed computers in the selected folder(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 all managed computers in the selected folder(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.

Enable Process ExecutionThis action cancels the “Disable Process Execution” action on all managed computers in the selected folder(s). You may choose to remove all existing execution blocks previously set on all managed computers or configure a specific process name to be unblocked.

Run AsThis action allows you to launch a process on all managed computers in the selected folder(s). You can run any executable that is accessible on the managed 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.

Hypervisor Folders View Actions

Unlike regular ControlUp folders, there are no actions that can be taken on the hypervisor folders themselves except for viewing related incidents in the Incidents database.

The Hosts view is a display of all the virtualization hosts associated with all hypervisor connections that have been added to the console. This view includes a wealth of performance counters that are retrieved directly from the hypervisor. This gives you the ability to see the performance statistics of the host directly, without having to install or run the hypervisor management program. This can be very helpful for first-level or first contact hypervisor troubleshooting.

Hosts View Column Reference

Some VMware host statistics require statistics level 3 to be defined in vCenter. For more information on setting statistics levels in vCenter, please refer to the appropriate VMware documentation.Some XenServer statistics require XenServer v6.2 or v6.1 with the Performance Monitoring Enhancement Pack, CTX135033.

Active Memory

Sum of all memory that is actively used for all VMs, including vSphere services on the host. (VMware only)

BIOS Release Date

Release date of the virtualization host's BIOS

BIOS Version

BIOS version of the virtualization host

Configured EVC Baseline

The current Enhanced vMotion Compatibility (EVC) baseline configured on hosts in this cluster

Consumed Memory

The total consumed memory for all running virtual machines. (for VMware hosts, this includes memory used by the Service Console, the VMkernel, and vSphere services)

Objects in the Hypervisors folder

All objects (pools, datacenters, clusters, etc) in the Hypervisors branch of the organization tree behave as folders for the purpose of organizing the view of hosts and computers. As such, you can focus on any object in order to view only the hosts, computers, and other items, just as you can do in other ControlUp folders.

Folders in the Hypervisors branch of the organization tree exist to organize or segregate the hypervisor connections, if desired.

Drill down behavior for hosts

When you are in the Hosts View, if you double-click on a host it shows the VMs that are guests on that host. The list of computers shown varies slightly, depending on which hypervisor you are connected to.

In a VMware environment, you will see all of the VMs associated with that host, whether or not they are powered on, just as you would in the vSphere client.

In a XenServer environment, you will see VMs running on that host as well as VMs with an affinity for that host, whether or not they are powered on. VMs that are powered off and have no host affinity will not be seen when double-clicking on a host just as you would see in XenCenter, where they belong to the pool itself and not a host. In order to see all of the VMs in a XenServer pool regardless of power state or affinity, focus on the XenServer pool, and choose the Computers View without double-clicking on the Xen hosts in that pool.

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. App Load Time

Average load time for selected user-mode applications running on the computer, as defined in App Load Time tab of the Settings window.

Avg. Disk

Read Time

For all local disks, the average time, in milliseconds, of a read of data from the disk (Avg. Disk sec / Read performance counter).

Avg. Disk

Write Time

For all local disks, the average time, in milliseconds, of a write of data to the disk (Avg. Disk sec / Write performance counter).

Avg. Logon Duration

The average logon duration for all user sessions currently established on the computer.

AWS Instance

Indicates if the machine is an AWS instance

Computer Local Time

The local time on the managed computer

CPU

Processor utilization percentage

CPU Cores (OS)

Total number of CPU cores detected by the operating system

CPU Cores (VM)

Total number of vCPUs allocated to the VM by the hypervisor

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, requires ESXi 5.0 or greater)

CPU Logical Processors (OS)

Total number of logical processors detected by the operating system

CPU Logical Processors (VM)

Total number of logical processors allocated to the VM by the hypervisor

CPU Model

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. (‘runstate_full_contention’ needs to be explicitly enabled for each VM on XenServer)

Total number of virtual processor sockets allocated to the VM by the hypervisor

CPU Speed

Computer's CPU clock speed (in MHz)

CPU Swap Wait*

The percentage of time during which the VM is waiting on swapped memory pages to be read from disk. (VMware 5.x only, requires statistics level 3 for vCenter)

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

List of IP addresses retrieved by attempting to resolve the computer’s FQDN from the managed computer itself.

Domain DNS

DNS suffix of the computer

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

Dynamic Memory Avg. Pressure

The demand for more memory by the VM and its processes (Hyper-V only)

Dynamic Memory Enabled

Is Dynamic Memory enabled for the VM (Hyper-V only)

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

GPU Architecture

GPU's architecture name

GPU Available Memory

NVIDIA GPU available memory in megabytes (MB)

GPU Frame Buffer Size

Size of memory assigned to the NVIDIA GPU

GPU Frame Buffer Usage

NVIDIA GPU Frame Buffer usage in percents

GPU Memory Usage

NVIDIA GPU memory usage in percents

GPU Model

GPU name or NVIDIA GRID GPU profile type

GPU Number of Cores

Number of NVIDIA CUDA cores

GPU NVIDIA driver version

Current version of the installed NVIDIA GPU driver

GPU NVIDIA License Port

Primary NVIDIA license server port

GPU NVIDIA License Server

Primary NVIDIA license server name

GPU Usage

NVIDIA GPU usage in percents

GPU Video Decoder Usage

NVIDIA GPU video decoder usage in percents

GPU Video Encoder Usage

NVIDIA GPU video encoder usage in percents

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.

ICA Sessions Count

Number of ICA sessions currently established on the computer

Idle Sessions

Number of active user sessions which have been idle for at least 30 minutes (by default)

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

Maximum Memory

The maximum amount of RAM a VM can be assigned. (Hyper-V only)

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 Demand

The amount of memory demanded by processes in the VM (Hyper-V only)

Memory Status

Shows whether the host has enough memory to provide a full memory buffer to the VM (Hyper-V only)

Memory SwapIn 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.

Minimum Memory

The minimum amount of RAM a VM can be assigned. (Hyper-V only)

Model

Hardware model of the system

Name

Computer name

Net Received

Net Received is the rate at which data is received over all Ethernet adapters including framing characters. Net Received is based on the ‘Bytes Received/sec’ performance counter, converted to Mbps.

Net Sent

Net Sent is the rate at which data is sent over all Ethernet adapters including framing characters. Net Sent is based on the ‘Bytes Sent/sec’ performance counter, converted to Mbps.

Net Total

Net Total is the rate at which data is sent and received over all Ethernet adapters, including framing characters. Net Total is based on the ‘Bytes Total/sec’ performance counter which is the sum of the values of Network Interface\Bytes Received/sec and Network Interface\ Bytes Sent/sec, converted to Mbps.

Number of user sessions which are neither active, idle or disconnected

Pages/sec

Pages/sec is the rate at which pages are read from or written to disk to resolve hard page faults. This counter is a primary indicator of the kinds of faults that cause system-wide delays. It is the sum of Memory\Pages Input/sec and Memory\Pages Output/sec. It is counted in numbers of pages, so it can be compared to other counts of pages, such as Memory\Page Faults/sec, without conversion. It includes pages retrieved to satisfy faults in the file system cache (usually requested by applications) non-cached mapped memory files.

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 RAM Cache Usage

The size of the Citrix PVS RAM cache

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.

Session Disconnection Rate

Number of the disconnected sessions during the last minute

Sessions

Total number of sessions (including system and services)

Server

Indicates if the machine is a server

Startup Memory

The amount of RAM a VM starts with when turned on. (Hyper-V only)

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

Top Citrix License Utilization

For a Citrix License server, the utilization percentage of the most highly utilized Citrix license pool.

Total Read Rate (KBps)

Total number of kilobytes read from all of the computer's disks per second (on average) during the collection interval

Total Write Rate (KBps)

Total number of kilobytes written to all of the computer's disks per second (on average) during the collection interval

Uptime

Time elapsed since last boot

User Sessions

Number of user sessions on the machine, not including the system and services sessions

In Citrix XenDesktop, the version of Virtual Desktop Agent software installed on the current computer.

View Agent Version

The version of the vmWare View agent component, if installed.

Virtual Disk Avg. Latency

Average amount of time for a virtual disk read/write operation. If the VM has multiple disks attached, the value displayed belongs to the disk with the highest latency.

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.

For a suspended VM, shows the number of days since the VM was last suspended

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

Workstation

Indicates if the machine is a workstation

WorkItem Queue Ready Count (XenApp)

For Citrix XenApp XML brokers and controllers, the number of work items that are ready to be executed.

XD % Available Hypervisor Connections

For a XenDesktop Broker, the percentage of functional hypervisor connections (of the total number of connections)

XD AD Identity Service

For a XenDesktop Broker, the current status of the AD Identity service

XD Allocation Type

For a XenDesktop computer, denotes how the machines in the catalog are allocated to a user

XD Associated Users

For a XenDesktop computer, the list of users - current user(s) for shared machines and the assigned users for private machines

XD Average Logon Duration

For a XenDesktop computer, the average logon duration for all XenDesktop user sessions currently established on the computer

XD Broker

Indicates if the machine is a XenDesktop Broker

XD Broker Health

Indicates the overall status of the XenDesktop Broker

XD Broker Last Activity Time

The last reported activity time of the XenDesktop Broker service on the broker

XD Broker Last Start Time

The last start-up time of the XenDesktop Broker service on the broker

XD Broker Service

For a XenDesktop broker, the current status of the Broker service

XD Broker State

For a XenDesktop broker, the current value of the State attribute for the BrokerController object (Failed, Off, On, or Active)

XD Central Configuration Service

For a XenDesktop broker, the current status of the Central Config service

XD Computer Availability

For a XenDesktop computer, indicates if the machine is available for new connections (registered, not in maintenance mode, not in use (client VDA) with logons enabled and a functional server load)

XD Configuration Logging Database

For a XenDesktop broker, the current status of the Configuration Logging database connection

XD Configuration Logging Service

For a XenDesktop broker, the current status of the Configuration Logging service

XD Database Avg. Transaction Time

For a XenDesktop broker, the average time taken to execute a database transaction

XD Database Connected

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

XD Database Transaction Errors / sec

The rate in seconds at which XenDesktop database transactions are failing

XD Delegated Admin Service

For a XenDesktop broker, the current status of the Delegation Admin service

XD Delivery Group

In Citrix XenDesktop, the name of the desktop group to which the computer belongs

XD Delivery Type

For a XenDesktop computer, specifies the delivery type of the machines in the computer's delivery group

XD Desktop Kind

In Citrix XenDesktop, the desktop kind of the current computer

XD Failure Time

For a XenDesktop computer in a failure state, the time the failure occurred

XD Failure Type

For a XenDesktop computer in a failure state, indicates the reason for the fault

XD Farm Name

The name of the XenDesktop farm to which the computer belongs

XD Hosting Unit Service

For a XenDesktop broker, the current status of the Unit Service

XD in Use / Published Apps Ratio

Count of published XenDesktop applications currently in use on the computer, divided by the total count of applications published on the computer (in percentage)

XD Is Assigned

For a XenDesktop computer, denotes whether a private desktop has been assigned to a user/s or a client name/address

XD Is Physical

For a XenDesktop computer, indicates whether the computer is physical

XD Is Preparing

For a XenDesktop computer, indicates whether the computer is currently preparing

XD Last Licensing Server Event

Last significant Citrix licensing server event reported by the XenDesktop Broker service on the controller

XD Last Licensing Server Event Details

For a XenDesktop broker, additional details associated with the last significant Citrix licensing server event

XD Last Licensing Server Event Time

For a XenDesktop broker, the time at which the last significant Citrix licensing server event was reported

XD Last Registration Failure

For a XenDesktop computer, the last deregistration reason

XD Last Registration Failure Time

For a XenDesktop computer, the time of the last deregistration from the controller

XD Licensing Server State

The Citrix licensing server state currently in effect in the XenDesktop Broker service on the broker

XD License Grace Period Reasons

Current active or expired Citrix licensing grace periods in effect on the XenDesktop broker

XD License Grace Period State

The Citrix licensing grace state currently in effect in the XenDesktop Broker service on the broker

XD License Grace Period Times Remaining

Times remaining in currently active or expired Citrix licensing grace periods in effect of the XenDesktop broker, matched by order with the "reasons" column. Expired grace periods are indicated by zero remaining time

XD License Server

For a XenDesktop broker, indicates Citrix license server is available

XD Machine Catalog

In Citrix XenDesktop, the name of the machine catalog to which the current computer belongs

XD Machine Creation Services

For a XenDesktop broker, the current status of the Machine Creation Services service

XD Maintenance Mode

For a XenDesktop computer, denotes if the computer is in maintenance mode

XD Monitor Database

For a XenDesktop broker, the current state of the Monitor database

XD Monitor Service

For a XenDesktop broker, the current status of the Monitor service

XD Pending Image Update

In Citrix XenDesktop, indicates whether a new updated disk image has been assigned to the current computer

XD Persist User Change

For a XenDesktop computer, specifies how user changes are persisted on machines in the catalog

XD Provisioning Type

For a XenDesktop computer, the provisioning type for the computer's machine catalog

XD VDA

Indicates if the machine is a XenDesktop VDA

XD Registered Desktops

The number of XenDesktop VDAs registered with the Broker service on the broker

XD Registration

In Citrix XenDesktop, the registration state of the current computer against the connection broker

XD Remote PC Access

For a XenDesktop computer, indicates whether the computer is a personal published desktop with a VDA agent for remote access

XD Session Support

For a XenDesktop computer, specifies the session support of the machines in the catalog (single vs multi)

XD Site Database

For a XenDesktop broker, the current state of the site database connection

XD Site Name

For a XenDesktop computer, the name of the XenDesktop Site

XD Time in Registration

For a XenDesktop computer, the amount of time the computer has been in its current registration state

XenApp Published Applications Count

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:

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

Citrix XenApp server load as reported by the qfarm /load command

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 Published Application Count

In Citrix XenApp, the number of applications published on the current server.

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

Load

For Citrix XenApp servers only, the server load as reported by theqfarm /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):

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

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.

AWS Alarms in Alarm Status

Number of CloudWatch alarms associated with this EC2 instance which are currently in Alarm status

AWS Alarms in Insufficient Data Status

Number of CloudWatch alarms associated with this EC2 instance which are currently in Insufficient Data status

AWS Alarms in OK Status

Number of CloudWatch alarms associated with this EC2 instance which are currently in OK status

AWS Attached Elastic IP Hourly Cost

The per-hour cost for elastic IP addresses attached to this EC2 instance

AWS Attached Snapshot Hourly Cost

The estimated hourly cost for snapshots of volumes attached to this EC2 instance, based on the total size of a single snapshot per volume.

AWS Attached Storage Hourly Cost

The per-hour cost for storage volumes attached to this EC2 instance

AWS Catalog Price per Hour

The per-hour cost for this EC2 instance type and location, as per the AWS pricing catalog

AWS CPU Utilization

The percentage of allocated EC2 compute units that are currently in use on the instance. This metric identifies the processing power required to run an application upon a selected instance.

AWS Days to RI Expiration Date

For an instance that qualifies for utilizing an RI, this is the number of days remaining until the RI expiration date.

AWS Detailed Monitoring

Indicates whether detailed monitoring is enabled for the EC2 instance.

AWS Disk Read Operations

Average number of I/O read operations per second from all instance store volumes available to the EC2 instance.

AWS Disk Write Operations

Average number of I/O write operations per second to all instance store volumes available to the EC2 instance.

AWS EBS Optimized

Indicates whether EBS optimization has been enabled for this EC2 instance.

AWS EC2 Instance Hourly Cost

The hourly cost associated with this EC2 instance, RI discounts accounted for. Spot instances not supported and always show their catalog price.

AWS Elastic IP

The elastic IP address/es associated with the EC2 instance

AWS Host ID

The host ID configured for this EC2 instance, if applicable

AWS IAM Role

The IAM role associated with the EC2 instance, if applicable.

AWS Instance ID

A unique ID representing the EC2 instance

AWS Instance Lifecycle

Indicates whether this is a Spot Instance or a Scheduled Instance

AWS Instance Status

The health status of the EC2 instance, from the hosting perspective

AWS Instance Type

Describes the family and size of the EC2 instance, which determines the hardware resources allocated to it

AWS Kernel ID

For an EC2 instance, the operating system kernel associated with the AMI.

AWS Key Name

The private key used to pre-authenticate to the EC2 instance upon creation.

AWS Monthly Run Rate

The estimated monthly rate that you will be charged with, based on the calculation: [total hourly cost] * [number of days in month] * [24 hours]

AWS Network In

The average rate at which data was received on all network interfaces by the EC2 instance. This metric identifies the volume of incoming network traffic to an application on a single instance.

AWS Network Interface Description

The user-friendly description of network interfaces associated with the EC2 instance (for multiple interfaces, in order in which they appear in the Network Interfaces column)

AWS Network Interface Status

The status of network interfaces associated with the EC2 instance (for multiple interfaces, in order in which they appear in the Network Interfaces column)

AWS Network Interfaces

The technical IDs of network interfaces associated with the EC2 instance

AWS Network Out

The average rate at which data was sent out on all network interfaces by the EC2 instance. This metric identifies the volume of outgoing network traffic to an application on a single instance.

AWS Next Scheduled Events Code

The code of the next event scheduled for this EC2 instance

AWS Next Scheduled Events Date

The time of the next event scheduled for this EC2 instance

AWS Next Scheduled Events Description

The description of the next event scheduled for this EC2 instance

AWS Owner

The AWS account number of the AMI owner for this EC2 instance.

AWS Placement Group

The placement group of this EC2 instance

AWS Platform

The operating system platform of this EC2 instance.

AWS Private DNS

The private (internal) DNS name of the EC2 instance.

AWS Private IP

The private (internal) IP address of the EC2 instance.

AWS Public DNS

The public DNS name of the EC2 instance.

AWS Public IP

The public IP address of the EC2 instance.

AWS RAM Disk ID

For an EC2 instance, the RAM disk associated with the image, if applicable.

AWS Region

Name of the AWS region in which the EC2 instance resides

AWS Reservation

The reservation ID used to launch the EC2 instance.

AWS RI Expiration Date

For an instance that qualifies for utilizing an RI, this is the date of RI expiration

AWS RI Upfront Hourly Cost

For an instance that qualifies for utilizing an RI, this is the upfront sum payed from the RI divided by the number of hours in the reservation period.

AWS Root Device Name

For an EC2 instance, the system device name that contains the boot volume.

AWS Root Device Size

For an EC2 instance, the system device size

AWS Root Device Type

For an EC2 instance, the root volume is either an EBS volume or instance store volume.

AWS Security Group (ID)

The technical IDs of security groups to which the EC2 instance belongs.

AWS Security Group (Name)

The user-friendly names of security groups to which the EC2 instance belongs.

AWS Source/Dest Check

Indicates whether source / destination checks are performed on the network interfaces associated with this EC2 instance

AWS State

The current run state of the EC2 instance (running, rebooting, etc)

AWS State Transition Reason

The reason for the last change in the EC2 instance state.

AWS Status Checks

Proportion of status checks in the "passed" status for this EC2 instance

AWS Subnet

The ID of the subnet into which the EC2 instance was launched, if applicable.

AWS System Status

The health status of the operating system running in the EC2 instance

AWS Tags

List of tags assigned to the EC2 instance

AWS Tenancy

The tenancy type for this EC2 instance, determines whether the instance runs on dedicated hardware

AWS Total Hourly Cost

The per-hour total cost associated with this EC2 instance (sum of instance, attached storage, snapshots, and elastic IP costs)

AWS Uptime

Time when the EC2 instance was last started

AWS Virtual Network

The ID of the virtual private cloud (VPC) into which the EC2 instance was launched, if applicable.

AWS Virtualization Type

For an EC2 instance, the type of virtual machine running.

* – 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.

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 graphics2. To close the message automatically when a configured timeout has elapsed3. To stay on top of all other user’s windows4. To not allow the user to close the message window5. 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 repliesIf 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.

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.

XenDesktop Management > Enable Maintenance

Turns on XenDesktop maintenance mode for the selected computer/s (only applicable to VDAs retrieved from XenDesktop direct connection). Note: this action renders the machine inaccessible to users until maintenance mode is disabled.

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.

System and Services sessions (not displayed by default – use the “View Options” > “Show System Sessions” checkbox on the Ribbon Bar to change the default behavior)

When you switch to the Sessions view using the Sessions button on the Navigation Bar, the Information Grid will display all of the established user sessions on all of the computers you are currently connected to.

Note: Your active ControlUp license determines the number of sessions you may manage concurrently. For more information, please refer to the “ControlUp Licensing” chapter.

You can also switch to the Sessions view by double-clicking a computer’s row in the Information Grid of the Computers view. In this case, the Information Grid will display only the user sessions established on the computer you selected.

Sessions View Column Reference

The following information columns are available in the Information Grid while using the Sessions View.

Avg. App Load Time

Average load time of the last recorded samples for selected user-mode applications running in the user's session, as defined in App Load Time tab of the Settings window

Branch Name

Name of branch or organizational unit associated with the session Client IP address (configurable in the Branch Name tab of the Settings window).

Citrix Receiver Version

The current version of the Citrix Receiver installed on the client’s machine

Client IP

IP address of the computer from which the session was initiated

Client Name

Name of the computer from which the session was initiated

Computer

Name of the computer hosting the session

Connect Time

Time of session’s last switch to the “Active” state

CPU

Percentage of CPU consumed by this session

Desktop Load Time

The interval between the beginning of desktop initialization and the time the desktop became available to the user. This column is only applicable to full desktop sessions, not published application launches.

Disconnect time

Time of session’s last switch to the “Disconnected” state

Domain DNS

The name of the Active Directory domain of the user

GPU CPU Utilization

GPU CPU Utilization

GPU decoder Utilization

GPU decoder Utilization

GPU encoder Utilization

GPU encoder Utilization

GPU Frame Buffer Memory Utilization

GPU Frame Buffer Memory Utilization

Group Policy Load Time

The loading time of the user logon group policies, not including logon scripts.

I/O Read Operations per second

The rate at which the session is issuing read I/O operations. This counter counts all I/O activity generated by the session to include file, network and device I/Os.

I/O Write Operations per second

The rate at which the session is issuing Write I/O operations. This counter counts all I/O activity generated by the session to include file, network and device I/Os.

ID

Session ID number

Idle Time

Time elapsed since last user input was received in session

Initial Program

Name of the published application used in the session (if appl.)

Logon Duration

The interval between the end of the user’s authentication and the time when the desktop became available to the user, or when a published application was launched.

Logon Duration – Other

The time taken by logon scripts, 3rd party profile management solutions, and other components that delayed the logon process.

Logon Time

Time of session establishment

Memory (Private Bytes)

Non-sharable memory committed to processes in session

Memory (Working Set)

Total Working Set of all processes in the session

Page Faults/sec

Number of Page Faults per second in the session

Processes

Number of processes currently running in this session

Profile Load Time

The loading time of the Windows user profile for the session.

Protocol Bandwidth – Last Recorded

For an active PCoIP or ICA session, the overall bandwidth for incoming/outgoing PCoIP or ICA packets averaged over a one second sampling period.

Protocol Bandwidth Limit

The maximum bandwidth available for the traffic associated with the session, as defined by the administrator (ICA/HDX and PCoIP sessions only).

Protocol Bandwidth – Session Avg

The average of the last 20 "Protocol Bandwidth – Last Recorded" samples for the user session.

Protocol Latency – Last Recorded

For an active ICA session, the last reading of the protocol latency between the client and the server.

When the session is idle for more than 1 minute, this column will show N/A. Please see the following Citrix forum post for more details on the reasons for this computation:

In VMware Horizon View, the URL of the View Connection Server the View Client is attached to.

View Client Domain

In VMware Horizon View, the AD domain of the workstation running the View Client

View Client Protocol

In VMware Horizon View, the protocol used by the View Client to attach to the VM

View Client Tunnel

In VMware Horizon View, whether or not the View Client is using a secure tunnel

View Client Type

In VMware Horizon View, the OS type of the workstation running the View Client

XD Anonymous

For a XenDesktop session, indicates whether the session is of an anonymous user

XD Applications In Use

For a XenDesktop session, the name of the published application/s in the session

XD Authentication Duration

For a XenDesktop session, the authentication duration in milliseconds

XD Brokering Date

For a XenDesktop session, time stamp of brokering time

XD Brokering Duration

For a XenDesktop session, brokering duration calculation in milliseconds

XD Client Session Validate Date

For a XenDesktop session, time stamp of Client Session Validated

XD Connected Via HostName

For a XenDesktop session, the host name of the gateway, router or client via which the connection is established

XD Connected Via IPAddress

For a XenDesktop session, the IP address of the gateway, router or client via which the connection is established

XD Disconnect Date

For a XenDesktop session, time stamp of Disconnect event

XD Disconnect Reason

For a XenDesktop session, the reason for the session disconnection

XD Establishment Date

For a XenDesktop session, time stamp recorded on the Broker at the point when the VDA confirms session connect / reconnect maps to Resolution Time in Desktop Director UI

XD Group Policy Load Time

For a XenDesktop session, the duration of the Group Policy load time

XD HDX Connection Load Time

For a XenDesktop session, the duration of the HDX load time

XD Interactive Session Load Time

For a XenDesktop session, duration of Interactive load time

XD Launched Via HostName

For a XenDesktop session, the host name of the StoreFront server used to launch the session

XD Launched Via IPAddress

For a XenDesktop session, the IP address of the StoreFront server used to launch the session

XD Logon Duration

For a XenDesktop session, the total logon duration for this session (in milliseconds)

XD Logon Scripts Load Time

For a XenDesktop session, the duration of the Logon Scripts Load Time

XD Profile Load Time

For a XenDesktop session, the duration of the Profile load time

XD Secure ICA Session

For a XenDesktop session, indicates whether SecureICA is active in the session

XD Server Session Validate Date

For a XenDesktop session, time stamp of Server Session Validated

XD Session Create Time

Time the session started (logon)

XD Session Reconnected

For a XenDesktop session, indicates whether this connection is a reconnection to an existing session

XD Session Type

For a XenDesktop session, the type of the session (Application or Desktop)

XD Site Name

For a XenDesktop computer, the name of the XenDesktop Site

XD UPN

For a XenDesktop session, the User Principal Name (username@domainsuffix)

XD VM Start Duration

For a XenDesktop session, the duration of the Start of the VM

Sessions Actions

These actions are available when selecting a session or a group of sessions. The actions can be invoked using either the Ribbon Bar “Actions” button, the context menu (right-click), or the Actions Panel.

Manage Registry

When invoked from the Sessions view, the Registry Controller enables viewing and editing the HKEY_CURRENT_USER registry hive(s) corresponding to the selected user session(s). For more information about the Registry Controller, please see the Controllers Pane chapter.

Manage Programs and Updates

When invoked from the Sessions view, the Programs and Updates Controller enables viewing the programs installed for each user who has a session established on one of your managed computers. For more information about the Programs and Updates Controller, please see the Controllers Pane chapter.

Remote Desktop to Computer

Switches the display to the Remote Desktops pane and establishes a Remote Desktop session on the computer on which the selected user session is hosted.

Chat

With ControlUp, you can open a text chat session with any user currently logged on in your system. Both you and the end user will be presented with a chat window and the chat session will continue until terminated by closing the window.

Remote Assistance

ControlUp can be used to establish Remote Assistance sessions for support and troubleshooting purposes. Upon first use of this action, you will be required to configure a password for the remote assistance invitation. During the connection attempt, the end user will receive a confirmation dialog box requesting permission for you to connect to the assistance session. Please keep in mind that this action utilizes the built-in Windows Remote Assistance capabilities, which should be enabled on the target computer. If the Remote Assistance is blocked by policy or is not installed as a feature, ControlUp is capable of enabling / installing it remotely with your approval.

Note: A known issue exists when establishing Remote Assistance sessions on Windows XP and Windows Server 2003 computers that were cloned without using the Microsoft Sysprep utility. If your Remote Assistance request fails, please verify that the Sysprep utility has been executed after cloning / imaging the target system.

Terminal Services (sessions actions category)

Disconnect Session

This action Issues a disconnect command for the selected session(s). The session(s) will then be handled according to your Terminal Services configuration and Group Policy (left disconnected or logged off after a timeout). The end user is not notified of this action.

Log Off Session

This action invokes a log off process for the selected session(s), closing all currently open programs. The end user is not notified of this action.

Shadow Session

Using this action, you can establish a remote control session that will allow you to view the activity and collaborate with the target user. This is achieved using the session shadowing mechanism, which needs to be enabled on the target RDS. In order to shadow Citrix ICA sessions, the Citrix Online Plugin needs to be installed on the computer on which you are running the ControlUp console.

Note: When shadowing a user session on a RDS, a new session will be opened for you on that server. This session will log off automatically when the session shadowing is finished.

Note: Various issues not related to ControlUp may prevent your session shadowing from working correctly. Please see the Troubleshooting chapter in this document to check for possible resolutions.

Send Super-Message

A Super-Message is a rich-text message that can include graphics, text formatting, and various display options. Super Messages can be configured to allow user feedback, to disappear automatically after a configured period of time, or to be displayed on top of other windows.

Send Message

This action sends a standard “net send”-style message to the selected user session.

Get Session Screenshot

This action allows you to get a quick screenshot of the user’s activity for support or troubleshooting purposes. The selected session has to be active and unlocked for this operation to complete successfully. This operation can be performed in the following modes:

1. User approval – the end user(s) will be presented with a warning message asking for approval of the administrator’s attempt to receive a screenshot of the user’s current activity.

2. User notification – the end user(s) will be presented with a warning message stating that the administrator has requested to receive a screenshot of the user’s current activity. No user approval is needed.

3. No notification – the end user(s) will not be notified of the action.

Note: Please respect the regulations effective in your region and/or organization in regard to the users’ privacy. From a privacy standpoint, it is general practice to request the users’ permission before obtaining a screenshot of their activity. If your user environment involves sensitive or classified activity, it is recommended that you configure the screenshot restriction, as explained below.

If your company policy states that users must be notified before taking a screenshot of their activity or if taking screenshots of user activity is prohibited altogether, you can restrict this action using ControlUp’s Security Policy. This can be achieved either by denying the relevant “Get Session Screenshot” permission explicitly or by configuring it to “Not set”.

Organizations in which ControlUp was upgraded from version 2.0 may have a server-side restriction on taking screenshots of user activity, resulting from an explicit request from the organization. In such a case, the Security Policy will not allow you to change the “Get Session Screenshot” permission. In order to remove or alter this restriction, please contact Smart-X Support.

If you are using ControlUp in Offline Mode, you may restrict this functionality when requesting an Offline License file. In your request e-mail, please state that you would like to restrict taking screenshots of user activity, including the restriction level (without the user’s permission or altogether), and your Offline License file will be issued with the restriction you require.

Group Policy (sessions actions category)

Refresh User Group Policy

This action triggers a Group Policy update on the remote user session using Windows built-in GPUPDATE utility with /Target:User parameter. You can manipulate the “Force” and “Timeout” parameters using the action window.

Kill Policy

This action removes any group policy restrictions applied to the target user(s) environment, such as start menu restrictions, blocked locations in Windows Explorer, etc. This can be useful during support sessions in order to allow a user to perform actions normally blocked by Group Policy.

Since the user’s shell (explorer.exe) is restarted when this action is performed, the user will experience a brief disappearance of the Start Manu and taskbar as well as the closing of any open Windows Explorer windows.

Reapply Group Policy

Reapplies Group Policy restrictions previously removed by the “Kill User Group Policy” action. The user’s shell will be restarted again when this action is performed.

Registry (sessions actions category)

Registry Import

This action performs an import of a given .reg file to the HKEY_CURRENT_USER hive of the target user session(s). This action is not available as part of the Registry Controller in the Sessions View.

Processes (sessions actions category)

Start Process in Session

This action allows you to launch a process inside the selected user session(s). You can run any executable that is accessible by the user(s) on the target computer(s). If using a command-line expression or a batch file, please prepend “cmd.exe /c ” to your command. This action will work correctly only if the target end user(s) has appropriate permissions to launch the selected process.

Note: processes started using ”Run Process” action are executed interactively inside the user’s session, so all command output and launched windows will be visible to the user. In order to launch system-level tasks that will be invisible to the user, use the “Run As” command in the Computers view.

Script-based Actions

Invokes any Script-based Actions downloaded or created for use in your organization and configured to be applicable to Sessions. For more details, please refer to the Script-based Actions chapter.

Go to

Using this submenu, you can quickly switch the current view to the Computers View, while selecting the computer on which the selected user session is hosted.

The Processes View is an aggregated view of all Windows processes running on all of your managed computers. When unfiltered, this view will act like a Task Manager connected to your entire ControlUp organization, allowing you to compare and analyze the state of all processes, across all machines. This view’s data table is the most densely populated view in ControlUp, potentially including hundreds of thousands of records.

Processes View Column Reference

The following information columns are available in the Information Grid while using the Processes View.

Affinity

Allowed processors to run the process

Application Load Time

The time elapsed between the process start time and the time the application's UI is ready for the user

Browser URL

For processes corresponding to Internet Explorer tabs, the active URL/s.

Browser URL Domain

For processes corresponding to Internet Explorer tabs, the domain/s of the active URL/s.

Command Line

Command used to launch the process, including arguments

Company

Name of executable’s publisher

Computer

Name of computer running the process

CPU

CPU percentage consumed by process

Created Time

Process executable creation time (as recorded in the file system)

Description

Executable file description

Disk Read KB/s

Number of KB per second read by the process

Disk Write/s

Number of KB per second written by the process

Exe Path

Full path and name of executable

Exe Size (KB)

Size on disk of the executable file

Exe Version

Executable version as recorded in executable’s properties

Exit Code

Exit code of process (displayed briefly after process is terminated)

Exit Time

Time of process termination (displayed briefly after process is terminated)

GPU decoder Utilization

GPU decoder Utilization

GPU encoder Utilization

GPU encoder Utilization

GPU Frame Buffer Memory Utilization

GPU Frame Buffer Memory Utilization

GPU Utilization

GPU Utilization

I/O Read Operations

The count of read I/O operations issued by the process since its start time.

I/O Read Operations per second

The rate at which the process is issuing read I/O operations. This counter counts all I/O activity generated by the process to include file, network and device I/Os.

I/O Write Operations

The count of write I/O operations issued by the process since its start time.

I/O Write Operations per second

The rate at which the process is issuing write I/O operations. This counter counts all I/O activity generated by the process to include file, network and device I/Os.

Memory (Private Bytes)

Amount of non-sharable memory allocated to process

Memory (Working Set)

Process’s memory working set

Modified Time

Process executable modification time (as recorded in the file system)

Name

Process image name

Network Sent KB/s

Number of KB per second sent by the process

Network Received KB/s

Number of KB per second received by the process

Network Recived Total

Total KB received by the process since the collection has been started

Page faults / sec

Page Faults per second consumed by a process

PID

Process ID number

Priority

CPU priority of the process

Process Type

Bitness (32 / 64 bit) of the operating system

Product Name

Product name as recorded in executable’s properties

Product Version

Product version as recorded in executable’s properties

Session ID

Parent session ID number

Start Time

Time process started

Stress Level

An aggregated measure of the session’s performance columns, as configured for the current record in the Stress Settings.

User

Username of the account used to launch the process

Processes Actions

These actions are available when selecting a process or multiple processes. The actions can be invoked using either the Ribbon Bar “Actions” button, the context menu (right-click), or the Actions Panel.

Remote Desktop to Computer

Switches the display to the Remote Desktops pane and establishes a Remote Desktop session on the computer on which the selected process is hosted.

Remote Desktop Services > Send Message

This action sends a standard “net send”-style message to the user session in which the selected process is executed.

Get Session Screenshot

This action allows you to get a quick screenshot of current activity inside the session in which the selected process is executed. The selected session has to be active and unlocked for this operation to complete successfully. This operation can be performed in the following modes:

1. User approval – the end user(s) will be presented with a warning message asking for approval of the administrator’s attempt to receive a screenshot of the user’s current activity.2. User notification – the end user(s) will be presented with a warning message stating that the administrator has requested to receive a screenshot of the user’s current activity. No user approval is needed.3. No notification – the end user(s) will not be notified of the action.

Note: Please respect the regulations effective in your region and/or organization in regard to the users’ privacy. From a privacy standpoint, it is general practice to request the users’ permission before obtaining a screenshot of their activity. If your user environment involves sensitive or classified activity, it is recommended that you configure the screenshot restriction, as explained below.

End Process

Gracefully terminates the selected process, after waiting for a configured timeout period (default is 60 seconds).

Kill Process

Forcefully terminates the selected process, without waiting for response.

PSKill Process

Forcefully terminates the selected process using the SysInternals PSKill utility, without waiting for response.

Set Process Priority

Changes the base priority for the selected process.

Script-based Actions

Invokes any Script-based Actions downloaded or created for use in your organization. For more details, please refer to the Script-based Actions chapter.

Go to > Computer

Switches to the Computers View and selects the computer on which the selected process is executed.

Go to > Session

Switches to the Sessions View and selects the user session in which the selected process is executed.

The Accounts View is an aggregated view of all users who have established sessions on all of your managed computers, grouped by the user name.

This view displays all users currently active in your environment, along with statistics that enable the identification of top resource consumers and other user-related trends in your enterprise.

Accounts View Column Reference

The following information columns are available in the Information Grid while using the Executables View.

Avg. App Load Time

Average load time for selected user-mode applications for the user account, as defined in App Load Time tab of the Settings window

Computers

Total number of machines on which the user account is currently running processes

CPU

Average percentage of CPU consumed by user on all machines on which at least one process in owned by this user

Memory (Private Bytes)

Total non-sharable memory consumed by this user account on all machines

Name

User account name

Page faults / sec

Total Page Faults / sec consumed by this user account on all machines

Processes

Total number of processes launched by this user account

Sessions

Total number of sessions of this user account

Stress Level

An aggregated measure of the account’s performance columns, as configured for the current record in the Stress Settings.

User AD OU

The name of the OU in which the user object is located in Active Directory

XD Apps in Use

For XenDesktop sessions, the unique names of all published applications the account is currently running

XD Apps in Use Count

For XenDesktop sessions, the number of published applications in all sessions

Accounts Actions

These actions are principally equivalent to their counterparts on the Sessions View. When invoked from the Accounts View, these actions are performed in parallel on all the instances of the selected accounts.

Note: By selecting an account and executing the “Log off” action, you will terminate all user sessions established by that account on all managed computers. This logic applies to all management actions on the Accounts View. You should therefore use the Accounts actions with care.

The actions can be invoked using either the Ribbon Bar “Actions” button, the context menu (right-click), or the Actions Panel.

Manage Registry

When invoked from the Accounts view, the Registry Controller enables viewing and editing the HKEY_CURRENT_USER registry hive(s) corresponding to all the user sessions established using the selected user account. For more information about the Registry Controller, please see the Controllers Pane chapter.

Manage Programs and Updates

When invoked from the Sessions view, the Programs and Updates Controller enables viewing the programs installed for the selected account, across all your managed computers. For more information about the Programs and Updates Controller, please see the Controllers Pane chapter.

Remote Desktop Services (accounts actions category)

Disconnect Session

This action Issues a disconnect command for all user sessions established using the selected account.. The sessions will then be handled according to your Remote Desktop Services configuration and Group Policy (left disconnected or logged off after a timeout). The end user is not notified of this action.

Log Off Session

This action invokes a log off process for all user sessions established using the selected account, closing all currently open programs. The end user is not notified of this action.

Send Super-Message

A Super-Message is a rich-text message that can include graphics, text formatting, and various display options. Super Messages can be configured to allow user feedback, to disappear automatically after a configured period of time, or to be displayed on top of other windows.

Send Message

This action sends a standard “net send”-style message to all user sessions established using the selected account.

Group Policy (sessions actions category)

Kill Policy

This action removes any group policy restrictions applied to the target user(s) environment, such as start menu restrictions, blocked locations in Windows Explorer, etc. This can be useful during support sessions in order to allow a user to perform actions normally blocked by Group Policy.

Since the user’s shell (explorer.exe) is restarted when this action is performed, the user will experience a brief disappearance of the Start Manu and taskbar as well as the closing of any open Windows Explorer windows.

Reapply Group Policy

Reapplies Group Policy restrictions previously removed by the “Kill User Group Policy” action. The user’s shell will be restarted again when this action is performed.

Script-based Actions

Invokes any Script-based Actions downloaded or created for use in your organization and configured to be applicable to Accounts. For more details, please refer to the Script-based Actions chapter.

The Processes View is an aggregated view of all Windows processes running on all of your managed computers, grouped by the process name and version.

This view displays all applications currently executed in your environment, along with statistics that enable the identification of top resource consumers and other application-related trends in your enterprise.

Executables View Column Reference

The following information columns are available in the Information Grid while using the Executables View.

Avg. Memory per Process

Average RAM consumed by processes with this image name on all managed machines

Avg. App Load Time

Average load time for all instances of the user-mode application, as defined in App Load Time tab of the Settings window

Computers

Total number of machines on which this executable is currently running

CPU

Average percentage of CPU consumed by this executable on all machines on which it is currently launched

I/O Read Operations/sec

Average amount of read I/O operations (file, network, and device) generated per second by all processes with this image name and version on all managed computers

I/O Write Operations/sec

Average amount of write I/O operations (file, network, and device) generated per second by all processes with this image name and version on all managed computers

Maximum Memory per Process

Maximum RAM consumed by a process with this image name on all managed machines

Memory (Private Bytes)

Total non-sharable memory consumed by this executable on all machines

Memory (Working Set)

Total memory working set consumed by this executable on all machines

Minimum Memory per Process

Minimum RAM consumed by a process with this image name on all managed machines

Name

Process image name

Page faults / sec

Total Page Faults / sec consumed by this executable on all machines

Processes

Total number of processes with this image name on all managed machines

Product Version

Product version as recorded in executable’s properties

Stress Level

An aggregated measure of the executable’s performance columns, as configured for the current record in the Stress Settings.

XD Active Sessions

Number of active sessions running the XenDesktop published application

XD App Instances Count

For a XenDesktop published application, count of its running instances

XD App State

Indicates if the XenDesktop published application is enabled

XD Available / Published Ratio

For a XenDesktop published application, count of computers on which the application is available (from the XenDesktop perspective), divided by the total count of computers on which the application is published.

XD Available On Count

For a XenDesktop published application, the number of computers on which the application is published (not necessarily running) and which are available from the XenDesktop perspective

XD Disconnected Sessions

Number of disconnected sessions running the XenDesktop published application

XD managed / running ratio

For a XenDesktop published application, percentage of computers running the XenDesktop published application on which ControlUp agent is installed

XD Published App Created

The creation timestamp of the XenDesktop published application

XD Published App Name

The XenDesktop published application's name shown to the user (Browser Name or Application Name)

XD Published On Count

For a XenDesktop published application, count of computers the application is published on

XD Running / Available Ratio

For a XenDesktop published application, count of computers currently running the application divided by the number of computers on which the application is published and which are available from the XenDesktop perspective

XD Running / Published Ratio

For a XenDesktop published application, count of computers currently running the application divided by the number of computers on which the application is published.

If you would like to shadow the Terminal Server console (session 0) in a Terminal Server session, and you do not want to be prompted for permission, set the local Group Policy on the server that is running Terminal Services.

To shadow other sessions, on the RDP-TCP Properties dialog box, on the Remote Control tab, click to clear the require users permission check box. This does not affect the console session.

To remote control the console with no prompt for approval:

Open Group Policy Editor (Gpedit.msc) on the server that is running Terminal services.