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.

Note:

For more information on the self-service functionalities, like the usage of self-service search, scheduling an email for a search query and more, see Self-service search.

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.

Performance select

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. Performance self-service overview page

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:

Performance facets

User Experience

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.

Score not available

Session Experience

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.

Failure Type and Reason

In the Sessions self-service view, Failure Type and Failure Reason facets represents the Session Availability performance factors.

Failure facets

Failure Type provides filtering based on the type of session failures, such as Machine Failure, Client Connection Failure, Communication Failure. Failure Reason provides filtering based on the reason for session failure, such as VDA not functional, Registration timeout.

Failure reason

Overloaded Machines and CPU/Memory

The Overload facets help filter machines, users, and sessions based on the load on the CPU and memory resources.

Overload facets

Overloaded Machines provides filtering based on how overloaded the machine resources are. Overloaded CPU/Memory provides filtering based on whether CPU or memory caused the overload.

Endpoint OS

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 version 1912 and earlier.

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 1912 and earlier.

Delivery Group

Filter users, sessions, and machines based on the Delivery Group the machines belong to.

Site Name

Filter users, sessions, and machines based on Site.

Location

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.

Location facet

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.

Note:

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/locateip is accessible to the endpoints.

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, https://locus.analytics.cloud.com/api/locateip.
  • 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.

Session Protocol

The Protocol facet helps you filter users and sessions based on the protocol of the session - HDX, Console, or RDP.

Protocol facet

This facet lists only the current protocols of sessions and not all supported session protocols.

Connection Type

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

Users self-service view

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

Session self-service view

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.

Factors Timeline(Preview)

Factors Timeline pivot is added in the Session Distribution section of the Sessions self-service view under the Session Responsiveness category. You can use this pivot to analyze sessions based on Poor Output Bandwidth Usage, Poor Network Latency, and Poor ICARTT.

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.

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.

Visual Summary

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.

Tabular data

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.
  • Connection Type: internal for direct connections from machine to endpoint, external for 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 Succeeded, Failed, or 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.

  • Network Interface Type Displays the network interface type of the client. Possible values for Network Interface Type are:
    • Ethernet
    • Wifi
    • TokenRing
    • FDDI
    • PPP
    • Loopback
    • Slip
    • Other
    • UnknownType

    The value of this field is N/A for endpoints running Citrix Workspace app Windows version earlier than 2105.

  • Bandwidth and Latency metrics (Preview) Displays the following values:
    • P95 values of the bandwidth metrics - Input Bandwidth Consumed, Output Bandwidth Available, Output Bandwidth Used,
    • Percentage value of Output Bandwidth Utilization, and
    • P95 value of the Network Latency

    These metrics are available out-of-the-box and does not require any specific configuration. You will need VDAs running Citrix Virtual Apps and Desktops 7 2112 LTSR or later.

  • Session Duration Displays the length of the session.
  • ISP Displays the Internet Service provider seving on the endpoint. This metric is available if the endpoint is running Citrix Workspace App for Windows versions 1912 and later. For more details regarding the availabilty of this feature with Citrix Workspace App for other OS, see the Workspace app matrix.

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

Color coding

Similar color coding is applied to the 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

Machine self-service view

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 - Registered, Unregistered, Powered off, Shutdown, Failed.
  • 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 Unregistered, Failed, Shutdown, or Powered off state 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.

Notes:

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.

Virtual apps and Desktops self-service

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.

  1. Click the search bar and select the Failure-count field.

  2. Click Failure-count, select the > sign, and then specify the value “5”.

    Virtual Apps and Desktops search query 2

  3. Click the time period drop-down list and select Last 1 week

    Virtual Apps and Desktops search query 3

  4. Click Search to view the events based on your search query.