Solucionar problemas

Registros de HTML5

Citrix Workspace app para HTML5 proporciona marcas de tiempo para los registros generados por el dispositivo del usuario.

Nota:

• Para ayudar a solucionar problemas, puede ver los registros de sesión de Citrix Workspace app para HTML5.

La página de registros permite a los usuarios:

• Habilitar registro: Habilite el registro para ver los registros de HTML5.
• Deshabilitar registro: Deshabilite el registro para detener el registro en una sesión.
• Ver registros: Vea los registros generados para una sesión.
• Borrar registros: Elimine el archivo de registro generado en una sesión.
• Descargar archivo de registro: Descargue el archivo de registro en la ubicación deseada.

Citrix Workspace app admite la recopilación de registros para sesiones de aplicaciones y escritorios virtuales en curso. Anteriormente, solo se recopilaban registros para las sesiones iniciadas después de seleccionar Iniciar registro durante una sesión en curso. Ahora, los registros se recopilan para las sesiones en curso y las siguientes hasta que seleccione Detener registro.

Mejora de la solución de problemas para dispositivos móviles

Puede acceder rápidamente al archivo de registro de la sesión tocando la opción Obtener registros. La opción de registro se ha renombrado de Registro a Obtener registros. Cuando selecciona Obtener registros en el menú secundario, el archivo de registro se descarga en su dispositivo, a diferencia de lo que ocurre en una nueva pestaña del navegador.

Nota:

Puede recopilar registros de la sesión actual y de un máximo de las cinco sesiones anteriores.

Cómo recopilar registros

Para recopilar registros del cliente de Citrix Workspace app para HTML5, haga lo siguiente:

1. Inicie sesión en Citrix Workspace app para HTML5.

2. Acceda a la página Archivos de registro de la siguiente manera:
   • Para las versiones 1908 y posteriores de Citrix Workspace app, abra una nueva pestaña y vaya a siteurl/Clients/HTML5Client/src/SessionWindow.html#engineType=log, donde siteurl es la URL del sitio de Workspace para Web, por ejemplo, https://server.domain/Citrix/StoreWeb.
   • Para las versiones 1907 y anteriores de Citrix Workspace app, abra una nueva pestaña y vaya a siteurl/Clients/HTML5Client/src/ViewLog.html, donde siteurl es la URL del sitio de Citrix Workspace para Web, por ejemplo, https://server.domain/Citrix/StoreWeb.

3. En la página Archivos de registro, haga clic en Iniciar registro.

   

   El registro se habilita para el próximo inicio de sesión, no para la sesión activa actual (si la hay).

4. Inicie sesión en Citrix Workspace app, inicie su sesión de aplicación virtual y reproduzca el problema para recopilar registros. Continúe trabajando en la sesión para reproducir el problema.

5. Cierre la sesión una vez que se haya reproducido el problema.

6. Los archivos de registro generados para la sesión de Citrix Workspace app para HTML5 se muestran en la página de registro.

   

7. Haga clic en el botón de flecha para descargar y guardar el archivo de registro.

   

Nota:

• Para habilitar y ver los registros de Citrix Workspace app para HTML5, puede usar la opción Registro del menú de la barra de herramientas de la sesión.

Cómo recopilar registros de la consola

Para recopilar los registros de la consola de Citrix Workspace app para HTML5, haga lo siguiente:

1. Abra las Herramientas para desarrolladores en la pestaña del navegador donde se ejecuta la sesión. Por ejemplo, en el navegador Google Chrome, las Herramientas para desarrolladores se encuentran en la opción Más herramientas.

   

2. Haga clic en Consola en la herramienta para desarrolladores abierta.

3. Haga clic con el botón derecho y seleccione la opción Guardar como para guardar todos los registros.

   

Cómo recopilar registros de redirección USB

Para habilitar el registro y recopilar registros de problemas relacionados con la redirección USB, haga lo siguiente:

Habilitar registros

1. Edite el archivo configuration.js y vaya a la sección HTML5_CONFIG.

2. Agregue el valor moreLogs{‘usb’: true}. Esta configuración es relevante para StoreFront. El archivo configuration.js se encuentra en C:\program Files\Citrix <actual path>\HTML5Client.

Recopilar registros

Para recopilar registros, consulte Cómo recopilar registros.

Registros de dispositivos

Para recopilar registros de dispositivos, abra una nueva pestaña en el navegador Google Chrome e introduzca chrome://device-log y comparta los registros.

Cómo recopilar registros de optimización de Microsoft Teams

La optimización de Microsoft Teams admite la versión 1.10.0.0 de la biblioteca shim más reciente.

Para saber la versión actual de shim que utiliza:

1. Abra la aplicación Microsoft Teams e inicie una llamada con uno de los usuarios.

2. Maximice la ventana de Microsoft Teams una vez establecida la llamada.

3. Abra el teclado en pantalla dentro de la sesión y haga clic en las teclas Ctrl + Alt + Mayús + 1.

   Ahora puede ver los archivos de registro en la carpeta de descargas del VDA.

4. Abra el archivo MSTeams_Diagnostics Log <date><time>.txt y busque la versión de shim en type_script. Por ejemplo, “version”:{“type_script”:”1.10.0.0”}.

Recopilación de registros mejorada

A partir de la versión 2411, los usuarios pueden descargar los registros de la aplicación Citrix Workspace™ en un archivo zip, lo que simplifica la recuperación y el análisis de los registros para una mejor solución de problemas y una experiencia de usuario mejorada.

Las siguientes son las ventajas de la función:

• Los usuarios ya no necesitan recopilar manualmente archivos de registro individuales.
• El proceso optimizado hace que el acceso a los registros sea más eficiente.
• El fácil acceso a registros completos ayuda a una depuración más rápida y eficaz.

Rastreo siempre activo (AOT)

La aplicación Citrix Workspace para HTML5 ahora es compatible con el Rastreo siempre activo (AOT), un marco de diagnóstico moderno de Citrix que captura continuamente datos de registro relevantes en todo el entorno de Citrix Virtual Apps and Desktops. Esta función simplifica la solución de problemas para los administradores de TI y los equipos de soporte de Citrix al capturar automáticamente los datos de registro de las sesiones de usuario y los eventos del sistema, lo que elimina la necesidad de reproducir los problemas.

AOT hace que los registros sean fácilmente accesibles y legibles sin necesidad de conocimientos de ingeniería, lo que permite diagnósticos de autoservicio para reducir la dependencia del soporte de Citrix y mejorar el tiempo medio de resolución.

Ventajas

AOT proporciona un valor significativo a los clientes al:

• Capturar automáticamente los datos de registro de las sesiones de usuario y los eventos del sistema sin intervención manual
• Eliminar la necesidad de reproducir problemas, ya que los registros se recopilan continuamente durante las operaciones normales
• Hacer que los registros sean fácilmente accesibles y legibles sin requerir conocimientos de ingeniería
• Permitir diagnósticos de autoservicio para reducir la dependencia del soporte de Citrix
• Mejorar el tiempo medio de resolución para escenarios de solución de problemas

Casos de uso

AOT se integra en su experiencia general en los siguientes escenarios:

• Supervisión proactiva: Supervise continuamente las sesiones de usuario y los eventos del sistema para identificar posibles problemas antes de que afecten a los usuarios
• Resolución rápida de problemas: Acceda a datos de registro completos inmediatamente cuando ocurran problemas, sin esperar a la reproducción del registro
• Soporte de autoservicio: Permita que los administradores de TI diagnostiquen y resuelvan problemas comunes de forma independiente utilizando datos de registro accesibles

Cargar registros AOT en el servidor de registros AOT centralizado

El servidor de registros AOT actúa como un destino centralizado para recopilar y almacenar registros de Always On Tracing (AOT) de varios componentes de Citrix®. Está en contenedores utilizando tecnología Docker y se implementa preferentemente en Linux, aunque también es compatible con entornos Windows a través de Docker Desktop.

Nota:

Citrix Workspace app para HTML5 2603 ahora admite la carga de registros AOT a servidores de registros centralizados para configuraciones locales que incluyen una puerta de enlace en la ruta.

A partir de Citrix Workspace app para HTML5 2603, puede deshabilitar la función AOT agregando la siguiente configuración:

{
  "aot": {
    "enabled": false
  }
}
<!--NeedCopy-->

Requisitos previos

Esta función solo está disponible cuando abre una sesión utilizando:

• Citrix Virtual Apps and Desktops™ versión 2507 CU1 o posterior

• Citrix Virtual Apps and Desktops™ versión 2511 o posterior

Limitaciones

Los registros de AOT no se pueden cargar si el servidor de registros utiliza HTTP al usar los navegadores Mozilla Firefox y Apple Safari.

Cómo configurar

Para configurar, primero debe instalar y configurar el servidor de registros. Para ver los pasos detallados de instalación y configuración, consulte Instalar y configurar el servidor de registros.

Después de instalar el servidor de registros, el sistema genera un script StartLogServer en la misma ubicación. El nombre del archivo es StartLogServer.bat en Windows o StartLogServer.sh en Linux.

Para habilitar la comunicación entre la aplicación Citrix Workspace para HTML5 y el servidor de registros, debe configurar el servidor de registros para que acepte la URL FQDN de StoreFront habilitando el uso compartido de recursos de origen cruzado (CORS) en el servidor de registros.

Para habilitar CORS:

1. Si el servidor de registros está en ejecución, deténgalo con el siguiente comando:

   docker stop logserver
   <!--NeedCopy-->

1. Agregue los siguientes argumentos de entorno a StartLogServer.bat (o StartLogServer.sh en Linux) editando el parámetro CORS_ORIGINS:

   -e CORS_ORIGINS=""
   <!--NeedCopy-->

Ejemplo para una sola URL:

   -e CORS_ORIGINS="https://xyz.bvt.local;"
   <!--NeedCopy-->

Ejemplo para varias URL:

   -e CORS_ORIGINS="url1;url2;url3"
   <!--NeedCopy-->

Utilice punto y coma (;) para separar varias URL.

1. Reinicie el servidor de registros con StartLogServer.bat (o StartLogServer.sh en Linux).

Experiencia del usuario final

En la pantalla Archivos de registro, haga clic en Descargar todos los registros. La aplicación recopila todos los archivos de registro relevantes y los comprime en un archivo zip. El archivo descargado utiliza una convención de nomenclatura estandarizada, como CWA_HTML5_LOGS_[timestamp].zip, lo que garantiza claridad y fácil identificación.

Para obtener más información, consulte Cómo recopilar registros.

Ver la telemetría de los puntos finales en Citrix Director

Esta función mejora la capacidad de los administradores para ver los datos de telemetría de los puntos finales directamente en Citrix Director.

Requisitos previos

• Citrix Workspace app para HTML5 2411 y versiones posteriores
• VDA versión 2411 y versiones posteriores
• Citrix Director

Diagnóstico de inicio de sesión

A partir de la versión 2502, hemos implementado un proceso de soporte mejorado para los errores de sesión. Los administradores de la mesa de ayuda ahora cuentan con información completa sobre las rutas de error, lo que les permite clasificar de manera efectiva y reducir significativamente el número de casos de soporte relacionados con errores de sesión.

Para obtener más información, consulte Diagnóstico de inicio de sesión en la documentación de Citrix Monitor.

Deshabilitar la descarga de registros de Citrix Workspace app en los cuadros de diálogo de error

A partir de la versión 2505, los administradores pueden ocultar el botón Descargar registro en todos los cuadros de diálogo de error para las sesiones de aplicaciones y de escritorios en Citrix Workspace app para HTML5 (en la nube y local).

Nota:

Esta función está deshabilitada de forma predeterminada. En otras palabras, el usuario tiene la opción de descargar los registros desde el cuadro de diálogo de error.

Para obtener más información, consulte Deshabilitar la descarga de registros de Citrix Workspace app en los cuadros de diálogo de error.

Registros para solucionar problemas de compatibilidad con el inicio de sesión único de Entra ID para VDA con la configuración de credenciales de Azure AD

Este artículo describe los registros que puede recopilar cuando el SSO falla y los usuarios reciben solicitudes de credenciales inesperadas después de que se inicie la sesión.

Para recopilar registros:

1. Recopile los registros básicos de la aplicación Citrix Workspace. Para obtener más información, consulte Cómo recopilar registros.

2. Recopile los seguimientos de red para el estado de obtención de tokens de la Biblioteca de autenticación de Microsoft (MSAL):

   i. Instale Charles o Fiddler en el punto final. ii. Inicie sesión en Microsoft Entra ID Store en el explorador donde se produce el problema. iii. Inicie la aplicación Charles o Fiddler. iv. Inicie la sesión de la aplicación Citrix Workspace para HTML5. Después de reproducir el problema, exporte los seguimientos de Fiddler haciendo clic en Archivo > Guardar > Todas las sesiones. Esto descarga los seguimientos que comparte con Citrix. Para obtener más información, consulte la siguiente captura de pantalla:

   

3. Recopile los seguimientos de Citrix Diagnostic Facility (CDF) del VDA para todos los módulos y el seguimiento de inicio. Siga los pasos para recopilar un seguimiento CDF al iniciar el sistema porque el SSO puede fallar incluso con una negociación de capacidades correcta desde la aplicación Citrix Workspace.

Preguntas frecuentes

¿Dónde puedo encontrar la información más reciente sobre las funciones o mejoras recién añadidas?

Puede encontrar la información más reciente sobre la aplicación Citrix Workspace para HTML5 en la documentación del producto.

¿Cómo acceder a las funciones de vista previa técnica?

Para conocer las funciones que están en vista previa técnica, consulte Funciones en vista previa técnica.

¿Cómo enviar comentarios sobre EAR?

Para enviar comentarios sobre la versión EAR, haga clic en https://forms.gle/ef3eFFKBk7gvTi1b6.

Cómo personalizar la barra de herramientas dentro de la sesión de la aplicación Citrix Workspace?

Los administradores pueden personalizar la barra de herramientas, eligiendo qué opciones son visibles para los usuarios finales. Los administradores pueden personalizarla utilizando el servicio de configuración global de aplicaciones. Para obtener más información, consulte Personalización de la barra de herramientas en la documentación del producto.

Cómo configurar conjuntos de cifrado para el VDA habilitado para SSL con la aplicación Citrix Workspace para HTML5?

Para configurar los conjuntos de cifrado, consulte el artículo conjunto de cifrado dentro de la documentación de la aplicación Citrix Workspace para HTML5.