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 escritorio virtual y aplicaciones en curso.

Como usuario final, puedes 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ías recopilar registros para 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 selecciones Detener registro.

Registro en dispositivos de usuario

Para habilitar el registro:

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

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

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

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

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

Registros del cliente

Para recopilar registros del cliente:

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

   Cierra el cuadro de diálogo Cuenta.

• 1. Inicia sesión en el escritorio virtual de la aplicación Citrix Workspace, inicia tu sesión de aplicación virtual y reproduce el problema para recopilar registros.

  

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

1. Una vez que se reproduce el problema, cierra la sesión.

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

3. Selecciona la ficha Registro.

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

   

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

   

6. Haz clic en la flecha para descargar y guardar algunos archivos de registro.

7. Haz clic en Descargar todos los registros y compártelos con el administrador o el ingeniero de asistencia de Citrix®.

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

Estos son los beneficios 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 de Registro, haz 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 una fácil identificación.

Registros de la consola

Para recopilar registros de la consola:

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

1. En la ficha Aplicaciones, haz clic en inspeccionar para todas las ventanas relacionadas con Citrix Workspace: SessionWindow.html, Main.html (y sus nodos secundarios).

   

   

2. Para cada ventana de herramientas de desarrollador abierta, haz clic en Consola. Luego, guarda 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. Sigue los pasos de Uso de Web.config para ChromeOS y habilita moreLogs para USB de la siguiente manera:

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

1. Luego, abre una nueva ficha en el navegador Google Chrome e introduce chrome://device-log y comparte los registros.

   

Registros de transferencia de archivos

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

Para recuperar registros de transferencia de archivos del cliente:

1. Inicia un navegador.
2. Ve 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, consulta HTML5 y Chrome File Transfer Explained.

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 shim actual que usas:

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

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

3. Abre el Teclado en pantalla dentro de la sesión y haz clic en las teclas Ctrl + Alt + Mayús + 1. Ahora puedes ver los archivos de registro en la carpeta de descargas.

4. Abre el archivo MSTeams Diagnostics Log <date><time>_vdi partner.txt y busca la versión shim en type_script. Compara la versión shim con la 1.8.0.12.

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

• Registros del cliente en modo quiosco

Para recopilar los registros en modo quiosco:

1. Conecta un dispositivo USB extraíble a tu Chromebook.

2. Descarga el archivo de registro.

3. Guarda 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 + Mayús +1 no funcione en Microsoft Teams optimizado dentro de un escritorio virtual. Como solución alternativa, abre el Teclado en pantalla y usa el atajo. [RFHTMCRM-5441]

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 ChromeOS 2411 y versiones posteriores
• Versión de VDA 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 eficazmente y reducir significativamente el número de casos de soporte relacionados con los errores de sesión.

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

Rastreo siempre activo (AOT)

Citrix Workspace app para ChromeOS 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 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
• 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 adapta a tu experiencia general en los siguientes escenarios:

• Supervisión proactiva: Supervisa 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: Accede a datos de registro completos inmediatamente cuando surjan problemas, sin esperar a la reproducción del registro
• Soporte de autoservicio: Permite 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 Rastreo siempre activo (AOT) de varios componentes de Citrix®. Está en contenedores mediante la 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 2511 de Citrix Workspace app para ChromeOS, 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 son compatibles tanto con configuraciones locales sin puerta de enlace como con configuraciones locales con puerta de enlace en la ruta.

Configuración

A partir de Citrix Workspace app para ChromeOS 2603, puedes 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 administración de Google de la siguiente manera:

1. Inicia sesión en la Política de administración de Google.

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

   Nota:

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

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

3. Agrega las siguientes cadenas al archivo policy.txt en la clave engine_settings.

   Asegúrate de establecer "enabled": false en el objeto aot. A continuación, se muestra 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 cuando abres una sesión usando:

• 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 debes instalar y configurar el servidor de registros. Para obtener pasos detallados de instalación y configuración, consulta 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, debes 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, detenlo usando el siguiente comando:

   docker stop logserver
   <!--NeedCopy-->

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

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

1. Reinicia el servidor de registros usando 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 configuración de credenciales de Azure AD

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

Para recopilar registros:

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

2. Recopila los seguimientos de red para el estado de obtención del token MSAL:

   i. Abre el navegador Chrome y navega a chrome://net-export/. ii. Selecciona Iniciar registro en disco y la opción Incluir bytes sin procesar (incluirá cookies y credenciales) como se muestra en la siguiente captura de pantalla. Selecciona la ubicación del archivo.

   

   iii. Inicia una sesión de la aplicación Citrix Workspace para ChromeOS para reproducir el problema y recopilar los seguimientos. Selecciona Detener registro en chrome://net-export/.

3. Recopila los seguimientos de Citrix Diagnostic Facility (CDF) del VDA para todos los módulos y el seguimiento de inicio. Sigue los pasos para recopilar un seguimiento CDF al inicio del sistema porque el SSO puede fallar incluso con una negociación de capacidad exitosa 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 agregadas?

Puedes 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 conocer las funciones que están en vista previa técnica, consulta Funciones en vista previa técnica.

¿Cómo enviar comentarios sobre EAR?

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

¿Cómo instalar la aplicación Citrix Workspace para ChromeOS desde Chrome Web Store?

El usuario final puede instalar la aplicación Citrix Workspace para ChromeOS desde Chrome Web Store. Para obtener más información, consulta Instalar desde Chrome Web Store 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 usando el servicio de configuración global de aplicaciones. Para obtener más información, consulta 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, puedes crear una política de Google para identificar el PID/VID del dispositivo y habilitar su uso en la aplicación Citrix Workspace. Esta compatibilidad se extiende también a los nuevos dispositivos USB. Para configurar esta función, consulta Configuración USB en la documentación del producto.