Citrix Virtual Apps and Desktops data source 编辑

This article describes the steps to connect your on-premises Citrix Virtual Apps and Desktops sites to Citrix Analytics using StoreFront. The onboarding steps mentioned in this article are applicable for both the offerings: Citrix Analytics for Performance (Performance Analytics) and Citrix Analytics for Security (Security Analytics).

For the onboarding steps specific to each offering, see the following articles:

• Configuring on premises Citrix Virtual Apps and Desktops sites with Citrix Analytics for Performance

• Configuring Citrix Virtual Apps and Desktops and Citrix DaaS data source for Citrix Analytics for Security

Onboard Citrix Virtual Apps and Desktops on-premises sites using StoreFront

If your organization uses an on-premises StoreFront deployment, you must configure your StoreFront servers to enable Citrix Workspace app to send events to Citrix Analytics. The events are processed by Citrix Analytics to provide actionable insights into the performance of your Citrix IT infrastructure and your users’ behavior.

For more information on how to configure a StoreFront deployment for Citrix Analytics, see the Citrix Analytics service article in the StoreFront documentation.

Earlier, customers using the Citrix Apps and Desktops on-premises sites were enforced to use the site aggregation to onboard the on-premises sites for Citrix Analytics for Security and Citrix Analytics for Performance.

You can now onboard Citrix Apps and Desktops on-premises sites without depending on the site aggregation.

You can see the Connect Storefront Deployment option on your workspace application, even if you do not have any site added to the site aggregation.

Prerequisites

Before you begin, ensure the following:

• Your StoreFront version must be 1906 or later.

• The StoreFront deployment must be able to connect to the following addresses:

  • https://*.cloud.com

  • https://api.analytics.cloud.com

• The StoreFront deployment must have port 443 open for outbound internet connections. Any proxy servers on the network must allow this communication with Citrix Analytics.

• If the StoreFront deployment is hosted on a webserver that uses a web proxy to connect to the internet, the proxy for each store must be manually configured to allow outbound traffic. StoreFront does not automatically use the proxy setting of the host webserver. For more information, see Configure a StoreFront deployment hosted on a webserver that uses HTTP proxy.

• The StoreFront deployment must be accessed using one of the following clients:

  • Citrix Receiver for websites in HTML5-compatible browsers.

    Note

    If you are an HTML5 user, Citrix Virtual Apps and Desktops can launch events when certain configurations are enabled on StoreFront. For information about the configuration steps, see the Install article in the Citrix Workspace app for HTML5 documentation. For print-related events, extra policies must be configured on StoreFront. For more information, see the PDF Printing article in the Citrix Workspace app for HTML5 documentation.

  • Citrix Workspace app 1907 for Windows or later.

  • Citrix Workspace app 2006 for Linux or later.

  • Citrix Workspace app 2006 for Mac or later

• If you are using Citrix Virtual Apps and Desktops 7 1912 LTSR, the supported StoreFront version is 1912.

Connect to a StoreFront deployment

1. If you are using the Security Analytics offering, select Settings > Data Sources > Security.

   • On the Apps and Desktops- Workspace app site card, click the vertical ellipsis (⋮) and then select Connect StoreFront deployment.

     

     Note

     The Connect StoreFront deployment option is disabled if you do not have a site already discovered by Analytics. Add your on-premises sites to Workspace to enable this option.

2. If you are using the Performance Analytics offering, select Settings > Data Sources > Performance.

   • On the Apps and Desktops- Monitoring site card, click the vertical ellipsis (⋮) and then select Connect StoreFront deployment.

     

3. On the Connect StoreFront Deployment page, review the checklist and select all the mandatory requirements. If you do not select a mandatory requirement, the Download File option is disabled.

   

4. Click Download File to download the StoreFrontConfigurationFile.json file.

   Note

   The file contains sensitive information. Keep the file in a safe and secure location.

   

5. Copy the file to your StoreFront deployment. If you are using multiserver deployment, copy the file to a server in the StoreFront server group.

6. On the StoreFront server, open the PowerShell ISE and run the following command to import the configuration settings:

   Import-STFCasConfiguration -Path "configuration file path"