Self-Service Search for Performance
Self-service search gives insights into key performance indicators associated with users, sessions, and machines collected by Citrix Analytics for Performance. Performance metrics such as session responsiveness, logon duration, session launch attempts, session failure count are displayed for users, machines, or sessions sorted and filtered based on your selection.
You can reach the self-service page from the main Search menu of the CAS Service.
To view the Performance related events on the self-service page, select Users, Sessions, or Machines under Performance from the list in the search bar, select the time period, and then click Search.
Specific Users, Sessions, and Machines based self-service pages are also displayed upon clicking the users, sessions, or machines numbers respectively in the User experience dashboard and User Experience (UX) Factors pages.
You can use the search bar to enter your query to filter the results. You can also narrow down your search using the facets in the left hand pane. The set of users, sessions, or machines displayed is based on the selection criteria.
For more information on the search functionalities, see Self-service search.
Select facets to filter events
Use the facets in the left-hand side pane to filter the data. Some of the facets associated with the Citrix Analytics for Performance are as follows:
Search users based on the user experience being Excellent, Fair, or Poor. The User Experience score can be “Not Categorized” if either the Session Responsiveness or the Session Logon Duration factor measurements be unavailable for the selected time period. The User Experience Score and the Session Experience Score are displayed as N/A in the self-service search results in these cases.
Search sessions based on the session experience being Excellent, Fair, or Poor. The Session Experience score can be “Not Categorized” if either the Session Responsiveness or the Session Logon Duration factor measurements are unavailable for the selected time period. The Session Experience Score is displayed as N/A in the self-service search results in these cases.
Factors affecting User Experience
Search users, sessions, and machines based on the individual factors affecting the user experience, such as Session Logon Duration, Session Responsiveness, Session Availability, or Session Resiliency.
Filter events based on the Site name. If you want to view the events of users belonging to site A during the last month. Select the time period, select A under Site Name in the facets. The search page displays the corresponding users and their metrics.
The Overload facets help filter machines, users, and sessions based on the load on the CPU and memory resources.
Overloaded Machines facet helps filter users and sessions based on the impact of overloaded machines.
Overloaded CPU/Memory facet helps filter machines that have been impacted by CPU Spikes or High Memory Usage.
Filter users, sessions, and machines based on the Delivery Group the machines belong to.
Search sessions based on the operating system running on the endpoint machine from which the session has been launched. This parameter helps identify issues that can be common among all endpoints running the same OS. The OS information is displayed as N/A for endpoints running Citrix Workspace app for Windows versions earlier than 1912.
Workspace App Version
Search sessions based on the Workspace App Version on the endpoint machine from which the session has been launched. This parameter helps identify issues specific to a particular Workspace App Version. The Workspace App Version information is displayed as N/A for endpoints running Citrix Workspace app for Windows version earlier than 1912.
You can now search users and sessions based on the location of the Endpoint Country or City. The Location facet helps isolating latency related issues to a specific location.
The location information is extracted from the public IP address securely transmitted by the endpoint machine to the Citrix Analytics Service. If your organization uses an on-premises StoreFront deployment, you can configure your StoreFront servers to enable Citrix Workspace app to send events to Citrix Analytics. Follow the steps as described in Onboard Virtual Apps and Desktops Sites using StoreFront.
You can disable the transmission of the IP address from the Citrix Workspace app on the endpoint machine by setting the SendPublicIPAddress registry entry to
false. For more information, see Enhancement to Citrix Analytics Service in the Citrix Workspace app for Windows documentation.
In the case of a closed customer environment where the endpoints are operating within an intranet, ensure that the URL
https://locus.analytics.cloud.com/api/locateipis accessible to the Citrix Analytics Service.
Location of an endpoint can be
Not Available or
N/A for the following reasons:
- The session failed to launch.
- Communication time-out occurred with the URL,
- The SendPublicIPAddress registry entry in the endpoint machine is set to disable the IP address transmission.
- The StoreFront server of your on-premises Site deployment is not configured with the Citrix Analytics Service.
The Protocol facet helps you filter users and sessions based on the protocol of the session - HDX, Console, or RDP.
This facet lists only the current protocols of sessions and not all supported session protocols.
Use the Connection Type facet to filter sessions based on whether the endpoints are directly connected to the machines or through a gateway. The Connection Type facet has the following elements,
- internal – for direct connections without Gateway
- external – for connections through Gateway
The Connection details are available for Endpoints running Citrix Workspace app version 20.12.0 or later for Windows. For all other endpoints, the Connection type is displayed as N/A.
This facet helps identify and troubleshoot issues related to the gateway easily.
Machine OS Type
This facet is available in the Machines based self-service view. It helps narrow down your search to a specific Machine OS type.
Self-service search for Users
The Users based self-service page is available on clicking the user classification numbers in the User experience dashboard and drilldown pages. You can also access the Users based self-service view from the Search menu in your CAS service. In the list of services in the Search tab, select Users under the Performance section.
This view provides the important performance metrics related to users, such as,
- Total Sessions: Number of sessions successfully launched by the user.
- Launch attempts count: Number of times the user attempted to launch a session.
- Failure count: Number of sessions that failed to establish.
- User Experience: Overall user experience score calculated across all the sessions launched by the user.
- Classification of sessions: User sessions classified as excellent, fair, and poor.
- Factors and sub-factors metrics Key performance indicators that affect the user experience.
- Endpoint Country (last known) and Endpoint Country (last known): Last known location.
- Profile Load: The time taken to load the user’s profile.
- Profile Size (last known): The last measured value of profile size.
- Average Profile Size: Average profile size for the selected duration.
Self-service search for Sessions
The Sessions based self-service is available on clicking the session classification numbers on the dashboard. You can also access the Sessions based self-service view from the Search menu in your CAS service. In the list of services in the Search tab, select Sessions under the Performance section.
Visual Summary in Sessions self-service view
Visual Summary presents raw data in the Sessions self-service tables as charts to improve visibility into the session performance.
The Visual Summary chart displays session categorization based on chosen criteria. In addition, you can choose to view the session distribution pivoted on a specific parameter. This helps identify session performance issues related to the pivots.
Use the visualization to identify patterns in data and troubleshoot specific session performance issues.
Use case - Access Visual Summary starting from the Dashboard
You can use the Visual Summary chart to troubleshoot sessions having poor Session Logon Duration or Session Responsiveness experience displayed on the User Experience dashboard.
Click the poor sessions number in the Session Responsiveness chart to view the Visual Summary chart in the Sessions self-service view. Visual Summary chart displays sessions categorized by Session Responsiveness over the selected duration. This helps identify specific time intervals where the ICA RTT has been high.
Further, choose the pivot from among Delivery Group, Endpoint Country, Endpoint City, and Workspace version to plot the session distribution. For example, selecting the Delivery Group pivot results in sessions plotted based on Delivery Groups. Use the chart to identify if sessions of a specific Delivery Group have high ICA RTT. Performance of sessions from Delivery Groups delivering business critical applications can be monitored easily using Visual Summary.
Use case - Access Visual Summary using the Search menu
You can visualize the result of your custom search query in the Sessions self-service view. In the Search tab, select Sessions under the Performance section. Enter your search query and click Search. To further customize the visualization of the results, choose the session categorization and distribution criteria.
The preceding example shows a query returning sessions with poor Session Responsiveness and not located in
Bengaluru. Further pivoting on the Endpoint City gives visibility into other locations from where sessions have high ICA RTT.
This feature is especially useful in reporting, you can also save and reuse the query.
This Sessions self-service view provides important performance metrics related to sessions in tabular format, such as,
- Session Experience: Session Experience score based on the performance factors.
- Session specific metrics: Metrics such as the session start time and launch status.
- Session specific factors and subfactors measurement: Key performance indicators that affect the session experience.
- Endpoint City (last known) and Endpoint Country (last known): Last known location.
- Workspace App version and Endpoint OS
- Average Profile Size: Average profile size for the selected duration.
internalfor direct connections from machine to endpoint,
externalfor connections through gateway.
- Gateway address: Gateway address for external connections.
- Machine FQDN: Machine address with port id for internal connections.
Launch Status: Displays the launch status of the session as
User Terminated- in case the user voluntarily closed the session. Launch Status is supported with endpoints running:
- Citrix Workspace app 20.9.0 or later for Android
- Citrix Workspace app 20.8.0 or later for iOS
- Citrix Workspace app 20.8.0 or later for Windows
Launch Status is not available with endpoints running Workspace on web.
Tabular data in the Session-based self-service view is color coded to indicate the excellent, fair, or poor category the metrics belong to. This categorization is based on the individual threshold levels of the metrics. The thresholds are calculated dynamically, for more information, see How are Dynamic Thresholds calculated?.
Similar color coding is applied to metrics available on expanding the rows in the Session-based self-service view.
Color coding visually aids in focusing on and identifying factors that are contributing to poor performance. It also gives an overview of the performance across various factors for the sessions that have been filtered to be seen in the current view.
Self-service search for Machines
You can access the Machines based self-service view from the Search menu in your CAS service. In the list of services on the Search tab, under the Performance section, select Machines. The Machines based self-service view is also available when you drill down from black hole machines. To access the view, on the User experience dashboard, in the Failure Insights section, click the Black hole machines number.
This view provides the important performance metrics related to machines, such as,
Status: Status of the machine -
- Sustained CPU Spikes: Number of CPU spikes in the selected time period. Each CPU spike refers to sustained CPU utilization above the threshold of 80% for 5 min or more.
- Sustained Memory Spikes: Number of memory spikes in the selected time period. Each memory spike refers to sustained memory consumption above the threshold of 80% for 5 min or more.
- Peak Concurrent Sessions: Number of sessions running concurrently on the machine.
- Unregistration Count: Number of times the machine got unregistered in the selected time period.
- Latest Consecutive Failures: Number of consecutive session failures in the last 5 min.
Downtime: Period during which the machine was in
Powered offstate in the selected time period.
- Avg CPU: Average CPU utilization in the selected time period.
- Peak CPU: Maximum CPU utilization recorded in the selected time period.
- Avg Memory Consumption: Average memory consumption in the selected time period.
- Peak Memory Consumption: Maximum memory consumption recorded in the selected time period.
This view helps admins identify specific machines contributing to poor user experience and correlate the machine resource parameters with the performance factor metrics. Clicking the machine name in the Machines based self-service view opens the Machine Statistics view. For more information, see the Machine Statistics article.
The values of the metrics, Avg CPU, and Avg memory consumption is calculated only in the duration when the machine was overloaded.
Specify search query to filter events
When you place your cursor in the search box, you get the list of search suggestions relevant for the Citrix Analytics for Performance. Use the search suggestions to specify your query and filter the events.
You can also use operators in your search queries to narrow the focus of your search. For more information on the valid operators, see Use search query in the search box to filter events.
For example, you want to search events for users with Failure-count more than 5 in the past week. Specify the following query.
Click the search bar and select the Failure-count field.
Click Failure-count, select the > sign, and then specify the value “5”.
Click the time period drop-down list and select Last 1 week
Click Search to view the events based on your search query.