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 está ejecutando en la máquina cliente, un proceso en el VDA llamado WebSocketAgent.exe se está ejecutando 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 la página Director > 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 y posteriores de VDA. 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 de 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 hdxmonitor.msi en la carpeta layout\image-full\Support\HDX Monitor.
Con la versión mínima 1912 de 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 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 pueden surgir al usar la optimización para Microsoft Teams. Para obtener más información, consulte CTX253754.
En el Virtual Delivery Agent
BCR_x64.msi instala cuatro servicios. Solo dos son responsables de la redirección de Microsoft Teams en el VDA.
-
Servicio de redirección de Teams de Citrix HDX establece el canal virtual utilizado en Microsoft Teams. El servicio se basa en 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 “Redirección de vídeo TLS y HTML5, y redirección de contenido del explorador” en Comunicación entre Controller y VDA.
Algunos programas antivirus y de seguridad de escritorio interfieren con el correcto funcionamiento de
WebSocketService.exey sus certificados. Aunque el servicio de redirección de vídeo HTML5 de Citrix HDX podría estar ejecutándose en la consolaservices.msc, el socket TCP127.0.0.1:9002de localhost 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 procesoWebSocketService.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 LocalSystem.
Puede usar
netstatpara comprobar si el servicio WebSocketService.exe está en un estado de escucha activa en el VDA.Ejecute
netstat -anob -p tcpdesde una ventana del símbolo del sistema con privilegios elevados:
En una conexión correcta, 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
| Servicio | Ruta al ejecutable en el SO Windows Server | Iniciar sesión como | Descripción |
|---|---|---|---|
| Servicio de redirección de vídeo HTML5 de Citrix | “C:\Archivos de programa (x86)\Citrix\System32\WebSocketService.exe” /service | Cuenta de sistema local | Proporciona varios 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. |
| Servicio de redirección de explorador HDX de Citrix | “C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs | Esta cuenta (servicio local) | Proporciona la redirección del contenido del explorador entre el dispositivo de punto final y el escritorio virtual. |
| Servicio de reenvío de puertos de Citrix | “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 del contenido del explorador. |
| Servicio de redirección de Teams HDX de Citrix | “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 crea 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. Si no ve este servicio, compruebe lo siguiente:
- 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?
- Si ha validado el paso 1, haga lo siguiente para comprobar si HdxTeams.exe o HdxRtcEngine.exe se está iniciando.
- Salga de Microsoft Teams en el VDA.
- Inicie services.msc en el VDA.
- Detenga el servicio de redirección de Citrix HDX Teams.
- Desconecte la sesión de ICA®.
- Conecte la sesión de ICA.
- Inicie el servicio de redirección de Citrix HDX Teams.
- Reinicie el servicio de redirección de vídeo HTML5 de Citrix HDX.
- Inicie Microsoft Teams en el VDA.
- Si sigue sin ver que HdxTeams.exe o HdxRtcEngine.exe se inicie en el punto final del cliente, haga lo siguiente:
- Reinicie el VDA.
- Reinicie el punto final del cliente.
Soporte
Citrix y Microsoft admiten conjuntamente 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 > Informar de 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 de medios HDX se pueden encontrar 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_Day_Month_timestamp_Year.txt. Si utiliza versiones más recientes de la aplicación Citrix Workspace, por ejemplo, la aplicación Citrix Workspace 2009.5 o posterior, guarde los registros en AppData\Local\Temp\HdxRtcEngine.
Cada sesión crea una carpeta separada para los registros.
Registros de Mac:
-
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 -
Registro HdxRtcEngine: registra la ejecución de los procesos en HdxRtcEngine.
Ubicación:
$TMPDIR/hdxrtcengine/<W_M_D_H_M_S_Y>/hdxrtcengine.logEl registro HdxRtcEngine está habilitado de forma predeterminada.
-
Registros de Webrpc: son los registros más importantes que graban 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:
- anfitrión
- reflexivo de par
- reflexivo del servidor
- 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. Capturar seguimientos CDF antes de ponerse en contacto con el Soporte de Citrix también es beneficioso. 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 la aplicación Citrix Workspace 2012 o posterior)