Citrix DaaS™

Surveiller, dépanner et prendre en charge Microsoft Teams

April 6, 2026

Contributeur:

C C

Surveiller Teams

Cette section fournit des lignes directrices pour la surveillance de l’optimisation de Microsoft Teams avec HDX. Si vous exécutez en mode optimisé et que HdxRtcEngine.exe est en cours d’exécution sur la machine cliente, un processus sur le VDA appelé WebSocketAgent.exe est en cours d’exécution dans la session. Utilisez le Gestionnaire d’activités dans Director pour voir l’application.

Surveiller Teams dans le Gestionnaire d'activités

Avec la version minimale 1912 du VDA, vous pouvez surveiller les appels Teams actifs à l’aide de Citrix HDX Monitor (version minimale 3.11). L’ISO du 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 Surveillance dans l’article du centre de connaissances CTX253754.

Dépannage

Cette section fournit des conseils de dépannage pour les problèmes que vous pourriez 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 de Microsoft Teams dans le VDA.

Quatre services installés par la redirection de contenu de navigateur

Service de redirection Citrix HDX Teams établit le canal virtuel utilisé dans Microsoft Teams. Le service repose sur CtxSvcHost.exe.
Service de redirection vidéo HTML5 Citrix HDX s’exécute en tant que WebSocketService.exe, écoutant sur 127.0.0.1:9002 TCP. WebSocketService.exe remplit deux fonctions principales :

i. La terminaison TLS pour les WebSockets sécurisés reçoit une connexion WebSocket sécurisée de vdiCitrixPeerConnection.js, qui est un composant de l’application Microsoft Teams. Vous pouvez le suivre avec le Moniteur de processus. Pour plus d’informations sur les certificats, consultez la section « TLS et redirection vidéo HTML5, et redirection de contenu de navigateur » sous Communication entre le contrôleur et le VDA.

Certains logiciels antivirus et de sécurité de bureau interfèrent avec le bon fonctionnement de WebSocketService.exe et de ses certificats. Bien que le service de redirection vidéo HTML5 Citrix HDX puisse être 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 indiqué dans netstat. Tenter de redémarrer le service le fait se bloquer (« Arrêt en cours… »). 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 démarre le processus WebSocketAgent.exe dans la session de l’utilisateur dans le VDA. WebSocketService.exe s’exécute dans la Session 0 en tant que compte LocalSystem.

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

Exécutez netstat -anob -p tcp à partir d’une fenêtre d’invite de commandes avec élévation de privilèges :

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 de navigateur et la redirection vidéo HTML5. Le port 9002 est utilisé pour la redirection de Microsoft Teams. Assurez-vous de ne pas avoir de configurations de proxy dans le système d’exploitation Windows du VDA qui pourraient 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 par un serveur proxy attribué. Vérifiez que l’option Ignorer le serveur proxy pour les adresses locales est cochée lorsque vous utilisez un paramètre de proxy manuel et explicite.

Emplacements et descriptions des services

Service	Chemin d’accès à l’exécutable dans le système d’exploitation Windows Server	Ouvrir la session en tant que	Description
Service de redirection vidéo HTML5 Citrix	“C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service	Compte système local	Fournit plusieurs services multimédias HDX avec le cadre initial requis pour effectuer la redirection multimédia entre le bureau virtuel et le périphérique de point de terminaison.
Service de redirection de navigateur Citrix HDX	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs	Ce compte (service local)	Fournit la redirection de contenu de navigateur entre le périphérique de point de terminaison et le bureau virtuel.
Service de redirection de port Citrix	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs	Ce compte (service local)	Fournit la redirection de port entre le périphérique de point de terminaison et le bureau virtuel pour la redirection de contenu de navigateur.
Service de redirection Citrix HDX Teams	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs	Compte système local	Fournit la redirection de Microsoft Teams entre le périphérique de point de terminaison et le bureau virtuel.

Application Citrix Workspace™

Sur le point de terminaison de l’utilisateur, l’application Citrix Workspace pour Windows instancie un nouveau service appelé HdxTeams.exe. Elle le fait lorsque Microsoft Teams se lance dans le VDA et que l’utilisateur tente d’appeler ou d’accéder aux périphériques en auto-aperçu. Si vous ne voyez pas ce service, vérifiez les points suivants :

Assurez-vous d’avoir installé au minimum la version 1905 de l’application Workspace pour Windows. Voyez-vous les binaires HdxTeams.exe et webrpc.dll dans le chemin d’installation de l’application Workspace ?
Si vous avez validé l’étape 1, procédez comme suit pour vérifier si HdxTeams.exe est lancé.
1. Quittez Microsoft Teams sur le VDA.
2. Démarrez services.msc sur le VDA.
3. Arrêtez le service de redirection Citrix HDX Teams.
4. Déconnectez la session ICA®.
5. Connectez la session ICA.
6. Démarrez le service de redirection Citrix HDX Teams.

1. Redémarrez le service de redirection vidéo HTML5 Citrix HDX.
1. Lancez Microsoft Teams sur le VDA.
1. Si vous ne voyez toujours pas HdxTeams.exe être lancé sur le point de terminaison client, procédez comme suit :
1. Redémarrez le VDA.
2. Redémarrez le point de terminaison client.

Assistance

Citrix et Microsoft prennent en charge conjointement la livraison de Microsoft Teams à partir de Citrix Virtual Apps and Desktops™ à l’aide de l’optimisation pour Microsoft Teams. Ce support conjoint est le résultat d’une étroite collaboration entre les deux entreprises. Si vous avez des contrats de support valides et que vous rencontrez un problème avec cette solution, ouvrez un ticket de support auprès du fournisseur dont vous suspectez le code d’être à l’origine du problème. C’est-à-dire, Microsoft pour Teams ou Citrix pour les composants d’optimisation.

Citrix ou Microsoft reçoit le ticket, trie le problème et l’escalade si nécessaire. Il n’est pas nécessaire de contacter l’équipe de support de chaque entreprise.

En cas de problème, nous vous recommandons de cliquer sur Aide > Signaler un problème dans l’interface utilisateur de Teams. Les journaux côté VDA sont automatiquement partagés entre Citrix et Microsoft pour 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 localiser les journaux Windows à l’emplacement %TEMP% dans le dossier HDXTeams (AppData/Local/Temp/HDXTeams ou AppData/Local/Temp/HdxRtcEngine). Recherchez un fichier .txt nommé webrpc_Jour_Mois_horodatage_Année.txt. Si vous utilisez des versions plus récentes de l’application Citrix Workspace, par exemple Citrix Workspace app 2009.5 ou ultérieure, stockez les journaux 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/<Nom d'utilisateur>/Library/Logs/Citrix Workspace/CitrixViewer_<A_M_J_H_M_S>.txt
Journal HdxRtcEngine - enregistre l’exécution des processus sur HdxRtcEngine.

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

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

Emplacement : /Users/<NOM_UTILISATEUR>/Library/Logs/HdxRtcEngine/<J_S_M_J_H_M_S_A>/webrpc.log

Journaux Linux :

Vous pouvez localiser les journaux Linux dans les dossiers /tmp/webrpc/<date actuelle>/ et /tmp/hdxrtcengine/<date actuelle>/.

Journal Webrtc : /tmp/webrpc/<date actuelle>/webrtc.log
Journal du 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 de candidats
Vérifications de connectivité (requêtes de liaison STUN)
Promotion des candidats

Dans les journaux HdxRtcEngine.exe, les entrées suivantes sont les entrées pertinentes d’établissement de connectivité interactive (ICE). Ces entrées doivent être présentes pour que la configuration d’un 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 le suivant :

hôte
réflexif par les pairs
réflexif par le serveur
relais de transport

Si vous rencontrez un problème et pouvez le reproduire de manière cohérente, nous vous recommandons de cliquer sur Aide > Signaler un problème dans 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 des traces CDF avant de contacter le support Citrix est également bénéfique. Pour plus d’informations, consultez l’article du centre de connaissances CDFcontrol.

Pour des recommandations sur la collecte des traces CDF, consultez l’article du centre de connaissances Recommandations pour la collecte des traces CDF.

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

Traces CDF côté VDA

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

Traces CDF côté application Workspace

IcaClient_DriversVd_TeamsRedir (facultatif)
IcaClient_Multimedia_HdxTeams (nécessite l’application Citrix Workspace 2012 ou 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

April 6, 2026

Contributeur:

C C

April 6, 2026

Contributeur:

C C

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