Documentación de productos
StoreFront
Current Release 2402 LTSR 2203 LTSR 1912 LTSR 3.12
Ver PDF

Servicio de Citrix Analytics

March 9, 2026
Contribución de: 
C C

Si eres cliente de monitor y tienes una implementación de StoreFront local, puedes configurar StoreFront para que los datos se envíen al servicio Citrix Analytics en monitor. Una vez configurada, la aplicación Citrix Workspace y los navegadores web envían eventos de usuario a Citrix Analytics para su procesamiento. Citrix Analytics agrega métricas sobre usuarios, aplicaciones, puntos finales, redes y datos para proporcionar información completa sobre el comportamiento del usuario. Para obtener más información sobre esta función en la documentación de Citrix Analytics, consulta Incorporar sitios de Virtual Apps and Desktops mediante StoreFront.

Para configurar este comportamiento:

  • Descarga un archivo de configuración de Citrix Analytics.
  • Importa los datos de Citrix Analytics a tu implementación de StoreFront local mediante PowerShell.

Una vez configurado StoreFront, la aplicación Citrix Workspace puede enviar datos desde los almacenes de StoreFront cuando el servicio Citrix Analytics lo solicite.

Importante:

Tu implementación de StoreFront debe poder ponerse en contacto con los servicios de API de Citrix. Consulta Requisitos de red de Analytics.

Descarga el archivo de configuración de Citrix Analytics

Importante:

Se requiere un archivo de configuración que contiene información confidencial para la configuración inicial. Guarda el archivo de forma segura después de descargarlo. No compartas este archivo con nadie fuera de tu organización. Después de la configuración, puedes eliminar este archivo. Si necesitas volver a aplicar la configuración en otra máquina, puedes descargar el archivo de nuevo desde la consola de administración del servicio Citrix Analytics.

  1. Inicia sesión en monitor (https://citrix.cloud.com/) con una cuenta de administrador.
  2. Selecciona un cliente de monitor.
  3. Abre la consola de administración del servicio Citrix Analytics haciendo clic en Administrar.

Analytics tile

  1. En la consola de administración del servicio Citrix Analytics, selecciona Configuración > Orígenes de datos.
  2. En la tarjeta de Virtual Apps and Desktops, selecciona el icono de menú (**⋮**) y, a continuación, selecciona Conectar implementación de StoreFront.
  3. En la página Conectar implementación de StoreFront, selecciona Descargar archivo para descargar el archivo StoreFrontConfigurationFile.json.

Ejemplo de archivo de configuración 

{
  "customerId": "<yourcloudcustomer>",
  "enablementService": " https://api.analytics.cloud.com /casvc/<yourcloudcustomer>/ctxana/v1/cas/<yourcloudcustomer>/XenDesktop/<deviceid>/dsconfigdata",
  "cwsServiceKey": "PFJTPn…….. T4=",
  "enablementServiceStatus": " https://api.analytics.cloud.com /casvc/<yourcloudcustomer>/ctxana/v1/cas/storefront/config",
  "instanceId": "d98f21d0-56e0-11e9-ba52-5136d90862fe",
  "name": "CASSingleTenant"
}
<!--NeedCopy-->

donde

customerId es el ID único del cliente de monitor actual.

cwsServiceKey es una clave única que identifica la cuenta de cliente de monitor actual.

instanceID es un ID generado que se usa para firmar (proteger) las solicitudes realizadas desde la aplicación Citrix Workspace a Citrix Analytics. Si registras varios servidores StoreFront o grupos de servidores con monitor, cada uno tendrá un instanceID único.

Importa los datos de Citrix Analytics a tu implementación de StoreFront™

  1. Copia el archivo StoreFrontConfigurationFile.json a una carpeta adecuada en el servidor StoreFront local (o a un servidor de un grupo de servidores StoreFront). Los siguientes comandos asumen que el archivo se guarda en el Escritorio.
  2. Abre PowerShell ISE y selecciona Ejecutar como administrador.

  3. Ejecuta los siguientes comandos:

    Import-STFCasConfiguration -Path "$Env:UserProfile\Desktop\StoreFrontConfigurationFile.json"
Get-STFCasConfiguration
<!--NeedCopy-->
  4. Este comando devuelve una copia de los datos importados y los muestra en la consola de PowerShell.

get stf cas configuration

Nota:

Los servidores StoreFront locales, que están instalados en Windows Server 2012 R2, pueden requerir que los componentes de software en tiempo de ejecución de C++ se instalen manualmente para que puedan registrarse con CAS. Si StoreFront se instala durante la instalación de Citrix Virtual Apps and Desktops, este paso no es necesario, ya que el metainstalador de CVAD ya instala los componentes en tiempo de ejecución de C++. Si StoreFront se instala usando solo el metainstalador CitrixStoreFront-x64.exe sin el tiempo de ejecución de C++, puede que no se registre con monitor después de haber importado el archivo de configuración de CAS.

Propaga los datos de Citrix Analytics a un grupo de servidores StoreFront

Si realizas estas acciones en un grupo de servidores StoreFront, debes propagar los datos importados de Citrix Analytics a todos los miembros del grupo de servidores. Este paso no es necesario en una implementación de servidor StoreFront único.

Para propagar los datos, usa uno de los siguientes enfoques:

  • Usa la consola de administración de StoreFront.
  • Usa el cmdlet de PowerShell Publish-STFServerGroupConfiguration.

Comprueba el ID del grupo de servidores StoreFront

Para comprobar si tu implementación se ha registrado correctamente en el servicio Citrix Analytics, puedes usar PowerShell para descubrir el ServerGroupID de tu implementación.

  1. Inicia sesión en tu servidor StoreFront o en un servidor StoreFront del grupo de servidores.
  2. Abre PowerShell ISE y selecciona Ejecutar como administrador.

  3. Ejecuta los siguientes comandos:

    $WebConfigPath = "C:\Program Files\Citrix\Receiver StoreFront\Framework\FrameworkData\Framework.xml"
$XMLObject = (Get-Content $WebConfigPath) -as [Xml]
$XMLObject.framework.properties.property
<!--NeedCopy-->

    Por ejemplo, estos comandos generan una salida como la siguiente:

    name value
---- -----
ClusterId 8b8ff5c8-44ba-46e4-87f0-2df8cff31432
HostBaseUrl https://storefront.example.com/
SelectedIISWebSiteId 1
AdminConsoleOperationMode Full
<!--NeedCopy-->

Deja de enviar datos a Citrix Analytics desde StoreFront

  1. Abre PowerShell ISE y selecciona Ejecutar como administrador.

  2. Ejecuta los siguientes comandos:

    Remove-STFCasConfiguration

    Get-STFCasConfiguration

    Get-STFCasConfiguration no devuelve nada si los datos de Citrix Analytics importados anteriormente se han quitado correctamente.

  3. Si realizas estas acciones en un grupo de servidores StoreFront, propaga el cambio y quita los datos importados de Citrix Analytics de todos los miembros del grupo de servidores. En un servidor del grupo de servidores, ejecuta el siguiente comando:

    Publish-STFServerGroupConfiguration

  4. En cualquier otro miembro del grupo de servidores, ejecuta el siguiente comando para confirmar que la configuración de Citrix Analytics se ha quitado correctamente de todos los servidores del grupo:

    Get-STFCasConfiguration

  5. Inicia sesión en monitor (https://citrix.cloud.com/) con una cuenta de administrador.
  6. Selecciona un cliente de monitor.
  7. Abre la consola de administración del servicio Citrix Analytics haciendo clic en Administrar.
  8. En la consola de administración del servicio Citrix Analytics, selecciona Configuración > Orígenes de datos.
  9. En la tarjeta de Virtual Apps and Desktops, selecciona el recuento de implementaciones de StoreFront:

storefront server groups

  1. Identifica la implementación de StoreFront que quieres quitar consultando su URL base de host y ServerGroupID.
  2. En el menú (**⋮**), selecciona Quitar implementación de StoreFront de Analytics.

storefront server groups

Nota:

Si quitas la configuración del lado del servidor, pero no de Citrix Analytics, la entrada de implementación de StoreFront permanece en Citrix Analytics, pero no recibe datos de StoreFront. Si quitas la configuración solo de Citrix Analytics, la entrada de implementación de StoreFront se vuelve a agregar en el siguiente reciclaje del grupo de aplicaciones (realizado en un restablecimiento de IIS o automáticamente cada 24 horas).

Configura StoreFront para usar un proxy web para ponerse en contacto con monitor y registrarse en Citrix Analytics

Si StoreFront se coloca en un servidor web host detrás de un proxy web, el registro en Citrix Analytics fallará. Si los administradores de StoreFront usan un proxy HTTP en su implementación de Citrix, el tráfico de StoreFront destinado a Internet debe pasar por el proxy web antes de llegar a Citrix Analytics en la nube. StoreFront no usa automáticamente la configuración de proxy del sistema operativo host; se requiere una configuración adicional para indicar al almacén que envíe el tráfico saliente a través del proxy web. Puedes configurar una configuración de proxy <system.net> agregando una nueva sección al archivo web.config del almacén. Haz esto para cada almacén en el servidor StoreFront que se usará para enviar datos a Citrix Analytics.

Método 1: Configura el proxy del almacén mediante PowerShell para uno o varios almacenes (recomendado)

La ejecución del script de PowerShell Config-StoreProxy.ps1 automatiza este proceso para uno o varios almacenes e inserta automáticamente XML válido para configurar <system.net>. El script también hace una copia de seguridad del archivo web.config del almacén en el escritorio del usuario actual, lo que permite restaurar el archivo web.config sin modificar si es necesario.

Nota:

Ejecutar el script más de una vez puede dar lugar a que se agreguen varias copias del XML <system.net>. Cada almacén solo debe tener una única entrada para <system.net>. Agregar varias copias impide que la configuración del proxy del almacén funcione correctamente.

  1. Abre PowerShell ISE y selecciona Ejecutar como administrador.

  2. Establece $Stores = @("Store","Store2") para incluir los almacenes que deseas configurar con un proxy web.

  3. Especifica una de las siguientes opciones:

    • una dirección IP, O
    • un FQDN para el proxy web

  4. Ejecuta el siguiente PowerShell:

    $Stores = @("Store","Store2")
$ProxyIP = "10.0.0.1"
$ProxyFQDN = "proxyserver.example.com"
$ProxyPort = 8888

# Set this for every Store using Stores array
function Set-StoreProxyServer() # Tested with both IP and FQDN
{
    [CmdletBinding()]
    param([Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][array]$Stores,
        [Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][string]$ProxyIP,
        [Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][string]$ProxyFQDN,
        [Parameter(Mandatory=$true,ParameterSetName="ProxyIP")][Parameter(Mandatory=$true,ParameterSetName="ProxyFQDN")][int]$ProxyPort)

    foreach($Store in $Stores)
    {
        Write-Host "Backing up the Store web.config file for store $Store before making changes..." -ForegroundColor "Yellow"
        Write-Host "`n"

        if(!(Test-Path "$env:UserProfile\desktop\$Store\"))
        {
            Write-Host "Creating $env:UserProfile\desktop\$Store\ directory for backup..." -ForegroundColor "Yellow"
            New-Item -Path "$env:UserProfile\desktop\$Store\" -ItemType "Directory" | Out-Null
            Write-Host "`n"
        }

        Write-Host "Copying c:\inetpub\wwwroot\Citrix\$Store\web.config to $env:UserProfile\desktop\$Store\..." -ForegroundColor "Yellow"
        Copy-Item -Path "c:\inetpub\wwwroot\Citrix\$Store\web.config" -Destination "$env:UserProfile\desktop\$Store\" -Force | Out-Null

        if(Test-Path "$env:UserProfile\desktop\$Store\web.config")
        {
            Write-Host "$env:UserProfile\desktop\$Store\web.config file backed up" -ForegroundColor "Green"
        }
        else
        {
            Write-Host "$env:UserProfile\desktop\$Store\web.config file NOT found!" -ForegroundColor "Red"
        }
        Write-Host "`n"

        Write-Host "Setting the proxy server to $ProxyAddress for Store $Store..." -ForegroundColor "Yellow"
        Write-Host "`n"

        $StoreConfigPath = "c:\inetpub\wwwroot\Citrix\$Store\web.config"
        $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]

        if([string]::IsNullOrEmpty($ProxyFQDN))
        {
            $ProxyServer = ("HTTP://$ProxyIP"+":"+$ProxyPort)
        }
        else
        {
            $ProxyServer = ("HTTP://$ProxyFQDN"+":"+$ProxyPort)
        }

        $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]

        # Create 3 elements
        $SystemNet = $XMLObject.CreateNode("element","system.net","")
        $DefaultProxy = $XMLObject.CreateNode("element","defaultProxy","")
        $Proxy = $XMLObject.CreateNode("element","proxy","")
        $Proxy.SetAttribute("proxyaddress","$ProxyServer")
        $Proxy.SetAttribute("bypassonlocal","true")

        # Move back up the XML tree appending new child items in reverse order
        $DefaultProxy.AppendChild($Proxy)
        $SystemNet.AppendChild($DefaultProxy)
        $XMLObject.configuration.AppendChild($SystemNet)

        # Save the modified XML document to disk
        $XMLObject.Save($StoreConfigPath)

        Write-Host "Getting the proxy configuration for c:\inetpub\wwwroot\Citrix\$Store..." -ForegroundColor "Yellow"
        $XMLObject = (Get-Content $StoreConfigPath) -as [Xml]
        $ConfiguredProxyServer = $XMLObject.configuration.'system.net'.defaultProxy.proxy.proxyaddress | Out-Null
        Write-Host ("Configured proxy server for Store $Store"+": "+ $ConfiguredProxyServer) -ForegroundColor "Green"
        Write-Host "`n"
    }
    Write-Host "Restarting IIS..." -ForegroundColor "Yellow"
    IISReset /RESTART
}

Set-StoreProxyServer -Stores $Stores -ProxyFQDN $ProxyFQDN -ProxyPort $ProxyPort
# OR
Set-StoreProxyServer -Stores $Stores -ProxyIP $ProxyIP -ProxyPort $ProxyPort
<!--NeedCopy-->

  5. Comprueba que C:\inetpub\wwwroot\Citrix\<Store>\web.config ahora contiene una sección <system.net> al final del archivo.

            </dependentAssembly>
    </assemblyBinding>
</runtime>
<system.net>
    <defaultProxy>
    <proxy proxyaddress="HTTP://proxyserver.example.com:8888" bypassonlocal="true" />
    </defaultProxy>
</system.net>
</configuration>
<!--NeedCopy-->

  6. Importa los datos de Citrix Analytics como se describe en Importar datos de Citrix Analytics a tu implementación de StoreFront.

Método 2: Agrega manualmente una sección <system.net> al archivo web.config del almacén

Esto debe hacerse para cada almacén en el servidor StoreFront que se usará para enviar datos a Citrix Analytics.

  1. Haz una copia de seguridad del archivo web.config del almacén y cópialo en otra ubicación fuera de C:\inetpub\wwwroot\Citrix\<Store>\web.config.

  2. Modifica el siguiente XML con tu configuración de proxy usando una combinación de FQDN y puerto, o una combinación de IP y puerto.

    Por ejemplo, usando una combinación de FQDN y puerto, usa el siguiente elemento <system.net>:

    <system.net>
    <defaultProxy>
    <proxy proxyaddress="HTTP://proxyserver.example.com:8888" bypassonlocal="true" />
    </defaultProxy>
</system.net>
<!--NeedCopy-->

    Por ejemplo, usando una combinación de IP y puerto, usa el siguiente elemento <system.net>:

    <system.net>
    <defaultProxy>
    <proxy proxyaddress="HTTP://10.0.0.1:8888" bypassonlocal="true" />
    </defaultProxy>
</system.net>
<!--NeedCopy-->

  3. Al final del archivo web.config del almacén, inserta el elemento <system.net> apropiado donde se indica aquí:

    </runtime>
<gcServer enabled="true" />
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
    <assemblyIdentity name="System.Web.MVC" publicKeyToken="31BF3856AD364E35" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-5.0.0.0" newVersion="5.0.0.0" />
    </dependentAssembly>
    <dependentAssembly>
    <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
    <bindingRedirect oldVersion="0.0.0.0-9.0.0.0" newVersion="9.0.0.0" />
    </dependentAssembly>
</assemblyBinding>
</runtime>

Insert the <system.net> element here

</configuration>
<!--NeedCopy-->

  4. Importa los datos de Citrix Analytics como se describe en Importar datos de Citrix Analytics a tu implementación de StoreFront.

Servicio de Citrix Analytics
March 9, 2026
Contribución de: 
C C
March 9, 2026
Contribución de: 
C C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.