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:
- Local console sessions (users working physically at the computer)
- Remote console sessions (RDP connections to the console of the computer)
- RDS connections (Sessions established using RDP on a Terminal / Remote Desktop Services host)
- Citrix HDX/ICA sessions on XenApp / Presentation Server computers
- Citrix HDX/ICA sessions on XenDesktop VDI stations
- VMware View Horizon user sessions (PCoIP or RDP)
- 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 |
Bandwidth Avg |
The average of the last 20 "Protocol Bandwidth – Last Recorded" samples for the user session |
Bandwidth Last |
For an active PCoIP or ICA session, the overall bandwidth for incoming/outgoing PCoIP or ICA packets averaged over a one second sampling period |
Bandwidth Limit |
The maximum bandwidth available for the traffic associated with the session, as defined by the administrator (ICA/HDX and PCoIP sessions only) |
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 |
Disk Read KB/s |
Number of KB per second read by all user's processes in the session |
Disk Write KB/s | Number of KB per second written by all user's processes in the session |
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 |
Idle Time (Min) |
Time elapsed since last user input was received in session |
Initial Program |
Name of the published application used in the session (if appl.) |
Latency Avg |
The average of the last 20 samples of “Protocol Latency – Last Recorded“ |
Latency Last |
For an active ICA or PCoIP session, the last reading of the protocol latency between the client and the server. When the ICA session is idle for more than 1 minute, this column will show N/A. |
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 |
Network Received KB/s |
Number of KB per second received by all user's processes in the session |
Network Sent KB/s |
Number of KB per second sent by all user's 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 |
For a XenDesktop session, the protocol that the session is using (HDX, RDP, or Console) |
Resource Consumption Score |
Shows the worst color indication from the following monitored columns: |
RTT |
The round trip time since the user interaction till the graphical response being displayed, and not just until the network response (as in network latency). |
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 Input Delay |
Measures the time it takes for a user input to reach the application. |
User Logon Server |
The name of the Active Directory domain controller used to authenticate the user account during logon. |
UX Score |
Shows the worst color indication from the following monitored columns:Logon Duration,Protocol Latency -Session Avg,Protocol Bandwidth,Session Avg,Logon Time,Profile Load Time,Group Policy Load Time,Desktop Load Time,Logon Duration -Other,Protocol Bandwidth,Last Recorded,Protocol Latency -Last Recorded,XD Brokering Duration,Avg.App Load Time,XD Authentication Duration,XD Group Policy Load Time,XD HDX Connection Load Time,XD Interactive Session Load Time,XD Logon Duration,XD Logon Scripts Load Time,XD Profile Load Time |
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 Apps In Use |
For a XenDesktop session, the name of the published application/s in the session |
XD Apps In Use Count |
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 Delivery Group |
Name of the XenDesktop Delivery Group to which the computer hosting the session belongs |
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 Published Resource Type |
Type of XenDesktop published resource (desktop/application) used in this session. |
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 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.