Citrix Virtual Apps and Desktops

Surveiller, dépanner et prendre en charge Microsoft Teams

March 18, 2026

Contributeur:

Surveiller Teams

Cette section fournit des recommandations pour surveiller l’optimisation Microsoft Teams avec HDX. Si vous exécutez en mode optimisé et que HdxRtcEngine.exe s’exécute sur la machine cliente, un processus sur le VDA nommé WebSocketAgent.exe s’exécute dans la session. Utilisez le Gestionnaire d’activité dans Director pour voir l’application.

Surveiller Teams dans le Gestionnaire d’activité

L’état de l’optimisation Microsoft Teams peut être consulté dans Director > page Détails utilisateur > panneau Détails de session > champ Optimisation MS Teams. L’optimisation de Microsoft Teams est essentielle pour une meilleure expérience utilisateur, notamment une qualité audio et vidéo claire. Cette fonctionnalité est disponible pour les versions VDA 2311 et ultérieures. Les versions prises en charge de l’application Citrix Workspace™ sont listées dans Optimisation pour Microsoft Teams. Director affiche l’état de l’optimisation Microsoft Teams uniquement si Microsoft Teams s’exécute en tant qu’application publiée ou à l’intérieur d’un bureau publié. Pour plus d’informations, consultez État de l’optimisation Microsoft Teams.

Avec la version minimale VDA 1912, vous pouvez surveiller les appels Teams actifs à l’aide de Citrix HDX Monitor (version minimale 3.11). L’ISO produit Citrix Virtual Apps and Desktops contient le dernier hdxmonitor.msi dans le dossier layout\image-full\Support\HDX Monitor. Avec la version minimale VDA 1912, vous pouvez surveiller les appels Microsoft Teams actifs à l’aide de Citrix HDX Monitor (version minimale 3.11). L’ISO produit Citrix Virtual Apps and Desktops contient le dernier hdxmonitor.msi dans le dossier layout\image-full\Support\HDX Monitor.

Pour plus d’informations, consultez Monitoring dans l’article Knowledge Center CTX253754.

Dépannage

Cette section fournit des conseils de dépannage pour les problèmes que vous pouvez rencontrer lors de l’utilisation de l’optimisation pour Microsoft Teams. Pour plus d’informations, consultez CTX253754.

Sur le Virtual Delivery Agent

Quatre services sont installés par BCR_x64.msi. Seuls deux sont responsables de la redirection Microsoft Teams dans le VDA.

Quatre services installés par Browser Content Redirection

Citrix HDX Teams Redirection Service établit le canal virtuel utilisé dans Microsoft Teams. Le service s’appuie sur CtxSvcHost.exe.
Citrix HDX HTML5 Video Redirection Service s’exécute en tant que WebSocketService.exe, en écoute sur 127.0.0.1:9002 TCP. WebSocketService.exe remplit deux fonctions principales :

i. Terminaison TLS pour les WebSockets sécurisés reçoit une connexion WebSocket sécurisée depuis vdiCitrixPeerConnection.js, qui est un composant de l’application Microsoft Teams. Vous pouvez le suivre avec Process Monitor. Pour plus d’informations sur les certificats, consultez la section TLS and HTML5 video redirection, and browser content redirection.

Certains antivirus et logiciels de sécurité du poste de travail interfèrent avec le bon fonctionnement de WebSocketService.exe et de ses certificats. Même si le service Citrix HDX HTML5 Video Redirection est en cours d’exécution dans la console services.msc, le socket TCP localhost 127.0.0.1:9002 n’est jamais en mode écoute, comme observé avec netstat. Une tentative de redémarrage du service peut le bloquer (« Arrêt… »). Assurez-vous d’appliquer les exclusions appropriées pour le processus WebSocketService.exe.

ii. Mappage de session utilisateur. Lorsque l’application Microsoft Teams démarre, WebSocketService.exe lance le processus WebSocketAgent.exe dans la session utilisateur sur le VDA. WebSocketService.exe s’exécute en session 0 sous le compte LocalSystem.

Vous pouvez utiliser netstat pour vérifier si le service WebSocketService.exe est dans un état d’écoute actif sur le VDA.

Exécutez netstat -anob -p tcp depuis une fenêtre d’invite de commandes élevée :

En cas de connexion réussie, l’état passe à ESTABLISHED :

Important :

WebSocketService.exe écoute sur deux sockets TCP : 127.0.0.1:9001 et 127.0.0.1:9002. Le port 9001 est utilisé pour la redirection de contenu du navigateur et la redirection vidéo HTML5. Le port 9002 est utilisé pour la redirection Microsoft Teams. Assurez-vous qu’il n’existe pas de configuration proxy dans le système Windows du VDA qui pourrait empêcher une communication directe entre Teams.exe et WebSocketService.exe. Parfois, lorsque vous configurez un proxy explicite dans Internet Explorer 11 (Options Internet > Connexions > Paramètres réseau local > Serveur proxy), les connexions peuvent transiter via le proxy assigné. Vérifiez que Ne pas utiliser de serveur proxy pour les adresses locales est coché lorsque vous utilisez un paramètre proxy manuel et explicite.

Emplacement et description des services

Service	Chemin vers l’exécutable dans Windows Server OS	Ouverture de session en tant que	Description
Citrix HTML5 Video Redirection Service	“C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service	Compte Système local	Fournit plusieurs services multimédia HDX avec le framework initial requis pour effectuer la redirection multimédia entre le bureau virtuel et le terminal utilisateur.
Citrix HDX Browser Redirection Service	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs	Ce compte (service local)	Fournit la redirection de contenu du navigateur entre le terminal utilisateur et le bureau virtuel.
Citrix Port Forwarding Service	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs	Ce compte (service local)	Fournit le transfert de port entre le terminal utilisateur et le bureau virtuel pour la redirection de contenu du navigateur.
Citrix HDX Teams Redirection Service	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs	Compte Système local	Fournit la redirection Microsoft Teams entre le terminal utilisateur et le bureau virtuel.

Application Citrix Workspace

Sur le terminal de l’utilisateur, l’application Citrix Workspace pour Windows instancie un nouveau service nommé HdxTeams.exe ou HdxRtcEngine.exe. Cela se produit lorsque Microsoft Teams est lancé dans le VDA et que l’utilisateur tente de passer un appel ou d’accéder aux périphériques en aperçu personnel. Si vous ne voyez pas ce service, vérifiez les points suivants :

Assurez-vous d’avoir installé au minimum la version 1905 de Workspace App pour Windows. Voyez-vous les binaires HdxTeams.exe ou HdxRtcEngine.exe et webrpc.dll dans le chemin d’installation de Workspace App ?
Si vous avez validé l’étape 1, procédez comme suit pour vérifier si HdxTeams.exe ou HdxRtcEngine.exe est lancé.
1. Quittez Microsoft Teams sur le VDA.
2. Lancez services.msc sur le VDA.
3. Arrêtez le service Citrix HDX Teams Redirection Service.
4. Déconnectez la session ICA®.
5. Reconnectez la session ICA.
6. Démarrez le service Citrix HDX Teams Redirection Service.
7. Redémarrez le service Citrix HDX HTML5 Video Redirection Service.
8. Lancez Microsoft Teams sur le VDA.
Si vous ne voyez toujours pas HdxTeams.exe ou HdxRtcEngine.exe se lancer sur le terminal client, procédez comme suit :
1. Redémarrez le VDA.
2. Redémarrez le terminal client.

Support

Citrix et Microsoft assurent conjointement la prise en charge de la distribution de Microsoft Teams depuis Citrix Virtual Apps and Desktops™ à l’aide de l’optimisation pour Microsoft Teams. Ce support conjoint est le résultat d’une collaboration étroite entre les deux entreprises. Si vous disposez de contrats de support valides et rencontrez un problème avec cette solution, ouvrez un ticket de support auprès du fournisseur dont vous soupçonnez le code d’être à l’origine du problème : Microsoft pour Teams, ou Citrix pour les composants d’optimisation. Citrix ou Microsoft reçoit le ticket, effectue le triage du problème et l’escalade si nécessaire. Vous n’avez pas besoin de contacter les équipes de support des deux entreprises.

Lorsque vous rencontrez un problème, nous vous recommandons de cliquer sur Help > Report a Problem dans l’interface Teams. Les journaux côté VDA sont automatiquement partagés entre Citrix et Microsoft afin de résoudre plus rapidement les problèmes techniques.

Collecte des journaux

Les journaux du moteur multimédia HDX se trouvent sur la machine de l’utilisateur (et non sur le VDA). En cas de problème, assurez-vous de joindre les journaux à votre dossier de support.

Journaux Windows :

Vous pouvez trouver les journaux Windows dans %TEMP%, dans le dossier HDXTeams (AppData/Local/Temp/HDXTeams ou AppData/Local/Temp/HdxRtcEngine). Recherchez un fichier .txt nommé webrpc_Day_Month_timestamp_Year.txt. Si vous utilisez des versions plus récentes de l’application Citrix Workspace, par exemple Citrix Workspace app 2009.5 ou ultérieure, les journaux sont stockés dans AppData\Local\Temp\HdxRtcEngine.

Chaque session crée un dossier distinct pour les journaux.

Journaux Mac :

Journal VDWEBRTC - enregistre l’exécution du canal virtuel.

Emplacement :/Users/<User Name>/Library/Logs/Citrix Workspace/CitrixViewer_<Y_M_D_H_M_S>.txt
Journal HdxRtcEngine - enregistre l’exécution des processus dans HdxRtcEngine.

Emplacement : $TMPDIR/hdxrtcengine/<W_M_D_H_M_S_Y>/hdxrtcengine.log

Le journal HdxRtcEngine est activé par défaut.
Journaux Webrpc - ce sont les journaux les plus importants ; ils enregistrent l’exécution de l’enrobage de la bibliothèque webrtc.

Emplacement : /Users/<USERNAME>/Library/Logs/HdxRtcEngine/<W_M_D_H_M_S_Y>/webrpc.log

Journaux Linux :

Vous pouvez trouver les journaux Linux dans les dossiers /tmp/webrpc/<current date>/ and /tmp/hdxrtcengine/<current date>/. Journal Webrtc : /tmp/webrpc/<current date>/webrtc.log Journal noyau : /var/log/syslog

Journaux ICE/STUN/TURN :

Lors de l’établissement d’un appel, ces quatre phases ICE sont requises :

Collecte des candidats
Échange des candidats
Vérifications de connectivité (requêtes STUN bind)
Promotion des candidats

Dans les journaux HdxRtcEngine.exe, les entrées suivantes sont les entrées ICE (Interactive Connectivity Establishment) pertinentes. Ces entrées doivent être présentes pour qu’un établissement d’appel réussisse. Voir l’extrait d’exemple suivant pour l’étape de collecte :

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-->

S’il existe plusieurs candidats ICE, l’ordre de préférence est :

host
peer reflexive
server reflexive
transport relay

Si vous rencontrez un problème et pouvez le reproduire de manière cohérente, nous vous recommandons de cliquer sur Help > Report a problem dans Microsoft Teams. Les journaux sont partagés entre Citrix et Microsoft pour résoudre les problèmes techniques si vous avez ouvert un dossier auprès de Microsoft. La capture de traces CDF avant de contacter le support Citrix est également utile. Pour plus d’informations, consultez l’article Knowledge Center CDFcontrol.

Pour des recommandations sur la collecte de traces CDF, consultez l’article Knowledge Center Recommendations for Collecting the CDF Traces.

Traces CDF côté VDA - Activez les fournisseurs de traces CDF suivants :

VDA side CDF traces

Traces CDF côté Workspace app - Activez les fournisseurs de traces CDF suivants :

Workspace App side CDF traces

IcaClient_DriversVd_TeamsRedir (facultatif)
IcaClient_Multimedia_HdxTeams (nécessite Citrix Workspace app 2012 ou version ultérieure)

La version officielle de ce document est en anglais. Certains contenus de la documentation Cloud Software Group ont été traduits de façon automatique à des fins pratiques uniquement. Cloud Software Group n'exerce aucun contrôle sur le contenu traduit de façon automatique, qui peut contenir des erreurs, des imprécisions ou un langage inapproprié. Aucune garantie, explicite ou implicite, n'est fournie quant à l'exactitude, la fiabilité, la pertinence ou la justesse de toute traduction effectuée depuis l'anglais d'origine vers une autre langue, ou quant à la conformité de votre produit ou service Cloud Software Group à tout contenu traduit de façon automatique, et toute garantie fournie en vertu du contrat de licence de l'utilisateur final ou des conditions d'utilisation des services applicables, ou de tout autre accord avec Cloud Software Group, quant à la conformité du produit ou service à toute documentation ne s'applique pas dans la mesure où cette documentation a été traduite de façon automatique. Cloud Software Group ne pourra être tenu responsable de tout dommage ou problème dû à l'utilisation de contenu traduit de façon automatique.

Cela vous a-t-il été utile ?

Surveiller, dépanner et prendre en charge Microsoft Teams

March 18, 2026

Contributeur:

March 18, 2026

Contributeur:

Cela vous a-t-il été utile ?