Citrix Virtual Apps and Desktops

Monitorizar, solucionar problemas y dar asistencia a Microsoft Teams

Monitorizar Teams

Esta sección proporciona directrices para monitorizar la optimización de Microsoft Teams con HDX. Si ejecutas en modo optimizado y HdxRtcEngine.exe se está ejecutando en la máquina cliente, un proceso en el VDA llamado WebSocketAgent.exe se está ejecutando en la sesión. Usa el Administrador de actividad en Director para ver la aplicación.

Monitorizar Teams en el Administrador de actividad

El estado de optimización de Microsoft Teams se puede ver en Director > página Detalles de usuario > panel Detalles de sesión > campo Optimización de MS Teams. La optimización de Microsoft Teams es fundamental para una mejor experiencia de usuario, como audio y vídeo claros. Esta función está disponible para la versión 2311 del VDA y posteriores. Las versiones de la aplicación Citrix Workspace™ compatibles se enumeran en Optimización para Microsoft Teams. Director muestra el estado de la optimización de Microsoft Teams solo si Microsoft Teams se ejecuta como una aplicación publicada o dentro de un escritorio publicado. Para obtener más información, consulta Estado de optimización de Microsoft Teams.

Con la versión mínima 1912 del VDA, puedes monitorizar las llamadas activas de Teams mediante Citrix HDX Monitor (versión mínima 3.11). El ISO del producto Citrix Virtual Apps and Desktops contiene el hdxmonitor.msi más reciente en la carpeta layout\image-full\Support\HDX Monitor. Con la versión mínima 1912 del VDA, puedes monitorizar las llamadas activas de Microsoft Teams mediante Citrix HDX Monitor (versión mínima 3.11). El ISO del producto Citrix Virtual Apps and Desktops contiene el hdxmonitor.msi más reciente en la carpeta layout\image-full\Support\HDX Monitor.

Para obtener más información, consulta Monitorización en el artículo de Knowledge Center CTX253754.

Solucionar problemas

Esta sección proporciona consejos para solucionar problemas que puedes encontrar al usar la optimización para Microsoft Teams. Para obtener más información, consulta CTX253754.

En el Virtual Delivery Agent

Hay cuatro servicios instalados por BCR_x64.msi. Solo dos son responsables de la redirección de Microsoft Teams en el VDA.

Cuatro servicios instalados por la redirección de contenido del navegador

  • El Servicio de redirección de Citrix HDX Teams establece el canal virtual usado en Microsoft Teams. El servicio se basa en CtxSvcHost.exe.

  • El Servicio de redirección de vídeo HTML5 de Citrix HDX se ejecuta como WebSocketService.exe escuchando en 127.0.0.1:9002 TCP. WebSocketService.exe realiza dos funciones principales:

    i. La terminación TLS para WebSockets seguros recibe una conexión WebSocket segura de vdiCitrixPeerConnection.js, que es un componente dentro de la aplicación Microsoft Teams. Puedes rastrearlo con el Monitor de procesos. Para obtener más información sobre los certificados, consulta la sección Redirección de vídeo TLS y HTML5, y redirección de contenido del navegador.

    Algunos antivirus y software de seguridad de escritorio interfieren con el correcto funcionamiento de WebSocketService.exe y sus certificados. Aunque el servicio de redirección de vídeo HTML5 de Citrix HDX podría estar ejecutándose en la consola services.msc, el socket TCP 127.0.0.1:9002 del localhost nunca está en modo de escucha, como se ve en netstat. Intentar reiniciar el servicio hace que se cuelgue (“Deteniendo…”). Asegúrate de aplicar las exclusiones adecuadas para el proceso WebSocketService.exe.

    Monitor de procesos

    ii. Asignación de sesión de usuario. Cuando se inicia la aplicación Microsoft Teams, WebSocketService.exe inicia el proceso WebSocketAgent.exe en la sesión del usuario en el VDA. WebSocketService.exe se ejecuta en la Sesión 0 como una cuenta de LocalSystem.

    Servicio WebSocketAgent.exe

    Puedes usar netstat para comprobar si el servicio WebSocketService.exe está en un estado de escucha activa en el VDA.

    Ejecuta netstat -anob -p tcp desde una ventana de símbolo del sistema elevada:

    Ejecutar el ejemplo de netstat

    En una conexión correcta, el estado cambia a ESTABLISHED:

    Ejemplo de netstat correcto

Importante:

WebSocketService.exe escucha en dos sockets TCP, 127.0.0.1:9001 y 127.0.0.1:9002. El puerto 9001 se usa para la redirección de contenido del navegador y la redirección de vídeo HTML5. El puerto 9002 se usa para la redirección de Microsoft Teams. Asegúrate de no tener ninguna configuración de proxy en el sistema operativo Windows del VDA que pueda impedir una comunicación directa entre Teams.exe y WebSocketService.exe. A veces, cuando configuras un proxy explícito en Internet Explorer 11 (Opciones de Internet > Conexiones > Configuración de LAN > Servidor proxy), las conexiones pueden fluir a través de un servidor proxy asignado. Verifica que la opción Omitir el servidor proxy para direcciones locales esté marcada cuando uses una configuración de proxy manual y explícita.

Ubicaciones y descripciones de los servicios

Servicio Ruta al ejecutable en el SO Windows Server Iniciar sesión como Descripción
Citrix HTML5 Video Redirection Service “C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service Cuenta de sistema local Proporciona múltiples servicios multimedia HDX con el marco inicial necesario para realizar la redirección de medios entre el escritorio virtual y el dispositivo de punto final.
Citrix HDX Browser Redirection Service “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs Esta cuenta (servicio local) Proporciona la redirección de contenido del navegador entre el dispositivo de punto final y el escritorio virtual.
Citrix Port Forwarding Service “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs Esta cuenta (servicio local) Proporciona el reenvío de puertos entre el dispositivo de punto final y el escritorio virtual para la redirección de contenido del navegador.
Citrix HDX Teams Redirection Service “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs Cuenta de sistema local Proporciona la redirección de Microsoft Teams entre el dispositivo de punto final y el escritorio virtual.

Aplicación Citrix Workspace

En el punto final del usuario, la aplicación Citrix Workspace para Windows instancia un nuevo servicio llamado HdxTeams.exe o HdxRtcEngine.exe. Lo hace cuando Microsoft Teams se inicia en el VDA y el usuario intenta llamar o acceder a los periféricos en la vista previa automática. Si no ves este servicio, comprueba lo siguiente:

  1. Asegúrate de haber instalado como mínimo la versión 1905 de la aplicación Workspace para Windows. ¿Ves HdxTeams.exe o HdxRtcEngine.exe y los binarios webrpc.dll en la ruta de instalación de la aplicación Workspace?
  2. Si validaste el paso 1, haz lo siguiente para comprobar si HdxTeams.exe o HdxRtcEngine.exe se está iniciando.
    1. Sal de Microsoft Teams en el VDA.
    2. Inicia services.msc en el VDA.
    3. Detén el Servicio de redirección de Citrix HDX Teams.
    4. Desconecta la sesión ICA®.
    5. Conecta la sesión ICA.
    6. Inicia el Servicio de redirección de Citrix HDX Teams.
    7. Reinicia el Servicio de redirección de vídeo HTML5 de Citrix HDX.
    8. Inicia Microsoft Teams en el VDA.
  3. Si aún no ves que HdxTeams.exe o HdxRtcEngine.exe se inicie en el punto final del cliente, haz lo siguiente:
    1. Reinicia el VDA.
    2. Reinicia el punto final del cliente.

Asistencia

Citrix y Microsoft ofrecen soporte conjunto para la entrega de Microsoft Teams desde Citrix Virtual Apps and Desktops™ mediante la optimización para Microsoft Teams. Este soporte conjunto es el resultado de una estrecha colaboración entre ambas empresas. Si tienes contratos de soporte válidos y experimentas un problema con esta solución, abre un ticket de soporte con el proveedor cuyo código sospeches que está causando el problema. Es decir, Microsoft para Teams o Citrix para los componentes de optimización. Citrix o Microsoft recibe el ticket, clasifica el problema y lo escala según corresponda. No es necesario que te pongas en contacto con el equipo de soporte de cada empresa.

Cuando tengas un problema, te recomendamos que hagas clic en Ayuda > Notificar un problema en la interfaz de usuario de Teams. Los registros del lado de VDA se comparten automáticamente entre Citrix y Microsoft para resolver los problemas técnicos más rápido.

Recopilación de registros

Los registros del motor multimedia HDX se encuentran en la máquina del usuario (no en el VDA). En caso de cualquier problema, asegúrate de adjuntar los registros a tu caso de soporte.

Registros de Windows:

Puedes encontrar los registros de Windows en %TEMP% dentro de la carpeta HDXTeams (AppData/Local/Temp/HDXTeams o AppData/Local/Temp/HdxRtcEngine). Busca un archivo .txt llamado webrpc_Day_Month_timestamp_Year.txt. Si usas versiones más recientes de la aplicación Citrix Workspace, por ejemplo, Citrix Workspace app 2009.5 o posterior, guarda los registros en AppData\Local\Temp\HdxRtcEngine.

Cada sesión crea una carpeta separada para los registros.

Registros de Mac:

  1. Registro VDWEBRTC: registra la ejecución del canal virtual.

    Ubicación:/Users/<User Name>/Library/Logs/Citrix Workspace/CitrixViewer_<Y_M_D_H_M_S>.txt

  2. Registro HdxRtcEngine: registra la ejecución de los procesos en HdxRtcEngine.

    Ubicación: $TMPDIR/hdxrtcengine/<W_M_D_H_M_S_Y>/hdxrtcengine.log

    El registro HdxRtcEngine está habilitado de forma predeterminada.

  3. Registros Webrpc: son los registros más importantes que registran la ejecución del resumen de la biblioteca webrtc.

    Ubicación: /Users/<USERNAME>/Library/Logs/HdxRtcEngine/<W_M_D_H_M_S_Y>/webrpc.log

Registros de Linux:

Puedes encontrar los registros de Linux en las carpetas /tmp/webrpc/<current date>/ y /tmp/hdxrtcengine/<current date>/. Registro Webrtc: /tmp/webrpc/<current date>/webrtc.log

  • Registro del kernel: /var/log/syslog

Registros ICE/STUN/TURN:

Al establecer una llamada, se requieren estas cuatro fases de ICE:

  • Recopilación de candidatos
  • Intercambio de candidatos
  • Comprobaciones de conectividad (solicitudes de enlace STUN)
  • Promoción de candidatos

En los registros de HdxRtcEngine.exe, las siguientes entradas son las entradas relevantes de Interactive Connectivity Establishment (ICE). Estas entradas deben estar presentes para que la configuración de una llamada se realice correctamente. Consulta el siguiente fragmento de ejemplo para la fase de recopilación:

RPCStubs Info: -> device id = \\?\display#int3470#4&1835d135&0&uid13424#{65e8773d-8f56-11d0-a3b9-00a0c9223196}\{bf89b5a5-61f7-4127-a279-e187013d7caf} label = Microsoft Camera Front groupId =

webrtcapi.RTCPeerConnection Info: createOffer. audio = 1 video = 1
webrtcapi.RTCPeerConnection Info: setLocalDescription.
>>> begin:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnSignalingChange. signaling state = HaveLocalOffer

webrtcapi.RTCPeerConnection Info: OnIceGatheringChange. state = Gathering

[…]
>>> begin:sdp
candidate:840548147 1 udp 2122194687 10.108.124.215 56927 typ host generation 0 ufrag oVk6 network-id 1
<<< end:sdp
[…]
>>> begin:sdp
candidate:1938109490 1 udp 24911871 52.114.xxx.xxx 52786 typ relay raddr 73.205.xxx.x rport 25651 generation 0 ufrag dDML network-id 1 network-cost 10
<<< end:sdp
[…]
>>> begin:sdp
candidate:4271145120 1 udp 1685987071 66.xxx.xxx.xxx 55839 typ srflx raddr 10.108.124.215 rport 55839 generation 0 ufrag uAVH network-id 1
<<< end:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnIceGatheringChange. state = Complete webrtcapi.RTCPeerConnection Info: setRemoteDescription.
>>> begin:sdp
[…]

webrtcapi.RTCPeerConnection Info: OnSignalingChange. signaling state = HaveRemotelOffer

<!--NeedCopy-->

Si hay varios candidatos ICE, el orden de preferencia es:

  1. host
  2. reflexivo de par
  3. reflexivo de servidor
  4. reenvío de transporte

Si encuentras un problema y puedes reproducirlo de forma consistente, te recomendamos que hagas clic en Ayuda > Notificar un problema en Microsoft Teams. Los registros se comparten entre Citrix y Microsoft para resolver problemas técnicos si abriste un caso con Microsoft. Capturar seguimientos CDF antes de contactar con el soporte de Citrix también es beneficioso. Para obtener más información, consulta el artículo del Centro de conocimiento CDFcontrol.

Para obtener recomendaciones sobre la recopilación de seguimientos CDF, consulta el artículo del Centro de conocimiento Recomendaciones para recopilar los seguimientos CDF.

Seguimientos CDF del lado de VDA: habilita los siguientes proveedores de seguimiento CDF:

Seguimientos CDF del lado de VDA

Seguimientos CDF del lado de la aplicación Workspace: habilita los siguientes proveedores de seguimiento CDF:

Seguimientos CDF del lado de la aplicación Workspace

  • IcaClient_DriversVd_TeamsRedir (opcional)
  • IcaClient_Multimedia_HdxTeams (requiere la aplicación Citrix Workspace 2012 o posterior)
Monitorizar, solucionar problemas y dar asistencia a Microsoft Teams