Supervisar, solucionar problemas y dar soporte a Microsoft Teams

Supervisar Teams

Esta sección proporciona directrices para supervisar la optimización de Microsoft Teams con HDX. Si se ejecuta en modo optimizado y HdxRtcEngine.exe se ejecuta en la máquina cliente, un proceso en el VDA llamado WebSocketAgent.exe se ejecuta en la sesión. Utilice el Administrador de actividades en Director para ver la aplicación.

El estado de optimización de Microsoft Teams se puede ver en Director > página Detalles del usuario > panel Detalles de la sesión > campo Optimización de MS Teams. La optimización de Microsoft Teams es fundamental para una mejor experiencia de usuario, como un 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, consulte Estado de optimización de Microsoft Teams.

Con la versión mínima 1912 del VDA, puede supervisar 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 la última versión de hdxmonitor.msi en la carpeta layout\image-full\Support\HDX Monitor. Con la versión mínima 1912 del VDA, puede supervisar 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 la última versión de hdxmonitor.msi en la carpeta layout\image-full\Support\HDX Monitor.

Para obtener más información, consulte Supervisión en el artículo del Centro de conocimientos CTX253754.

Solucionar problemas

Esta sección proporciona consejos para solucionar problemas que puede encontrar al usar la optimización para Microsoft Teams. Para obtener más información, consulte 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.

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

• 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. Puede rastrearlo con el Monitor de procesos. Para obtener más información sobre los certificados, consulte la sección TLS and HTML5 video redirection, and browser content redirection.

  Algunos programas antivirus y 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 pueda estar ejecutándose en la consola services.msc, el socket TCP de localhost 127.0.0.1:9002 nunca está en modo de escucha, como se ve en netstat. Intentar reiniciar el servicio hace que se bloquee (“Deteniendo…”). Asegúrese de aplicar las exclusiones adecuadas para el proceso WebSocketService.exe.

  

  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.

  

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

  Ejecute netstat -anob -p tcp desde una ventana del símbolo del sistema con privilegios elevados:

  

  Si la conexión se realiza correctamente, el estado cambia a ESTABLISHED:

  

Importante:

WebSocketService.exe escucha en dos sockets TCP, 127.0.0.1:9001 y 127.0.0.1:9002. El puerto 9001 se utiliza para la redirección de contenido del navegador y la redirección de vídeo HTML5. El puerto 9002 se utiliza para la redirección de Microsoft Teams. Asegúrese 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 se configura 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. Verifique que la opción Omitir el servidor proxy para direcciones locales esté marcada cuando utilice una configuración de proxy manual y explícita.

Ubicaciones y descripciones de los servicios

Aplicación Citrix Workspace

En el endpoint 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 ve este servicio, compruebe lo siguiente:

1. Asegúrese de haber instalado como mínimo la versión 1905 de la aplicación Workspace para Windows. ¿Ve los binarios HdxTeams.exe o HdxRtcEngine.exe y webrpc.dll en la ruta de instalación de la aplicación Workspace?
2. Si ha validado el paso 1, haga lo siguiente para comprobar si se está iniciando HdxTeams.exe o HdxRtcEngine.exe.
   1. Cierre Microsoft Teams en el VDA.
   2. Inicie services.msc en el VDA.
   3. Detenga el servicio de redirección de Citrix HDX Teams.
   4. Desconecte la sesión ICA®.
   5. Conecte la sesión ICA.
   6. Inicie el servicio de redirección de Citrix HDX Teams.
   7. Reinicie el servicio de redirección de vídeo HTML5 de Citrix HDX.
   8. Inicie Microsoft Teams en el VDA.
3. Si aún no ve HdxTeams.exe o HdxRtcEngine.exe iniciándose en el endpoint del cliente, haga lo siguiente:
   1. Reinicie el VDA.
   2. Reinicie el punto final del cliente.

Soporte

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 tiene contratos de soporte válidos y experimenta un problema con esta solución, abra un ticket de soporte con el proveedor cuyo código sospeche 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 se ponga en contacto con el equipo de soporte de cada empresa.

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

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úrese de adjuntar los registros a su caso de soporte.

Registros de Windows:

Puede encontrar los registros de Windows en %TEMP% dentro de la carpeta HDXTeams (AppData/Local/Temp/HDXTeams o AppData/Local/Temp/HdxRtcEngine). Busque un archivo .txt llamado webrpc_Día_Mes_marca_de_tiempo_Año.txt. Si utiliza versiones más recientes de la aplicación Citrix Workspace, por ejemplo, Citrix Workspace app 2009.5 o posterior, guarde los registros en AppData\Local\Temp\HdxRtcEngine.

Cada sesión crea una carpeta independiente 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 de la finalización de la biblioteca webrtc.

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

Registros de Linux:

Puede encontrar los registros de Linux en las carpetas /tmp/webrpc/<current date>/ and /tmp/hdxrtcengine/<current date>/. Registro de Webrtc: /tmp/webrpc/<current date>/webrtc.log Registro del kernel: /var/log/syslog

Registros de 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. Consulte 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. anfitrión
2. reflexivo de par
3. reflexivo del servidor
4. reenvío de transporte

Si encuentra un problema y puede reproducirlo de forma consistente, le recomendamos que haga clic en Ayuda > Informar de un problema en Microsoft Teams. Los registros se comparten entre Citrix y Microsoft para resolver problemas técnicos si ha abierto un caso con Microsoft. También es beneficioso capturar seguimientos CDF antes de ponerse en contacto con el Soporte de Citrix. Para obtener más información, consulte el artículo del Centro de conocimientos CDFcontrol.

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

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

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

• IcaClient_DriversVd_TeamsRedir (opcional)
• IcaClient_Multimedia_HdxTeams (requiere Citrix Workspace app 2012 o posterior)