Origen de datos de Citrix Virtual Apps and Desktops™

Last published : Oct 24, 2026
Este artículo describe los pasos para conectar sus sitios locales de Citrix Virtual Apps and Desktops a Citrix Analytics mediante StoreFront. Los pasos de incorporación mencionados en este artículo son aplicables a ambas ofertas: Citrix Analytics for Performance (Performance Analytics) y Citrix Analytics for Security (Security Analytics).
Para conocer los pasos de incorporación específicos de cada oferta, consulte los siguientes artículos:
Related information
Fuentes de datos

Incorporar sitios locales de Citrix Virtual Apps and Desktops mediante StoreFront

Si su organización utiliza una implementación local de StoreFront™, debe configurar sus servidores StoreFront para permitir que la aplicación Citrix Workspace™ envíe eventos a Citrix Analytics. Citrix Analytics procesa los eventos para proporcionar información útil sobre el rendimiento de su infraestructura de TI de Citrix y el comportamiento del usuario.
Para obtener más información sobre cómo configurar una implementación de StoreFront para Citrix Analytics, consulte el artículo Servicio Citrix Analytics en la documentación de StoreFront.
Anteriormente, los clientes que utilizaban los sitios locales de Citrix Apps and Desktops estaban obligados a usar la agregación de sitios para incorporar los sitios locales para Citrix Analytics for Security™ y Performance.
Ahora puede incorporar sitios locales de Citrix Apps and Desktops sin depender de la agregación de sitios.
Puede ver la opción Conectar implementación de Storefront en su aplicación de espacio de trabajo, incluso si no tiene ningún sitio agregado a la agregación de sitios.
Conectar implementación de StoreFront

Requisitos previos

Antes de empezar, asegúrese de lo siguiente:
  • Su versión de StoreFront debe ser la 1906 o posterior.
  • La implementación de StoreFront debe poder conectarse a las siguientes direcciones:
    • <https://*.cloud.com>
    • <https://api.analytics.cloud.com>
  • La implementación de StoreFront debe tener el puerto 443 abierto para conexiones salientes a Internet. Cualquier servidor proxy en la red debe permitir esta comunicación con Citrix Analytics.
  • Si la implementación de StoreFront está alojada en un servidor web que utiliza un proxy web para conectarse a Internet, el proxy de cada almacén debe configurarse manualmente para permitir el tráfico saliente. StoreFront no utiliza automáticamente la configuración de proxy del servidor web host. Para obtener más información, consulte Configurar una implementación de StoreFront alojada en un servidor web que utiliza un proxy HTTP.
  • Se debe acceder a la implementación de StoreFront mediante uno de los siguientes clientes:
    • Citrix Receiver™ para sitios web en exploradores compatibles con HTML5.
      Nota
      Si es un usuario de HTML5, Citrix Virtual Apps and Desktops puede iniciar eventos cuando se habilitan ciertas configuraciones en StoreFront. Para obtener información sobre los pasos de configuración, consulte el artículo Instalar en la documentación de Citrix Workspace app para HTML5. Para eventos relacionados con la impresión, se deben configurar políticas adicionales en StoreFront. Para obtener más información, consulte el artículo Impresión de PDF en la documentación de Citrix Workspace app para HTML5.
    • Citrix Workspace app 1907 para Windows o posterior.
    • Citrix Workspace app 2006 para Linux o posterior.
    • Citrix Workspace app 2006 para Mac o posterior
  • Si utiliza Citrix Virtual Apps and Desktops 7 1912 LTSR, la versión de StoreFront compatible es la 1912.

Conectarse a una implementación de StoreFront

Puede conectarse a una implementación de StoreFront de las siguientes maneras:
  • Uso de la tarjeta de sitio Aplicaciones y escritorios – Aplicación Workspace y la tarjeta de sitio Aplicaciones y escritorios – Supervisión
  • Uso del panel Recomendaciones

Conectarse mediante la tarjeta de sitio Aplicaciones y escritorios – Aplicación Workspace y la tarjeta de sitio Aplicaciones y escritorios – Supervisión

  1. Vaya a Configuración > Orígenes de datos > Seguridad. En la tarjeta de sitio Aplicaciones y escritorios – Aplicación Workspace, haga clic en los puntos suspensivos verticales (⋮) y, a continuación, seleccione Conectar implementación de StoreFront.
    Conectar seguridad de la tienda
  2. Vaya a Configuración > Orígenes de datos > Rendimiento. En la tarjeta de sitio Aplicaciones y escritorios – Supervisión, haga clic en los puntos suspensivos verticales (⋮) y, a continuación, seleccione Conectar implementación de StoreFront.
    Conectar rendimiento de las tiendas
    Aparece el asistente de incorporación de StoreFront o la ventana emergente Conectar implementación de StoreFront.
  3. Haga clic en Descargar paquete.
    Asistente de incorporación de StoreFront
    Nota
    El archivo contiene información confidencial. Guarde el archivo en una ubicación segura.
  4. Para configurar la implementación de StoreFront,
    1. Copie el paquete de instalación en el servidor de StoreFront.
    2. Descomprima el archivo copiado y navegue hasta la carpeta en PowerShell.
    3. Debe ejecutar el siguiente comando como administrador para incorporar StoreFront:
      .\Manage-CitrixAnalytics.ps1 –parámetro OnboardStorefront
      Modo de administrador de StoreFront
      Para obtener más opciones o parámetros, consulte la sección Script de PowerShell.
    4. Abra el servidor StoreFront y ejecute el script de PowerShell.
    5. Si el sitio de StoreFront no aparece en la GUI de Citrix Analytics Service incluso después de ejecutar OnboardStorefront, ejecute el comando iisreset.
    6. Inicie sesión en la GUI de Citrix Analytics Service y valide si el Cluster ID coincide con el registrado en la consola por el script.
    7. Una vez completada la configuración, inicie sesión en Citrix Analytics para ver la implementación de StoreFront conectada.
  5. Una vez que la configuración se haya realizado correctamente, haga clic en Done.
  6. Haga clic en Turn On Data Processing para permitir que Citrix Analytics procese los datos.

Script de PowerShell

Se ha introducido un nuevo script de PowerShell para simplificar el proceso de incorporación de StoreFront a Citrix Analytics Service. Este script de PowerShell automatiza el proceso de comprobación de requisitos previos, instalación y configuración de StoreFront. El script de PowerShell debe ejecutarse en modo administrador.
Modo de administrador de StoreFront
Los clientes pueden ejecutar este script de PowerShell en StoreFront para incorporar, desincorporar, realizar autocomprobaciones, solucionar problemas y verificar si la incorporación a la GUI de Citrix Analytics Service se ha realizado correctamente. Cuando un cliente ejecuta el script por primera vez, aparece un mensaje de advertencia de seguridad para confirmar el editor. Seleccione la opción Siempre ejecutar si el editor es de confianza.
Scripts de PowerShell siempre en ejecución
El script de PowerShell está disponible en la página Connect StoreFront Deployment dentro de un archivo zip junto con el archivo StoreFrontConfiguration.json, algunos archivos CCAuth y dll. Los registros del script de PowerShell se guardan en el archivo cas-logs en la carpeta Downloads.
El script de PowerShell admite los siguientes parámetros:
  • SelfCheck: El parámetro SelfCheck se utiliza para validar que se han cumplido los requisitos previos para la incorporación de StoreFront. Realiza una comprobación de la instalación de StoreFront, la versión requerida, la conexión saliente, la conectividad de red del servidor cURL Analytics, la conectividad a Internet, la configuración del grupo de servidores y cualquier configuración existente de Citrix Analytics Service. Utilice el siguiente comando para ejecutar el selfcheck:
    .\Manage-CitrixAnalytics.ps1 –param SelfCheck
  • OnboardStorefront: El parámetro OnboardStoreFront realiza rápidamente una autocomprobación para verificar la preparación de la configuración para Citrix Analytics Service. Si la configuración está lista, importa la configuración de Citrix Analytics Service y publica los cambios en otros servidores del grupo de servidores. Para un grupo de servidores, el comando PublishConfiguration se ejecuta automáticamente desde el script para publicar la configuración de StoreFront en todos los servidores de ese StoreFront. Puede ver una ventana emergente para confirmar la acción PublishConfiguration. Seleccione el botón Yes to All.
    Script de PowerShell sí a todo
    Una vez que la publicación de la configuración se ha completado correctamente, el script realiza una llamada a la API de Citrix Analytics Service para comprobar si StoreFront está incorporado a la GUI de Citrix Analytics Service. Para invocar esta API, se requiere una clave privada para la autenticación. Para generar esta clave privada, necesita los archivos CCAuth y dll, y la credencial que está disponible en su archivo JSON descargado.
    Nota
    Una vez completado el proceso de incorporación de StoreFront, pueden pasar de dos a cinco minutos hasta que StoreFront aparezca en la GUI de Citrix Analytics Service. Si el sitio de StoreFront no aparece en la GUI de Citrix Analytics Service, debe realizar un IISRESET para reiniciar los servicios de información de Internet.
    Utilice el siguiente comando para ejecutar el OnboardStoreFront:
    .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
  • IsOnboarded: El parámetro IsOnboarded se utiliza para verificar si StoreFront está incorporado a la GUI de Citrix Analytics Service. El script espera un minuto antes de salir; sin embargo, StoreFront puede tardar hasta cinco minutos en aparecer en la GUI después de una incorporación exitosa. Debe ejecutar este comando para verificarlo. Este comando también tiene la dependencia de los archivos CCAuth y dll. Utilice el siguiente comando para ejecutar el IsOnboarded:
    .\Manage-CitrixAnalytics.ps1 –param IsOnboarded
  • Troubleshoot: Después de esperar cinco minutos, si el sitio de StoreFront no aparece en la GUI de Citrix Analytics Service, debe realizar un IISRESET para reiniciar los servicios de información de Internet. Si el sitio de StoreFront sigue sin aparecer en la GUI, utilice el parámetro Troubleshoot. Le ayuda a solucionar cualquier problema de conectividad y a recopilar registros. Utilice el siguiente comando para ejecutar el Troubleshoot:
    .\Manage-CitrixAnalytics.ps1 –param TroubleShoot
    El parámetro de solución de problemas es útil para los dos siguientes casos de uso:
    • Caso de uso 1: Como parte de la autocomprobación, si curlAnalytics falló, se crea una regla de firewall. Esta regla de firewall abre un puerto 443 y verifica su conectividad con Analytics. Si no, significa que el servidor de Analytics no es accesible y el script se cierra aquí. Vuelva a ejecutar el script una vez que se restablezca la conectividad con Citrix Analytics Service.
    • Caso de uso 2: Si cURL se ejecutó correctamente y, sin embargo, el sitio de StoreFront no se refleja en la GUI, el administrador debe descargar el archivo zip de la herramienta DebugView desde Descargar DebugView, descomprimirlo y colocarlo en la carpeta Downloads. El script de PowerShell primero desinstala Citrix Analytics Service si ya está configurado. Habilita el registro detallado. Luego, inicia la herramienta DebugView y reinstala Citrix Analytics Service. Finalmente, detiene DebugView y deshabilita el registro detallado.
    Los registros de la vista de depuración se pueden capturar y compartir con el soporte de Citrix. El administrador de Citrix depura y trata de encontrar el problema y resolverlo. Los registros se generan y guardan como un archivo de registro dentro de la carpeta DebugView.
    Debe compartir los tres siguientes archivos de registro con el administrador de Citrix:
    • El archivo de registro de DebugView (Downloads\DebugView\log)
    • El archivo de registro de StoreFront (C:\Program Files\Citrix\Receiver StoreFront\Admin\trace)
    • El archivo de registros de CAS. Estos registros se generan como parte de la ejecución del script y se guardan en la carpeta Downloads > cas-logs.
    Para un grupo de servidores, el comando PublishConfiguration se ejecuta automáticamente cuando el script intenta desincorporar o incorporar StoreFront. El comando PublishConfiguration ayuda a publicar la configuración de StoreFront en todos los servidores dentro de ese StoreFront. Verá una ventana emergente para confirmar esta acción. Seleccione el botón Sí a todo.
    Script de PowerShell sí a todo
  • DeboardStoreFront: El parámetro DeboardStoreFront se utiliza para desincorporar el servidor StoreFront de Citrix Analytics Service. Utilice el siguiente comando para ejecutar DeboardStoreFront:
    .\Manage-CitrixAnalytics.ps1 –param DeboardStoreFront
    El script de PowerShell primero elimina todas las configuraciones de Citrix Analytics Service de StoreFront y verificar que la eliminación se realizó correctamente. Luego, comprueba si ServerGroup está presente y, si lo está, publica la configuración para que las configuraciones eliminadas se publiquen en todos los StoreFront. Finalmente, invoca DeleteSiteOnboarded. Si el sitio no se elimina de la GUI de Citrix Analytics Service, debe eliminar manualmente el sitio de StoreFront con StoreFront Deployment y de la tarjeta del sitio de Workspace Application en StoreFront Deployment.
    Para un grupo de servidores, el comando PublishConfiguration se ejecuta automáticamente desde el script para publicar la configuración de StoreFront en todos los servidores dentro de ese StoreFront. Verá una ventana emergente para confirmar esta acción. Seleccione el botón Sí a todo.
    Script de PowerShell sí a todo

Conectar mediante el panel Recomendaciones

El panel Recomendaciones de la página Orígenes de datos informa al usuario sobre la importancia de incorporar orígenes de datos. Ayuda al usuario a incorporar los orígenes de datos fácilmente y también le ofrece una opción para revisar y asegurarse de que ha incorporado todos los orígenes de datos disponibles.
  1. Si utiliza la oferta de Security Analytics, seleccione Configuración > Orígenes de datos > Seguridad.
  2. Si utiliza la oferta de Performance Analytics, vaya a Configuración > Orígenes de datos > Rendimiento.
  3. En la página Orígenes de datos, revise la información y las recomendaciones del panel Recomendaciones para incorporar la implementación de StoreFront.
    Revisar panel de recomendaciones
    Nota
    La incorporación de un origen de datos de StoreFront permite que la aplicación Workspace envíe datos de telemetría sobre la visibilidad de los puntos finales a Analytics.
  4. Haga clic en Iniciar incorporación. Aparece la página Especificar instancias de StoreFront implementadas.
    Especificar instancias de StoreFront
  5. Para asegurarse de que Analytics incorpore correctamente el origen de datos, especifique el Número total de instancias de StoreFront implementadas.
    Nota:
    El Número total de instancias de StoreFront implementadas es el número total de grupos de StoreFront y no el número de servidores individuales de StoreFront.
  6. Haga clic en Continuar. Aparece el asistente de incorporación de StoreFront o la ventana emergente Conectar implementación de StoreFront.
  7. En la página Conectar implementación de StoreFront, haga clic en Descargar paquete para descargar el paquete de instalación.
    Asistente de incorporación de StoreFront(/en-us/citrix-analytics/media/sf-onboarding-wizard.png)
    Notas
    El archivo contiene información confidencial. Guarde el archivo en una ubicación segura.
    Puede descargar un paquete y usarlo para incorporar un solo grupo de StoreFront. Si tiene varios grupos de StoreFront, debe descargar el paquete por separado para cada grupo de StoreFront. Una vez finalizada la incorporación de un grupo de StoreFront con un paquete, descargue el paquete de nuevo y continúe con la incorporación del siguiente grupo de StoreFront.
    Si la incorporación de StoreFront no se completa correctamente en un plazo de dos días utilizando un paquete debido a algún problema, debe volver a descargar un nuevo paquete después de dos días. Esto se debe a que la clave dentro del paquete caducará si no se incorpora correctamente en un plazo de dos días.
  8. Para configurar la implementación de StoreFront,
    1. Copie el paquete de instalación en el servidor de StoreFront.
    2. Descomprima el archivo copiado y navegue hasta la carpeta en PowerShell.
    3. Ejecute el siguiente comando para incorporar StoreFront:
      .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront
    4. Abra el servidor de StoreFront y ejecute el script de PowerShell.
    5. Si el sitio de StoreFront no aparece en la GUI de Citrix Analytics Service, ejecute el siguiente comando:
      Execute iisreset
    6. Registre y verificar el ID de clúster disponible en el script de PowerShell.
    7. Una vez finalizada la configuración, inicie sesión en Citrix Analytics para ver la implementación de StoreFront conectada.
  9. Después de que la configuración sea correcta, haga clic en Listo.
Si está incorporando a través del panel Recomendaciones, el sistema obtiene el número de implementaciones de StoreFront que ha incorporado al servicio Citrix Analytics. Aparece el panel Recomendaciones y puede revisar las implementaciones de StoreFront incorporadas. Puede revisar el mensaje en el panel Recomendaciones y hacer clic en Marcar como completado.
Nota
El panel Recomendaciones y los mensajes desaparecen solo cuando se incorporan todas las implementaciones de StoreFront declaradas.
  1. Haga clic en Activar procesamiento de datos para permitir que Citrix Analytics procese los datos.

Revisar el panel Recomendaciones

Puede comparar el número de implementaciones de StoreFront declaradas con el número de implementaciones de StoreFront incorporadas en el panel Recomendaciones.
Si el número de implementaciones de StoreFront declaradas es el mismo que el número de implementaciones de StoreFront incorporadas, aparece un mensaje de Todo incorporado que indica que todas las implementaciones de StoreFront están incorporadas. Puede revisar el mensaje en el panel Recomendaciones y hacer clic en Marcar como completado.
Nota
Si desea incorporar más implementaciones de StoreFront, haga clic en Ver pasos de incorporación y el asistente de incorporación de StoreFront o la ventana emergente Conectar implementación de StoreFront aparecerá de nuevo.
Revisar instancias de StoreFront incorporadas
Si el número de implementaciones de StoreFront declaradas es menor que el número de implementaciones de StoreFront incorporadas, haga clic en Editar recuento y aparecerá la página Especificar instancias de StoreFront implementadas. A continuación, puede introducir el Número total de instancias de StoreFront implementadas y hacer clic en Continuar. El asistente de incorporación de StoreFront o la ventana emergente Conectar implementación de StoreFront aparecerá de nuevo. Siga los pasos para incorporar más implementaciones de StoreFront.
Nota:
El Número total de instancias de StoreFront implementadas es el número total de grupos de StoreFront y no el número de servidores de StoreFront individuales.
Completar la incorporación de StoreFront

Ver implementaciones de StoreFront conectadas

Las implementaciones de StoreFront aparecen en la tarjeta del sitio solo si la configuración es correcta. La tarjeta del sitio muestra cuántas implementaciones de StoreFront han establecido conexiones con Citrix Analytics.
  • Si utiliza la oferta de Performance Analytics, verá la siguiente información en la tarjeta del sitio de Aplicaciones y escritorios - Supervisión:
    Vista de almacén de Performance Analytics
  • Si utiliza la oferta de Security Analytics, verá la siguiente información en la tarjeta del sitio de aplicación Workspace:
    Ver almacenes
Haga clic en el número de implementaciones de StoreFront en la tarjeta del sitio para ver los grupos de servidores.
Cada implementación de StoreFront está representada por una URL base y un ServerGroupID.
Grupo de StoreFront
Si utiliza la oferta de Security Analytics, la tarjeta del sitio también muestra la siguiente información sobre los eventos recibidos:
  • Los eventos recibidos de las implementaciones de StoreFront durante la última hora, que es la selección de tiempo predeterminada. También puede seleccionar 1 semana (1 S) y ver los datos. Haga clic en el número de eventos recibidos para ver los eventos en la página de búsqueda de autoservicio.
    Eventos recibidos de Security Analytics
  • Después de habilitar el procesamiento de datos, la tarjeta del sitio podría mostrar el estado de No se recibieron datos. Este estado aparece por dos razones:
    1. Si ha activado el procesamiento de datos por primera vez, los eventos tardan un tiempo en llegar al centro de eventos de Citrix Analytics. Cuando Citrix Analytics recibe los eventos, el estado cambia a Procesamiento de datos activado. Si el estado no cambia después de un tiempo, actualice la página Orígenes de datos.
    2. Citrix Analytics no ha recibido ningún evento del origen de datos en la última hora.
      No hay aplicaciones de datos virtuales(/en-us/citrix-analytics/media/no-data-cvad-sf-1.png)

Agregar o quitar implementaciones de StoreFront

Para agregar una implementación de StoreFront, haga clic en Conectar con implementaciones de StoreFront en la sección Implementaciones de StoreFront. Descargue el archivo de configuración y siga los pasos para configurar una implementación de StoreFront.
Agregar almacenes(/en-us/citrix-analytics/media/store-front-added-1.png)
Para detener la transmisión de eventos desde una implementación de StoreFront configurada y quitarla de Citrix Analytics:
  1. Vaya a la implementación de StoreFront que quiere quitar de Citrix Analytics. Ejecute el siguiente comando para quitar la configuración de su servidor StoreFront:
    Remove-STFCasConfiguration
  2. Si utiliza una implementación multiservidor, ejecute el siguiente comando para propagar los cambios y quitar la configuración de todos los servidores del grupo de servidores de StoreFront:
    Publish-STFServerGroupConfiguration
  3. Ejecute el siguiente comando para verificar que la configuración se ha quitado correctamente. El comando no devuelve nada si la configuración se ha quitado correctamente.
    Get-STFCasConfiguration
  4. Vuelva a iniciar sesión en Citrix Analytics y elija la implementación de StoreFront en la sección Implementaciones de StoreFront. Haga clic en los puntos suspensivos verticales (⋮) y seleccione Quitar implementaciones de StoreFront de Analytics.
    Quitar almacén(/en-us/citrix-analytics/media/store-front-remove-1.png)
    Nota
    Ejecute los comandos especificados en la implementación de StoreFront antes de quitarla de Citrix Analytics. Si no ejecuta los comandos, Citrix Analytics seguirá recibiendo los eventos y la implementación de StoreFront se volverá a agregar en el siguiente ciclo de sondeo de eventos.

Configurar una implementación de StoreFront alojada en un servidor web que utiliza un proxy HTTP

Si un StoreFront está alojado en un servidor web que utiliza un proxy web para conectarse a Internet, el almacén debe configurarse manualmente para registrarse con Citrix Analytics. Esta configuración requiere que agregue una sección <system.net> al archivo web.config del almacén. Debe configurar cada almacén en la implementación de StoreFront que envía eventos a Citrix Analytics.
Hay dos métodos para agregar la sección <system.net> al archivo web.config del almacén:
  • Configure el proxy del almacén a través de PowerShell para uno o varios almacenes (método recomendado).
  • Agregue manualmente una sección <system.net> al archivo web.config del almacén.
Para obtener más información sobre estos métodos, consulte el artículo Configurar StoreFront para usar un proxy web para contactar con Citrix Cloud y registrarse en Citrix Analytics en la documentación de StoreFront.