Solución de problemas

¿Cómo recopilar registros?

La aplicación Citrix Workspace para ChromeOS proporciona marcas de tiempo para los registros generados por el dispositivo del usuario. La aplicación Citrix Workspace admite la recopilación de registros para sesiones de aplicaciones y escritorios virtuales en curso.

Como usuario final, puede recopilar registros para ayudar con la solución de problemas. Los registros se pueden generar tanto en el dispositivo del usuario como en las máquinas. Los registros pueden ser para escritorios y aplicaciones.

Anteriormente, solo podía recopilar 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 posteriores hasta que seleccione Detener registro.

Registro en dispositivos de usuario

Para habilitar el registro:

1. En el dispositivo del usuario, inicie la aplicación Citrix Workspace y vaya a la página de inicio de sesión.

2. Haga clic en el icono de configuración (engranaje) en la esquina inferior derecha.

3. En el cuadro de diálogo Configuración, seleccione Registro > Iniciar registro.

   Los detalles de los archivos de registro recopilados se enumeran en el cuadro de diálogo Configuración.

4. Seleccione Detener registro para finalizar la recopilación de registros en el dispositivo del usuario.

Registros de cliente

Para recopilar registros de cliente:

1. Haga clic en el icono de Configuración (engranaje) en la parte inferior derecha de la pantalla de Inicio de sesión de la aplicación Citrix Workspace.

   

2. Haga clic en Registro > Iniciar registro para habilitar la recopilación de registros.

   

3. El campo Iniciar registro cambia a Detener registro. Este cambio indica que la recopilación de registros está habilitada.

   Cierre el cuadro de diálogo Cuenta.

4. Inicie sesión en el escritorio virtual de la aplicación Citrix Workspace y abra la sesión de la aplicación virtual y reproduzca el problema para recopilar registros.

   

   Continúe trabajando en la sesión para reproducir el problema.

5. Una vez que se reproduce el problema, cierre la sesión.

6. Haga clic en Configuración de nuevo para abrir el cuadro de diálogo Cuenta.

7. Seleccione la ficha Registro.

8. El cuadro de diálogo Registro muestra la lista de Archivos de registro capturados.

   

9. Mueva el ratón sobre cualquiera de los archivos de registro. Aparece una pequeña flecha a la derecha.

   

10. Haga clic en la flecha para descargar y guardar algunos archivos de registro.

11. Haga clic en Descargar todos los registros y compártalos con el administrador o el ingeniero de soporte de Citrix®.

12. Haga clic en Detener registro.

Nota:

En el modo Quiosco, los archivos se pueden guardar en un dispositivo USB extraíble.

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 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.

Experiencia del usuario final

En la pantalla 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_CHROME_LOGS_[timestamp].zip, lo que garantiza claridad y fácil identificación.

Registros de la consola

Para recopilar registros de consola:

1. Abra la página chrome://inspect/#apps en el navegador Google Chrome de su aplicación Citrix Workspace.

2. En la pestaña Aplicaciones, haga clic en inspeccionar para todas las ventanas relacionadas con Citrix Workspace: SessionWindow.html, Main.html (y sus nodos secundarios).

   

   

3. Para cada ventana de herramientas de desarrollador abierta, haga clic en Consola. Luego, guarde el registro completo haciendo clic con el botón derecho y seleccionando la opción Guardar como.

   

Registros de redirección USB

Para recopilar registros de redirección USB:

1. Siga los pasos de Uso de Web.config para ChromeOS y habilite moreLogs para USB mediante:

   Agregar el valor de configuración moreLogs a chromeAppPreferences en el archivo web.config de StoreFront: chromeAppPreferences ='{"moreLogs":{"usb":true}}'

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

   

Registros de transferencia de archivos

Los registros de transferencia de archivos se pueden recuperar tanto del cliente como del servidor.

Para recuperar los registros de transferencia de archivos del cliente:

1. Inicie un navegador.
2. Vaya a la siguiente URL para iniciar el registro: <storefronturl>/clients/html5client/src/viewlog.html donde <storefronturl> es el FQDN o la dirección IP del servidor StoreFront donde está configurada la tienda.

Para obtener más información sobre la transferencia de archivos, consulte Transferencia de archivos de HTML5 y Chrome explicada.

Registros de optimización de Microsoft Teams

La optimización de Microsoft Teams es compatible con la versión 1.8.0.12 de la biblioteca shim más reciente.

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

1. Inicie 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 + Shift + 1. Ahora puede ver los archivos de registro en la carpeta de descargas.

4. Abra el archivo MSTeams Diagnostics Log <date><time>_vdi partner.txt y busque la versión de shim en type_script. Compare la versión de shim con la 1.8.0.12.

5. (Opcional) Si la versión de shim no es la 1.8.0.12, póngase en contacto con su administrador para actualizar a la versión más reciente.

Registros del cliente en modo quiosco

Para recopilar los registros en modo quiosco:

1. Conecte un dispositivo USB extraíble a su Chromebook.

2. Descargue el archivo de registro.

3. Guarde el archivo de registro en el dispositivo USB conectado.

   El archivo de registro se transfiere al dispositivo USB.

Atajos

• Es posible que el atajo de teclado Ctrl+ Alt + Shift +1 no funcione en Microsoft Teams optimizado dentro de un escritorio virtual. Como solución alternativa, abra el Teclado en pantalla y use el atajo. [RFHTMCRM-5441]

Ver la telemetría del punto final en Citrix Director

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

Requisitos previos

• Citrix Workspace app para ChromeOS 2411 y versiones posteriores
• VDA versión 2411 y 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 fallos de sesión. Los administradores de la mesa de ayuda ahora cuentan con información completa sobre las rutas de fallo, lo que les permite clasificar eficazmente y reducir significativamente el número de casos de soporte relacionados con los fallos de sesión.

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

Rastreo siempre activo (AOT)

La aplicación Citrix Workspace para ChromeOS ahora es compatible con Always On Tracing (AOT), un moderno marco de diagnóstico 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, eliminando 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 datos de registro para sesiones de usuario y 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
• Habilitar 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
• Solución de problemas rápida: Acceda a datos de registro completos inmediatamente cuando ocurran problemas, sin esperar a la reproducción del registro
• Soporte de autoservicio: Permita a los administradores de TI diagnosticar y resolver 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á contenedorizado utilizando tecnología Docker y se implementa preferentemente en Linux, aunque también es compatible con entornos Windows a través de Docker Desktop.

Notas:

• En esta versión de Citrix Workspace app para ChromeOS 2511, los registros AOT solo se capturan para configuraciones locales sin puerta de enlace en la ruta.
• En Citrix Workspace app para ChromeOS 2603, las cargas de registros AOT a servidores de registros centralizados admiten tanto configuraciones locales sin puerta de enlace como configuraciones locales con puerta de enlace en la ruta.

Configuración

A partir de Citrix Workspace app para ChromeOS 2603, puede deshabilitar la función AOT agregando la siguiente configuración. Para dispositivos y usuarios administrados, los administradores pueden deshabilitar AOT mediante la política de Google Admin de la siguiente manera:

1. Inicie sesión en la política de Google Admin.

2. Vaya a Administración de dispositivos > Administración de Chrome > Configuración de usuario.

   Nota:

   También puede aplicar esta configuración a lo siguiente:

   • Dispositivo > Chrome > Aplicaciones y extensiones > Usuarios y navegadores > Busque la extensión > Política para extensiones.
   • Dispositivo > Chrome > Aplicaciones y extensiones > Kioscos > Busque la extensión > Política para extensiones.
   • Dispositivo > Chrome > Aplicaciones y extensiones > Sesiones de invitado administradas > Busque la extensión > Política para extensiones.

3. Agregue las siguientes cadenas al archivo policy.txt bajo la clave engine_settings.

   Asegúrese de establecer "enabled": false en el objeto aot. El siguiente es un ejemplo de datos JSON:

   {
   "settings": {
   "Value": {
   "settings_version": "1.0",
   "engine_settings": {
       "aot": {
           "enabled": false
               }
           }
       }
       }
   }
   <!--NeedCopy-->
   

Requisitos previos

Esta función solo está disponible al abrir una sesión mediante:

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

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

Cómo configurar

Para configurar, primero debe instalar y configurar el servidor de registros. Para obtener 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 ChromeOS 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 el comando StartLogServer.bat (o StartLogServer.sh en Linux).

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 recuperación de tokens de MSAL:

   i. Abra el navegador Chrome y vaya a chrome://net-export/. ii. Seleccione Start Logging to Disk y la opción Include raw bytes (will include cookies and credentials), como se muestra en la siguiente captura de pantalla. Seleccione la ubicación del archivo.

   

   iii. Inicie una sesión de la aplicación Citrix Workspace para ChromeOS para reproducir el problema y recopilar los seguimientos. Seleccione Stop logging en chrome://net-export/.

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 inicio del sistema porque el SSO puede fallar incluso con una negociación de capacidades correcta desde la aplicación Citrix Workspace.

Limitaciones conocidas

• La aplicación Citrix Workspace para ChromeOS no admite el SSO para el inicio híbrido porque carece de compatibilidad con ICA en memoria.

• Si el inicio de la sesión tarda más de 30 segundos, el inicio de sesión SSO de AAD podría fallar y solicitar credenciales a los usuarios.

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 ChromeOS en la documentación del producto.

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

Para obtener información sobre las funciones que se encuentran 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 instalar la aplicación Citrix Workspace para ChromeOS desde Chrome Webstore?

El usuario final puede instalar la aplicación Citrix Workspace para ChromeOS desde Chrome Web Store. Para obtener más información, consulte Instalar desde Chrome Webstore en la documentación del producto.

¿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 mediante el servicio Global App Configuration. Para obtener más información, consulte Personalización de la barra de herramientas en la documentación del producto.

¿Cómo configurar la redirección USB?

La aplicación Citrix Workspace para ChromeOS admite una amplia gama de periféricos USB. Con esta funcionalidad adicional, puede crear una política de Google para identificar el PID/VID del dispositivo y habilitar su uso en la aplicación Citrix Workspace. Este soporte se extiende también a los nuevos dispositivos USB. Para configurar esta función, consulte Configuración de USB en la documentación del producto.