• Folders View & Actions

    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

    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.

    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

    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.

    Folder Path

    Location of the folder in the organization tree.

    Hosts

    Total number of virtualization hosts

    Hosts CPU

    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

    Page Faults/sec

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

    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 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 Message
    This action allows administrators to send a plain text message to all the users on all managed computers in the selected folder(s).

    Send Super Message
    This 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 graphics
    2. To close the message automatically when a configured timeout has elapsed
    3. To stay on top of all other user’s windows
    4. To not allow the user to close the message window
    5. To allow the user to respond to the message:
    6. To use pre-configured reply buttons (such as Yes;No or OK;Cancel)
    7. To allow free text replies
    If the user response option is enabled, a window will open displaying all of the users’ feedback gathered by the Super Message.

    Refresh Machine Group Policy
    This 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 execution
    This 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 Execution
    This 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 As
    This 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.

  • Hosts View & Actions

    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)

    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)

    CPU Cores

    Total number of CPU cores in the host.

    CPU Sockets

    Total number of physical processors in the host.

    CPU Usage %

    Actively used CPU cycles of the host as a percentage of the total available CPU cycles on the host.

    Datastore R/W IOPs

    Aggregate number of IO operations on the datastore. The value displayed belongs to the datastore with the highest number of IOPs

    (Xen: off by default – must enable on all SRs on all hosts [xe host-data-source-record data-source=iops_total_<sr-short-uuid> uuid=<host-uuid> ] )

    Datastore Read latency

    Average amount of time for a read operation from the VMware datastore. The value displayed belongs to the datastore with the highest read latency. (VMware only)

    Datastore Read Rate

    Rate of reading data from the datastore or SR. The value displayed belongs to the datastore with the highest read rate.

    (Xen: off by default – must enable on all SRs on all hosts [xe host-data-source-record data-source=io_throughput_read_<sr-short-uuid> uuid=<host-uuid> ] )

    Datastore Write latency

    Average amount of time for a write operation to the VMware datastore. The value displayed belongs to the datastore with the highest write latency. (VMware only)

    Datastore Write Rate

    Rate of writing data to the datastore or SR. The value displayed belongs to the datastore with the highest write rate.

    (Xen: off by default – must enable on all SRs on all hosts [xe host-data-source-record data-source=io_throughput_write_<sr-short-uuid> uuid=<host-uuid> ] )

    (VMware 4.1: requires statistics level 3)

    Disk device latency

    Average amount of time, in milliseconds, to complete a SCSI command from the physical device (block storage only). The value displayed belongs to the disk with the highest latency. (VMware only)

    Disk kernel latency

    Average amount of time, in milliseconds, spent by the VMkernel processing each SCSI command (block storage only). The value displayed belongs to the disk with the highest latency. (VMware only)

    Disk Queue Depth

    Average amount of time spent in the VMkernel queue, per SCSI command, during the collection interval (block storage only). The value displayed belongs to the disk with the highest latency.

    (Xen: disabled by default – must enable on all SRs on all hosts [xe host-data-source-record data-source=avgqu_sz_<sr-short-uuid> uuid=<host-uuid> ] )

    Folder Path

    The location of the hypervisor in ControlUp organizational hierarchy

    Hypervisor Platform

    The hypervisor platform type for the host

    Hypervisor Version

    Hypervisor version

    Installed Memory

    The amount of physically installed RAM on the host.

    Max Free Space Datastore

    Amount of free space available on the least occupied datastore

    Min Free Space Datastore

    Amount of free space available on the most occupied datastore

    Name

    The name of the virtualization host

    NIC dropped received packets

    Number of received packets dropped during the collection interval.

    (Xen: disabled by default – must enable for each NIC to track (eth0, eth1, etc) [xe host-data-source-record data-source=pif_eth0_rx_errors uuid=<host-uuid> ] )

    NIC dropped transmitted packets

    Number of transmitted packets dropped during the collection interval.

    (Xen: disabled by default – must enable for each NIC to track (eth0, eth1, etc) [xe host-data-source-record data-source=pif_eth0_tx_errors uuid=<host-uuid> ] )

    NIC received packets errors

    Number of inbound packets with errors. If the error counts grow rapidly you might have too much load on the system or some problem in end- to-end connectivity (including hardware)

    NIC transmitted packets errors

    Number of outbound packets with errors. If the error counts grow rapidly you might have too much load on the system or some problem in end- to-end connectivity (including hardware)

    NIC Usage

    Sum of data transmitted and received across all physical NIC instances connected to the host.

    Running VM Count

    Number of VMs running on this host.

    Storage Repository total latency

    Average amount of time for an operation (read or write) to the XenServer SR. The value displayed belongs to the SR with the highest latency. (XenServer only)

    (Xen: disabled by default – must enable on all SRs on all hosts [xe host-data-source-record data-source=latency_<sr-short-uuid> uuid=<host-uuid> ] )

    Stress Level

    Stress Level is a flexible load measure which you can customize using the "Stress Settings" pane

    Unmanaged VM Count

    Number of VMs on the host that are not managed by ControlUp.

    vCPU/pCPU Ratio

    Shows the ratio of the total number of vCPUs assigned to all VMs running on a host, to the number of physical cores

    VM Count

    Number of VMs assigned to this host.

    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.
  • Computers View & Actions

    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.

    Computer Local Time

    The local time on the managed computer

    CPU

    Processor utilization percentage

    CPU Count

    Number of CPUs

    CPU Excessive SMP use*

    The percentage of time during which the VM is ready to run but unable to do so due to co-scheduling constraints. Also known as Co-Stop. Only valid for VMs with more than one vCPU. (VMware only, requires ESXi 5.0 or greater)

    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)

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

    Disconnected

    Sessions

    Number of sessions in the “Disconnected” state

    Disk Queue

    Average disk queue length for all physical disks

    Disk Reads / sec

    Disk Reads/sec is the rate of read operations on the disk. (Disk Reads / sec performance counter).

    Disk Transfers / sec

    Disk Transfers/sec is the rate of read and write operations on the disk. (Disk Transfers / sec performance counter).

    Disk Writes / sec

    Disk Writes/sec is the rate of write operations on the disk. (Disk Writes / sec performance counter).

    DNS A Records

    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

    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.

    Non-paged Pool Memory

    The size, in Megabytes, of the non-paged pool memory

    Operating

    System

    Operating system version

    Organization

    Company name for the registered user of the operating system

    OS Service

    Pack

    Operating system service pack version

    Other Sessions

    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)

    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.

    Uptime

    Time elapsed since last boot

    User Sessions

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

    VDA Version

    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.

    VM Name*

    The name of the virtual machine, as seen by the hypervisor.

    VM Power State*

    The current power state of the virtual machine.

    VM Tools State*

    The state of the virtualization tools package inside the guest OS. (VMware only)

    VM Tools Version*

    The current version of the virtualization tools package inside the guest OS.

    VM Tools Version State*

    Indicates whether the virtualization tools package inside the guest OS is up to date.

    Warning Rate

    Marginal rate of warning events in the system logs

    Windows

    Directory

    Value of the %WINDIR% environment variable

    WorkItem Queue Ready Count (XenApp)

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

    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

    The DNS host name of the controller that the machine is registered to. Can be null if not brokered

    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 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 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:

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

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

    XenApp Datastore Connection Failure

    For a Citrix XenApp server, the number of minutes that the server has been disconnected from the data store.

    XenApp

    Edition

    For a Citrix XenApp server, the currently installed edition of XenApp.

    XenApp Farm

    For a Citrix XenApp server, the name of the server farm to which the server belongs.

    XenApp

    License Check-Out Time(Citrix XenApp)

    For a Citrix XenApp server, displays the last recorded Citrix license check-out response time in milliseconds.

    XenApp

    License Server Connection Failure(Citrix XenApp)

    For a Citrix XenApp server, displays the number of minutes that XenApp has been disconnected from the License Server.

    XenApp Load

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

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

    HKEY_LOCAL_MACHINE\SOFTWARE\Smart-X\ControlUpAgent\QFarmCounters

    Value Name: zeroLoadFactor

    Value Type: REG_DWORD

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

    XenApp Server

    Logon Mode

    For Citrix XenApp servers only, logon mode as reported by the qfarm /load command (available starting XenApp version 6.5)

    XenApp

    Version

    For a Citrix XenApp server, the currently installed version of XenApp.

    XenApp Worker

    Group

    For a Citrix XenApp server, the name of the Worker Group to which the server belongs.

    XenApp Zone

    For a Citrix XenApp server, the name of the zone to which the server belongs.

    XenApp Zone

    Data Collector

    For a Citrix XenApp server, the name of the current zone data collector for the zone to which the server belongs.

    XenDesktop

    Database Connected

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

    XenDesktop

    Database Transaction Errors / sec

    The rate per second at which XenDesktop Database transactions are failing.

    XenDesktop

    Desktop Group

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

    XenDesktop

    Desktop Kind

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

    XenDesktop Desktop State

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

    XenDesktop

    Farm Name

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

    XenDesktop

    MCS Image out of Date

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

    XenDesktop

    VDA Version

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

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

     

    The Stress Level Column

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

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

    Investigating the Causes for Stress Level Values

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

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

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

    Computers View Actions

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

    Note: processes started using this action are executed in session 0 using Local System and are not visible to the users working on the target computer(s). For executing interactive processes, use the “Start Process in Session” action described in the Sessions View chapter.

    Agent Control > Uninstall Remote Agent

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

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

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

    Agent Control > Agent Properties*

    *only available in the organization tree

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

    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.

  • Sessions View & Actions

    The Sessions view is designed to display and manipulate user connections on your network.

    The following types of sessions can be managed and monitored by ControlUp:

    1. Local console sessions (users working physically at the computer)
    2. Remote console sessions (RDP connections to the console of the computer)
    3. RDS connections (Sessions established using RDP on a Terminal / Remote Desktop Services host)
    4. Citrix HDX/ICA sessions on XenApp / Presentation Server computers
    5. Citrix HDX/ICA sessions on XenDesktop VDI stations
    6. VMware View Horizon user sessions (PCoIP or RDP)
    7. 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

    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:

    http://discussions.citrix.com/topic/309798-how-to-interpret-ica-performance-monitor-counters/

    Protocol Latency - Session Average

    The average of the last 20 samples of either "Protocol Latency - Last Recorded" or "PCoIP Latency - Last Recorded"

    Session create time

    For a XenDesktop session, time the session started (logon)

    Session name

    Session name (protocol, number)

    State

    Current state of the session (active, disconnected, etc.)

    Stress Level

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

    User

    User name of the session’s owner

    User AD DN

    The full DN path of the user object in Active Directory

    User AD OU

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

    User Full Name

    The display name of the user object in Active Directory

    User Logon Server

    The name of the Active Directory domain controller used to authenticate the user account during logon.

    View Client Connection Server URL

    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.

  • Processes View & Actions

    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

    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

    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)

    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

    Page faults / sec

    Page Faults per second consumed by 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

    User name 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.

  • Applications View

    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.

     

  • Accounts View & Actions

    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

    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.