Origen de datos de Citrix Virtual Apps and Desktops

En este artículo se describen 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 se aplican tanto a las 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:

• Configuración de sitios locales de Citrix Virtual Apps and Desktops con Citrix Analytics for Performance

• Configuración del origen de datos Citrix Virtual Apps and Desktops y Citrix DaaS para Citrix Analytics for Security

Incorporar sitios locales de Citrix Virtual Apps and Desktops mediante StoreFront

Si su organización usa una implementación local de StoreFront, debe configurar los 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 la infraestructura de TI de Citrix y el comportamiento de los usuarios.

Para obtener más información sobre cómo configurar una implementación de StoreFront para Citrix Analytics, consulte el artículo del servicio Citrix Analytics en la documentación de StoreFront.

Anteriormente, se obligaba a los clientes que utilizaban los sitios locales de Citrix Apps and Desktops 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, aunque no tenga ningún sitio agregado a la agregación de sitios.

Requisitos previos

Antes de empezar, asegúrate de lo siguiente:

• La versión de StoreFront debe ser 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 las conexiones de Internet salientes. Todos los servidores proxy de la red deben 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 proxy HTTP.

• Se debe acceder a la implementación de StoreFront mediante uno de los siguientes clientes:

  • Citrix Receiver para sitios web en exploradores web compatibles con HTML5.

    Nota

    Si es un usuario de HTML5, Citrix Virtual Apps and Desktops puede lanzar eventos cuando determinadas configuraciones estén habilitadas en StoreFront. Para obtener información sobre los pasos de configuración, consulte el artículo Instalar de la documentación de la aplicación Citrix Workspace para HTML5. Para eventos relacionados con la impresión, se deben configurar directivas adicionales en StoreFront. Para obtener más información, consulte el artículo Impresión de PDF en la documentación de la aplicación Citrix Workspace para HTML5.

  • Aplicación Citrix Workspace 1907 para Windows o posterior.

  • Aplicación Citrix Workspace 2006 para Linux o posterior.

  • Aplicación Citrix Workspace 2006 para Mac o posterior

• Si utiliza Citrix Virtual Apps and Desktops 7 1912 LTSR, la versión de StoreFront admitida es 1912.

Conexión a una implementación de StoreFront

Puede conectarse a una implementación de StoreFront de las siguientes maneras:

• Uso de las tarjetas de sitio Aplicaciones y escritorios: Aplicación Workspace y Aplicaciones y escritorios: Supervisión

• Uso del panel Recomendaciones

Conectarse mediante las tarjetas de sitio Aplicaciones y escritorios: Aplicación Workspace y Aplicaciones y escritorios: Supervisión

1. Vaya a Configuración > Orígenes de datos > Seguridad. En la tarjeta del sitio Aplicaciones y escritorios: Aplicación Workspace, haga clic en los puntos suspensivos verticales (⋮) y, a continuación, seleccione Conectar implementación de StoreFront.

   

2. Vaya a Configuración > Orígenes de datos > Rendimiento. En la tarjeta del sitio Aplicaciones y escritorios: Supervisión, haga clic en los puntos suspensivos verticales (⋮) y, a continuación, seleccione Conectar implementación de StoreFront.

   

   Aparece el asistente de incorporación de StoreFront o la ventana emergente Conecar implementación de StoreFront.

3. Haz clic en Descargar paquete.

   

   Nota

   El archivo contiene información confidencial. Guarde el archivo en un lugar seguro y protegido.

4. Para configurar la implementación de StoreFront,

   1. Copie el paquete de instalación en el servidor StoreFront.

   2. Descomprime el archivo copiado y navega hasta la carpeta de PowerShell.

   3. Debe ejecutar el siguiente comando como administrador para incorporar StoreFront:

      .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront

      

      Para obtener más opciones o parámetros, consulte la secciónScript 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 compruebe si el ID del clúster coincide con el registrado en la consola mediante el script.

   7. Una vez realizada la configuración, inicie sesión en Citrix Analytics para ver la implementación de StoreFront conectada.

5. Cuando la configuración se haya realizado correctamente, haga clic en Listo.

6. Haga clic en Activar procesamiento de datos 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.

Los clientes pueden ejecutar este script de PowerShell en StoreFront para incorporarlo, eliminarlo, realizar autocomprobaciones, solucionar problemas y comprobar 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 confirmarlo en el editor. Seleccione la opción Ejecutar siempre si el publicador es de confianza.

El script de PowerShell está disponible en la página de implementación de Connect StoreFront dentro de un archivo zip junto con el archivo StoreFrontConfiguration.json y algunos archivos CCAuth y DLL. Los registros de los scripts de PowerShell se guardan en el archivo cas-logs, en la carpeta Descargas.

El script de PowerShell admite los siguientes parámetros:

• SelfCheck: el parámetro SelfCheck se usa para validar que se cumplen los requisitos previos para la incorporación de StoreFront. Comprueba 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 la autocomprobación:

  .\Manage-CitrixAnalytics.ps1 –param SelfCheck

• OnboardStorefront: el parámetro OnboardStorefront realiza rápidamente una autocomprobación para verificar la preparación para la configuración de 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. Aparecerá una ventana emergente para confirmar PublishConfiguration la acción. Seleccione el botón Sí a todo.

  

  Una vez que la publicación de la configuración se haya completado correctamente, el script realiza una llamada a la API de Citrix Analytics Service para comprobar si StoreFront está integrado en 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 el archivo JSON descargado.

  Nota:

  Una vez finalizado el proceso de incorporación de StoreFront, StoreFront puede tardar de dos a cinco minutos en aparecer 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 restablecer los servicios de información de Internet.

  Use el siguiente comando para ejecutar OnboardStoreFront:

  .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront

• ISonBoarded: el parámetro ISonBoarded se usa para comprobar 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 una vez que se haya integrado correctamente. 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

• Soluciónde problemas: Tras esperar cinco minutos, si el sitio de StoreFront no aparece en la GUI de Citrix Analytics Service, debe realizar un IISRESET para restablecer los servicios de información de Internet. Si el sitio de StoreFront sigue sin aparecer en la GUI, use el parámetro Troubleshoot. Le ayuda a solucionar cualquier problema de conectividad y a recopilar registros. Utilice el siguiente comando para ejecutar la solución de problemas:

  .\Manage-CitrixAnalytics.ps1 –param TroubleShoot

  El parámetro de solución de problemas es útil para los dos casos de uso siguientes:

  • Caso de uso 1: Como parte de la autocomprobación, si el CURLAnalytics ha fallado, se crea una regla de firewall. Esta regla de firewall abre un puerto 443 y verifica su conectividad con Analytics. Si no es así, significa que no se puede acceder al servidor de Analytics y el script sale de aquí. Vuelva a ejecutar el script una vez que se restablezca la conectividad con Citrix Analytics Service.

  • Caso de uso 2: Si la cURL funciona 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 Download DebugView, descomprimirlo y colocarlo en la carpeta Descargas. El script de PowerShell primero desinstala Citrix Analytics Service si ya está configurado. Permite el registro detallado. A continuación, inicia la herramienta DebugView y vuelve a instalar Citrix Analytics Service. Por último, detiene DebugView y desactiva el registro verboso.

  Los registros de la vista de depuración se pueden capturar y compartir con Citrix Support. El administrador de Citrix sigue depurando e intenta averiguar el problema y resolverlo. Los registros se generan y guardan como un archivo de registro dentro de la carpeta DebugView.

  Debe compartir los tres archivos de registro siguientes con el administrador de Citrix:

  • El archivo de registro de DebugView (Downloads\ DebugView\ log)
  • El archivo de registro de StoreFront (C:\Archivos de programa\Citrix\Receiver StoreFront\Admin\trace)
  • El archivo de registros CAS. Estos registros se generan como parte de la ejecución del script y se guardan en la carpeta Descargas > cas-logs.

  En el caso de un grupo de servidores, el PublishConfiguration comando se ejecuta automáticamente cuando el script intenta eliminar o incorporar StoreFront. El comando PublishConfiguration ayuda a publicar la configuración de StoreFront en todos los servidores de ese StoreFront. Aparecerá una ventana emergente para confirmar esta acción. Seleccione el botón Sí a todo.

  

• DeboardStorefront: el parámetro DeboardStorefront se usa para anular la incorporación del servidor StoreFront de Citrix Analytics Service. Use 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 comprueba que la eliminación se ha realizado correctamente. A continuación, comprueba si el ServerGroup está presente y, a continuación, publica la configuración para que las configuraciones eliminadas se publiquen en todos los StoreFront. Por último, 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 de sitio de la aplicación Workspace en la implementación de StoreFront.

  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. Aparecerá una ventana emergente para confirmar esta acción. Seleccione el botón Sí a todo.

  

Conéctese mediante el panel Recomendaciones

El panel Recomendaciones de la página Orígenes de datos informa al usuario sobre la importancia de incorporar los orígenes de datos. Ayuda al usuario a incorporar fácilmente los orígenes de datos y también le brinda la opción de revisar y asegurarse de que ha incorporado todos los orígenes de datos disponibles.

1. Si utiliza la oferta de análisis de seguridad, seleccione Configuración > Orígenes de datos > Seguridad.

2. Si utiliza la oferta 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.

   

   Nota

   La incorporación de un origen de datos de StoreFront permite a la aplicación Workspace enviar datos de telemetría sobre la visibilidad de los dispositivos de punto final a Analytics.

4. Haga clic en Comenzar la incorporación. Aparece la página Especificar instancias de Storefront implementadas.

   

5. Para garantizar que Analytics incorpore correctamente el origen de datos, especifique el total de instancias de StoreFront implementadas.

   Nota:

   La cantidad total de instancias de StoreFront implementadas es la cantidad total de grupos de StoreFront y no la cantidad de servidores StoreFront individuales.

6. Haga clic en Continuar. Aparece el asistente de incorporación de StoreFront o la ventana emergente Conecar implementación de StoreFront.

7. En la página de implementación de Connect StoreFront, haga clic en Descargar paquete para descargar el paquete de instalación.

   

   Notas

   El archivo contiene información confidencial. Guarde el archivo en un lugar seguro y protegido.

   Puede descargar un paquete y usarlo solo para incorporar un grupo de StoreFront. Si tiene varios grupos de StoreFront, debe descargar el paquete por separado para cada grupo. Una vez finalizada la incorporación de un grupo de StoreFront con un paquete, vuelva a descargar el paquete 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 con un paquete debido a algún problema, debe volver a descargar un paquete nuevo transcurridos dos días. Esto se debe a que la clave del paquete caducará si no se ha incorporado 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 StoreFront.

   2. Descomprime el archivo copiado y navega hasta la carpeta de PowerShell.

   3. Ejecute el siguiente comando para incorporar StoreFront:

      .\Manage-CitrixAnalytics.ps1 –param OnboardStorefront

   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, ejecute el siguiente comando:

      Execute iisreset

   6. Registre y verifique el ID de clúster que está disponible en el script de PowerShell.

   7. Una vez realizada la configuración, inicie sesión en Citrix Analytics para ver la implementación de StoreFront conectada.

9. Cuando la configuración se haya realizado correctamente, haga clic en Listo.

Si realiza la incorporación 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 integradas. Puede revisar el mensaje en el panel Recomendaciones y hacer clic en Marcar como completado.

Nota

El panel Recomendaciones y los mensajes solo desaparecen cuando se han incorporado todas las implementaciones declaradas de Storefront.

1. Haga clic en Activar procesamiento de datos para permitir que Citrix Analytics procese los datos.

Revisar el panel Recomendaciones

Puede comparar la cantidad de implementaciones de StoreFront declaradas con la cantidad de implementaciones de StoreFront incorporadas en el panel Recomendaciones.

Si la cantidad de implementaciones de StoreFront declarados es la misma que la cantidad de implementaciones de StoreFront incorporadas, aparece el mensaje All Onboarded 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 quiere incorporar más implementaciones de StoreFront, haga clic en Ver los pasos de incorporación y aparecerá de nuevo el asistente de incorporación de StoreFront o la ventana emergente Conectar implementación de StoreFront.

Si la cantidad de implementaciones de StoreFront declaradas es inferior a la cantidad de implementaciones de StoreFront incorporadas, haga clic en Modificar recuento, y aparecerá la página Especificar instancias de StoreFront implementadas. A continuación, puede introducir la cantidad total de instancias de StoreFront implementadas y hacer clic en Continuar. Aparecerán de nuevo el asistente de incorporación de StoreFront o la ventana emergente Conectar implementación de StoreFront. Siga los pasos para incorporar más implementaciones de StoreFront.

Nota:

La cantidad total de instancias de StoreFront implementadas es la cantidad total de grupos de StoreFront y no la cantidad de servidores StoreFront individuales.

Ver implementaciones de StoreFront conectadas

Las implementaciones de StoreFront aparecen en la tarjeta del sitio solo si la configuración se realiza correctamente. La tarjeta del sitio muestra cuántas implementaciones de StoreFront han establecido conexiones con Citrix Analytics.

• Si utiliza la oferta Análisis de rendimiento, verá la siguiente información en la tarjeta de sitio de supervisión de aplicaciones y escritorios :

  

• Si utiliza la oferta Security Analytics, verá la siguiente información en la tarjeta del sitio de la aplicación Workspace :

  

Haga clic en el número de implementaciones de StoreFront de la tarjeta de sitio para ver los grupos de servidores.

Cada implementación de StoreFront se representa mediante una URL base y un ServerGroupID.

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 W) y ver los datos. Haga clic en el número de eventos recibidos para verlos en la página de búsqueda de autoservicio.

  

• Después de habilitar el procesamiento de datos, es posible que la tarjeta del sitio muestre el estado Sin datos recibidos. Este estado aparece por dos motivos:

  1. Si activó 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 Data processing on. Si el estado no cambia después de algún tiempo, actualice la página Orígenes de datos.

  2. Citrix Analytics no recibió ningún evento del origen de datos en la última hora.

     

Agregar o quitar implementaciones de StoreFront

Para agregar una implementación de StoreFront, haga clic en Conectarse a 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.

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 eliminar los valores de configuración del servidor StoreFront:

   Remove-STFCasConfiguration
   

2. Si utiliza la implementación multiservidor, ejecute el siguiente comando para propagar los cambios y eliminar los valores de configuración de todos los servidores del grupo de servidores StoreFront:

   Publish-STFServerGroupConfiguration
   

3. Ejecute el siguiente comando para comprobar que los valores de configuración se han 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 Eliminar implementaciones de StoreFront de Analytics.

   

   Nota

   Ejecute los comandos especificados en la implementación de StoreFront antes de quitarlo de Citrix Analytics. Si no ejecuta los comandos, Citrix Analytics sigue recibiendo los eventos y la implementación de StoreFront se agrega de nuevo en el siguiente ciclo de agrupación de eventos.

Configurar una implementación de StoreFront alojada en un servidor web que utiliza 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 en Citrix Analytics. Esta configuración requiere que agregue una sección <system.net> al archivo web.config del almacén. Debe configurar todos los almacenes de la implementación de StoreFront que envían eventos a Citrix Analytics.

Hay dos métodos mediante los cuales puede agregar la sección <system.net> al archivo web.config del almacén:

• Establezca la configuración del proxy de almacén mediante 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 ponerse en contacto con Citrix Cloud y registrarse en Citrix Analytics de la documentación de StoreFront.