Citrix DaaS™

Supervisa, soluciona problemas y obtén asistencia para Microsoft Teams

Supervisar Teams

Esta sección te proporciona directrices para supervisar 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.

Supervisar Teams en el Administrador de actividad

Con la versión mínima 1912 del VDA, puedes supervisar las llamadas activas de Teams usando 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 Supervisión en el artículo de Knowledge Center CTX253754.

Solucionar problemas

Esta sección te proporciona consejos para solucionar problemas que podrías 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

  • Citrix HDX Teams Redirection Service establece el canal virtual usado en Microsoft Teams. El servicio depende de CtxSvcHost.exe.

  • Citrix HDX HTML5 Video Redirection Service se ejecuta como WebSocketService.exe escuchando en 127.0.0.1:9002 TCP. WebSocketService.exe realiza dos funciones principales:

    1. 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” en Comunicación entre el Controller y el VDA.

    Algunos programas antivirus y de seguridad de escritorio interfieren con el funcionamiento adecuado de WebSocketService.exe y sus certificados. Aunque el servicio Citrix HDX HTML5 Video Redirection podría estar ejecutándose en la consola services.msc, el socket TCP local 127.0.0.1:9002 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

    1. 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 verificar 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:

    Ejemplo de ejecución de netstat

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

    Ejemplo de netstat exitoso

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 podrían 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. 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, verifica lo siguiente:

  1. Asegúrate de haber instalado como mínimo la versión 1905 de la aplicación Workspace para Windows. ¿Ves los binarios HdxTeams.exe y webrpc.dll en la ruta de instalación de la aplicación Workspace?
  2. Si validaste el paso 1, haz lo siguiente para verificar si HdxTeams.exe se está iniciando.
    1. Sal de Microsoft Teams en el VDA.
    2. Inicia services.msc en el VDA.
    3. Detén el servicio Citrix HDX Teams Redirection Service.
    4. Desconecta la sesión ICA®.
    5. Conecta la sesión ICA.
    6. Inicia el servicio Citrix HDX Teams Redirection Service.
    1. Reinicia el servicio Citrix HDX HTML5 Video Redirection Service.
    1. Inicia Microsoft Teams en el VDA.
    1. Si aún no ves que HdxTeams.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 respaldan conjuntamente la entrega de Microsoft Teams desde Citrix Virtual Apps and Desktops™ utilizando la optimización para Microsoft Teams. Este respaldo conjunto es el resultado de una estrecha colaboración entre ambas empresas. Si tienes contratos de asistencia válidos y experimentas un problema con esta solución, abre un ticket de asistencia 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 reciben el tíquet, clasifican el problema y lo escalan según sea necesario. 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 con mayor rapidez.

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_Día_Mes_marca_de_tiempo_Año.txt. Si utilizas 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 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 del cierre 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 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. 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 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 Citrix Workspace app 2012 o posterior)
Supervisa, soluciona problemas y obtén asistencia para Microsoft Teams