Session Recording web player
Overview
The web player lets you use a web browser to view and play back recordings. Using the web player, you can:
-
Search for recordings by using filters, including host name, client name, user name, application, client IP address, event text, event type, and time.
-
View and play back both live and completed recordings with tagged events listed in the right pane.
-
configure cache memory for storing recordings while playing.
-
Highlight idle periods.
-
Leave comments about a recording and set comment severities.
-
Share URLs of recordings.
-
View graphical event statistics for each recording.
-
View data points related to each recorded session.
Note:
Supported browsers include Google Chrome, Microsoft Edge, and Firefox.
Enable the web player
The web player is enabled by default.
-
To disable the web player, start a Windows command prompt and run the
<Session Recording Server installation path>\Bin\SsRecUtils.exe –disablewebplayer
command. -
To enable the web player, start a Windows command prompt and run the
<Session Recording Server installation path>\Bin\SsRecUtils.exe -enablewebplayer
command.
Logon and password
The URL of the web player website is http(s)://<FQDN of Session Recording Server>/WebPlayer
. To ensure the use of HTTPS, add an SSL binding to the website in IIS and update the SsRecWebSocketServer.config
configuration file. For more information, see the HTTPS configuration section in this article.
Note:
When logging on to the web player website, domain users do not need to enter credentials while non-domain users must.
Installation
Install the web player on the Session Recording Server only. Double-click SessionRecordingWebPlayer.msi and follow the instructions to complete your installation. For more information about installing Session Recording, see Install, upgrade, and uninstall.
Starting from Version 2103, Session Recording migrates the WebSocket server to IIS. With the web player installed, the SessionRecordingRestApiService, SessionRecordingWebStreaming, and WebPlayer applications appear in IIS.
A fresh installation of Session Recording 2103 and later connects your web browser to the WebSocket server hosted in IIS when you access the web player website. The WebSocket server hosted in IIS is versioned 2.0, as indicated by the registry value WebSocketServerVersion under the registry key at HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server.
An upgrade installation from an earlier version to Session Recording 2103 and later connects your web browser to the Python-based WebSocket server. To connect to the WebSocket server hosted in IIS, run the <Session Recording Server installation path>\Bin\SsRecUtils.exe -enablestreamingservice command. To connect back to the Python-based WebSocket server, run the <Session Recording Server installation path>\Bin\SsRecUtils.exe - disablestreamingservice command. The Python-based WebSocket server is versioned 1.0.
HTTPS configuration
To use HTTPS to access the web player website:
-
Add an SSL binding in IIS.
-
Obtain an SSL certificate in PEM format from a trusted Certificate Authority (CA).
Note:
Most popular browsers such as Google Chrome and Firefox no longer support the common name in a Certificate Signing Request (CSR). They enforce Subject Alternative Name (SAN) in all publicly trusted certificates. To use the web player over HTTPS, take the following actions accordingly:
-
When a single Session Recording Server is in use, update the certificate of the Session Recording Server to a SAN certificate.
-
When load balancing is in use, ensure that a SAN certificate is available both on Citrix ADC and on each Session Recording Server.
-
-
On IIS, right-click the website and select Add Bindings. The Site Bindings dialog box appears.
-
Click Add in the upper right corner. The Add Site Binding dialog box appears.
-
Select https from the Type list and select your SSL certificate.
-
Click OK.
-
-
Update the
SsRecWebSocketServer.config
configuration file.-
Locate and open the
SsRecWebSocketServer.config
configuration file.The
SsRecWebSocketServer.config
configuration file is typically located in the<Session Recording Server installation path>\Bin\
folder. -
(Optional) For Session Recording 2103 and later that host the WebSocket server in IIS, enable TLS by editing TLSEnable=1 and ignore the ServerPort, SSLCert, and SSLKey fields.
-
(Optional) For Session Recording 2012 and earlier, enable TLS by editing TLSEnable=1, and fill in the paths to the SSL certificate and its key, respectively.
Note:
Only the PEM format of SSL certificates and key files is supported.
The ServerPort field indicates the port number that the web player uses to collect recording files. In the following screen capture, it is set to the default value (22334).To extract the separate certificate and key files used in the WebSocket server configuration:
-
Ensure that OpenSSL is installed on your Session Recording Server that contains the SSL certificate.
-
Export the SSL certificate as a .pfx file. The .pfx file includes both the certificate and the private key.
-
Open the command prompt and go to the folder that contains the .pfx file.
-
Start OpenSSL from the OpenSSL\bin folder.
-
Run the following command to extract the certificate:
openssl pkcs12 -in [yourfile.pfx] -clcerts -nokeys -out [aSRS2.pem] <!--NeedCopy-->
Enter the import password that you created when exporting the .pfx file.
-
Run the following command to extract the private key:
openssl pkcs12 -in [yourfile.pfx] -nocerts -out [newaSRS2keyWithPassword.pem] <!--NeedCopy-->
Enter the import password that you created when exporting the .pfx file. Provide a new password for protecting your key file when prompted for the PEM pass phrase.
-
Run the following command to decrypt the private key:
openssl rsa -in [newaSRS2keyWithPassword.pem] -out [newaSRS2key.pem] <!--NeedCopy-->
-
-
Save your changes.
-
Check your firewall settings. Allow SsRecWebSocketServer.exe to use the TCP port (22334 by default) and allow access to the web player URL.
-
Run the
SsRecUtils –stopwebsocketserver
command.
-
Hide or show content on the web player home page
After you log on, the web player home page might hide or show content based on whether the following option is selected in Session Recording Server Properties.
-
With the option selected, the web player home page hides all content. Recordings can be accessed only by way of their URLs. Recording URLs are provided in email alerts that are sent to specified recipients. For information about email alerts, see Event response policies. You can also share recording URLs through the Share Current Playback control on recording playback pages. See descriptions later in this article.
-
With the option unselected, the web player home page shows content similar to the following screen capture. Click All Recordings in the left navigation to refresh the page and display new recordings if there are any. Scroll down the webpage to select recordings to view or use filters to customize your search results. For live recordings, the Duration column shows Live and the play button appears green.
To show all recording files of a recorded session, select a recording on the list and click the Follow up icon. The Follow up icon is available only when a recording is selected.
For a description of the recording items, see the following table.
Item | Description |
---|---|
Start time | The recording start time. Click the up and down arrows to list recordings in chronological order. |
User | The user whose session was recorded. Click the up and down arrows to concentrate recordings of a user on the list and arrange users in alphabetical order. |
Host | The host name of the VDA where the recorded session was hosted. Click the up and down arrows to arrange the VDA host names in alphabetical order. |
Client | The name of the client device where the session was running. Click the up and down arrows to arrange the client host names in alphabetical order. |
Events | The quantity of events in the recording. Click the up and down arrows to arrange recordings on the list by event quantity. |
Events Only | Indicates a screen recording or an event-only recording. An event-only recording played in the web player contains an event statistics pie chart and histogram. The pie chart and histogram hold static throughout playback. |
Recording Server | The Session Recording Server that processes recording data sent from VDAs. |
Duration | The time length of the recording. Click the up and down arrows to arrange recordings on the list by time length. |
Search for recordings by using filters
You can search for recordings by using filters. The available filters include host name, client name, user name, application, client IP address, event text, event type, and time.
For example, after you select the host name filter, the following dialog box appears. Type in the host name (of the VDA where recorded sessions are hosted) and click Search to filter out irrelevant recordings and display only the relevant ones.
You can change to a different filter by clicking the currently selected Host name, as shown in the following screen capture. All filters are listed after you click Host name. Select a different filter as needed.
You can also click the + symbol to add filters.
For example, you can add the Time filter as shown in the following screen.
The Time filter consists of recording start date, start time, and duration.
Open and play recordings
On the recordings page, each recording has a play button on the right side, next to the Duration item.
Click the play button. The playback page appears. Playback starts after memory caching.
Tip:
- Clicking the session progress time lets you switch to the absolute date and time the session was recorded.
- For an event-only recording, the play icon in the upper left corner is unavailable.
For a description of the player controls, see the following table:
Player Control | Description |
---|---|
Plays the selected recording file. | |
Pauses playback. | |
You can drag the progress bar during playback. Idle periods of recorded sessions are highlighted during playback. | |
Seeks backward 7 seconds. | |
Indicates the current position of the recording playback and the total recording duration. The time format is HH:MM:SS. | |
Lets you click and leave a comment about the recording being played. | |
Lets you click and copy the URL of the current recording to the clipboard. | |
Shows the overlay that features data points related to the recorded session. | |
Hides the session data overlay. | |
Indicates the current speed of playback. Click the icon to switch between options including X0.5, X1, X2, and X4. | |
Displays the playback in full screen. | |
Displays the playback within the webpage. |
In the right pane of the playback page, the Events and Comments filters, quick search box, and some recording data are available:
- The date and time on the web player machine. In this example, AUG 20, 2021 and 18:50:50.
- The duration of the recording in playback. In this example, 01:37:00.
- The number of events in the recording. In this example, 359 EVENTS.
- The name of the user whose session was recorded.
- The host name of the VDA where the recorded session was hosted.
- The name of the client device where the session was running.
- Options for sorting search results: Select All, Events, or Comments to sort search results.
-
Event filters. You can select more than one filter to search for events in the current recording.
Click the icon to expand displays of events. For example:
- Event list. Clicking an event on the list takes you to the position of the event in the recording.
- Quick search box. The search events quick search box helps to quickly narrow down a list of events in the current recording.
View graphical event statistics
Event data visualization is available in the web player for each recording. It provides graphical event statistics that help you quickly comprehend large numbers of events inserted in recordings, allowing you to easily see and communicate event trends.
To view graphical event statistics, complete the following steps:
-
Open and play a recording.
-
In the upper left corner of the playback page, click the statistics icon.
-
Switch between the Screen time, File transfers, Commands, and Events tabs to view statistics from different perspectives.
-
Screen time
The Screen time tab lets you know the cumulative time an application window is in focus (active window).
By clicking the horizontal time bar next to an application on the list, you can view the start time and duration each time the application becomes and stays in focus, respectively. You can narrow down your search range by specifying a duration range other than the default All option. For example:
-
File transfers
The File transfers tab provides graphical statistics about bidirectional file transfers between the VDA hosting the recorded session and the client device where the session runs. You can customize the visualization by using the following settings:
- Time granularity: Per 1 minute, Per 10 minutes, Per hour
- File transfer destination: All transfers, Transfer from host to client, Transfer from client to host
- Number or size (Bytes or MB) of transferred files
The X axis represents the absolute time in the 24-hour system.
-
Commands
The Commands tab shows CMD and PowerShell commands that are run during the recorded session. You can customize the data display by typing your custom search in Custom search or selecting a saved search from Saved search. The “OR” logical operator is used to compute the final action.
-
Events
The Events tab shows the proportions and numbers of all types of events in the recorded session.
-
Configure cache memory for storing recordings while playing
On the Configuration page of the web player, click the slider to set up the cache memory for storing recordings while playing.
Tip:
You can access the Configuration page directly through http(s)://<FQDN of Session Recording Server>/WebPlayer/#/configuration/cache.
Record idle events and highlight idle periods
Session Recording can record idle events and highlight idle periods in the Session Recording web player. Idle events are not visible in the Session Recording Player because idle events are saved in the Session Recording Database but not in the relevant recording files (.icl
files).
To customize the idle event feature, set the following registry keys as required. The registry keys are located at HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\SessionEvents.
Registry key | Default value | Description |
---|---|---|
DisableIdleEvent | 0 | To disable the idle event feature, set the value to 1. To enable the idle event feature, set the value to 0. |
IdleEventThrottle | 120 seconds | If there is no user activity (including graphics changes and keyboard/mouse inputs) longer than the time threshold set by the registry key, an idle event is recorded. The idle period is highlighted when the recorded session plays back on the Session Recording web player. |
IdleEventActiveThrottle | 30 seconds | Only a certain number of graphics changes within a specified amount of time qualify as user activities. By default, at least three packets within 30 seconds can qualify as user activities. |
IdleEventActivePktNumThrottle | 3 packets | Only a certain number of graphics changes within a specified amount of time qualify as user activities. By default, at least three packets within 30 seconds can qualify as user activities. |
IdleEventActivePktSizeThrottle | 100 bytes | Graphics packets smaller than the key value are ignored and the relevant time duration is regarded as idle. |
Comment on recordings
When a recorded session is being played, you can click the Comments player control to leave comments and set comment severities. Severities include Normal, Medium, and Severe. Severe and Medium comments are indicated with red and orange dots, respectively. During session playback, you can view all comments about a recording. To delete a comment you just left, refresh your webpage, expand the comment, and then click Delete.
Clicking a comment lets you jump to the location where the comment was given. You can view all your comments on the My comments page.
Note:
To make the comment feature work as expected, clear the WebDAV Publishing check box in the Add Roles and Features wizard of Server Manager on the Session Recording Server.
Share URLs of recordings
Clicking Share Current Playback on the playback page of a recording copies the recording URL to the clipboard. You can share the URL with other users for them to access the recording directly without the need to search in all recordings.
After you click Share Current Playback, either of the following messages appears, indicating a successful or failed operation respectively:
-
The URL to the shared recording has been copied to the clipboard
-
Sharing the recording URL failed
Pasting the shared URL in the address bar lets you jump to the location where the URL was copied.
For secure sharing, set the following registry values under HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\SmartAuditor\Server
:
Registry value | Description | Default value | Remarks |
---|---|---|---|
LinkExpire | Time span beyond which a shared URL expires. Counted as timeticks in the unit of 10 microseconds. | 1,728,000,000,000 (The default value equals 2 days.) | - |
LinkSalt | A security method to protect the preceding URL expiration time | Kk2od974 | Change the default value to an arbitrary string that preferably ends with digits. |
View data points related to each recorded session
During playback, you can click the Show stats control to view, on an overlay, the following data points related to the recorded session:
- Round trip time
- Network (send)
- Network (receive)
- CPU usage
- Memory usage
Note:
- Session Recording collects round trip time every 15 seconds and the rest of the data points every second.
- Theoretically, Session Recording refreshes data on round trip times every five seconds. However, round trip time data actually refreshes every 15 seconds because of the collection cycle.
- Session recording refreshes the rest of the data points every 5 seconds and presents their average values on the overlay.
The overlay is semi-transparent. You can relocate and hide it.
- To relocate the overlay, hover your mouse over the eight dots and then do a drag and drop.
- To hide the overlay, click Hide stats.
You can enable the overlay by selecting Log performance data when creating your event detection policy. For more information, see Create a custom event detection policy.
Administrator Logging integrated with the web player
The web player integrates the Administrator Logging webpage. An administrator assigned to both the LoggingReader and the Player roles can view the administrator activity logs in the web player.
Note:
The language set for the web player browser must match the language you selected when you installed the Session Recording Administration components.
-
Configuration logging:
-
Recording reason logging:
Ensure that your SessionRecordingLoggingWebApplication site in IIS and the web player have the same SSL settings. Otherwise, 403 errors occur when you request to access the administrator activity logs.
In this article
- Overview
- Enable the web player
- Logon and password
- Installation
- HTTPS configuration
- Hide or show content on the web player home page
- Search for recordings by using filters
- Open and play recordings
- View graphical event statistics
- Configure cache memory for storing recordings while playing
- Record idle events and highlight idle periods
- Comment on recordings
- Share URLs of recordings
- View data points related to each recorded session
- Administrator Logging integrated with the web player