Citrix DaaS™

Monitorare, risolvere i problemi e supportare Microsoft Teams

September 16, 2025

Grazie al contributo di:

C C

Monitorare Teams

Questa sezione fornisce le linee guida per il monitoraggio dell’ottimizzazione di Microsoft Teams con HDX. Se si esegue in modalità ottimizzata e HdxRtcEngine.exe è in esecuzione sulla macchina client, un processo sul VDA chiamato WebSocketAgent.exe è in esecuzione nella sessione. Utilizzare Activity Manager in Director per visualizzare l’applicazione.

Monitorare Teams in Activity Manager

Con la versione minima 1912 del VDA, è possibile monitorare le chiamate Teams attive utilizzando Citrix HDX Monitor (versione minima 3.11). L’ISO del prodotto Citrix Virtual Apps and Desktops contiene l’ultima versione di hdxmonitor.msi nella cartella layout\image-full\Support\HDX Monitor.

Per maggiori informazioni, consultare Monitoring nell’articolo del Knowledge Center CTX253754.

Risoluzione dei problemi

Questa sezione fornisce suggerimenti per la risoluzione dei problemi che potrebbero verificarsi durante l’utilizzo dell’ottimizzazione per Microsoft Teams. Per maggiori informazioni, consultare CTX253754.

Sul Virtual Delivery Agent

Sono presenti quattro servizi installati da BCR_x64.msi. Solo due sono responsabili del reindirizzamento di Microsoft Teams nel VDA.

Quattro servizi installati dal reindirizzamento del contenuto del browser

Citrix HDX Teams Redirection Service stabilisce il canale virtuale utilizzato in Microsoft Teams. Il servizio si basa su CtxSvcHost.exe.
Citrix HDX HTML5 Video Redirection Service viene eseguito come WebSocketService.exe in ascolto su 127.0.0.1:9002 TCP. WebSocketService.exe esegue due funzioni principali:

i. La terminazione TLS per WebSockets sicuri riceve una connessione WebSocket sicura da vdiCitrixPeerConnection.js, che è un componente all’interno dell’app Microsoft Teams. È possibile monitorarla con Process Monitor. Per maggiori informazioni sui certificati, consultare la sezione “TLS and HTML5 video redirection, and browser content redirection” in Comunicazione tra Controller e VDA.

Alcuni software antivirus e di sicurezza desktop interferiscono con il corretto funzionamento di WebSocketService.exe e dei suoi certificati. Sebbene il servizio Citrix HDX HTML5 Video Redirection possa essere in esecuzione nella console services.msc, il socket TCP localhost 127.0.0.1:9002 non è mai in modalità di ascolto, come si può vedere in netstat. Il tentativo di riavviare il servizio lo fa bloccare (“Arresto in corso…”). Assicurarsi di applicare le esclusioni appropriate per il processo WebSocketService.exe.

ii. Mappatura della sessione utente. Quando l’applicazione Microsoft Teams si avvia, WebSocketService.exe avvia il processo WebSocketAgent.exe nella sessione dell’utente nel VDA. WebSocketService.exe viene eseguito nella Sessione 0 come account LocalSystem.

È possibile utilizzare netstat per verificare se il servizio WebSocketService.exe è in uno stato di ascolto attivo nel VDA.

Eseguire netstat -anob -p tcp da una finestra del prompt dei comandi con privilegi elevati:

In caso di connessione riuscita, lo stato cambia in ESTABLISHED:

Importante:

WebSocketService.exe è in ascolto su due socket TCP, 127.0.0.1:9001 e 127.0.0.1:9002. La porta 9001 viene utilizzata per il reindirizzamento del contenuto del browser e il reindirizzamento video HTML5. La porta 9002 viene utilizzata per il reindirizzamento di Microsoft Teams. Assicurarsi di non avere configurazioni proxy nel sistema operativo Windows del VDA che possano impedire una comunicazione diretta tra Teams.exe e WebSocketService.exe. A volte, quando si configura un proxy esplicito in Internet Explorer 11 (Opzioni Internet > Connessioni > Impostazioni LAN > Server proxy), le connessioni potrebbero passare attraverso un server proxy assegnato. Verificare che l’opzione Ignora server proxy per gli indirizzi locali sia selezionata quando si utilizza un’impostazione proxy manuale ed esplicita.

Posizioni e descrizioni dei servizi

Servizio	Percorso dell’eseguibile nel sistema operativo Windows Server	Accedi come	Descrizione
Citrix HTML5 Video Redirection Service	“C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service	Account Sistema Locale	Fornisce più servizi multimediali HDX con il framework iniziale necessario per eseguire il reindirizzamento dei media tra il desktop virtuale e il dispositivo endpoint.
Citrix HDX Browser Redirection Service	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs	Questo account (servizio locale)	Fornisce il reindirizzamento del contenuto del browser tra il dispositivo endpoint e il desktop virtuale.
Citrix Port Forwarding Service	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs	Questo account (servizio locale)	Fornisce il port forwarding tra il dispositivo endpoint e il desktop virtuale per il reindirizzamento del contenuto del browser.
Citrix HDX Teams Redirection Service	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs	Account Sistema Locale	Fornisce il reindirizzamento di Microsoft Teams tra il dispositivo endpoint e il desktop virtuale.

App Citrix Workspace™

Sull’endpoint dell’utente, l’app Citrix Workspace per Windows istanzia un nuovo servizio chiamato HdxTeams.exe. Lo fa quando Microsoft Teams si avvia nel VDA e l’utente tenta di chiamare o accedere alle periferiche in auto-anteprima. Se non si visualizza questo servizio, verificare quanto segue:

Assicurarsi di aver installato almeno la versione 1905 di Workspace App per Windows. Sono presenti i binari HdxTeams.exe e webrpc.dll nel percorso di installazione dell’app Workspace?
Se è stato convalidato il passaggio 1, eseguire le seguenti operazioni per verificare se HdxTeams.exe viene avviato.
1. Uscire da Microsoft Teams sul VDA.
2. Avviare services.msc sul VDA.
3. Arrestare il servizio Citrix HDX Teams Redirection Service.
4. Disconnettere la sessione ICA®.
5. Connettere la sessione ICA.
6. Avviare il servizio Citrix HDX Teams Redirection Service.
7. Riavviare il servizio Citrix HDX HTML5 Video Redirection Service.
8. Avviare Microsoft Teams sul VDA.
Se HdxTeams.exe non viene ancora avviato sull’endpoint client, eseguire le seguenti operazioni:
1. Riavviare il VDA.
2. Riavviare l’endpoint client.

Supporto

Citrix e Microsoft supportano congiuntamente la distribuzione di Microsoft Teams da Citrix Virtual Apps and Desktops™ utilizzando l’ottimizzazione per Microsoft Teams. Questo supporto congiunto è il risultato di una stretta collaborazione tra le due aziende. Se si dispone di contratti di supporto validi e si riscontra un problema con questa soluzione, aprire un ticket di supporto con il fornitore il cui codice si sospetta stia causando il problema. Ovvero, Microsoft per Teams o Citrix per i componenti di ottimizzazione.

Citrix o Microsoft riceve il ticket, valuta il problema e lo inoltra se necessario. Non è necessario contattare il team di supporto di ciascuna azienda.

Quando si riscontra un problema, si consiglia di fare clic su Guida > Segnala un problema nell’interfaccia utente di Teams. I log lato VDA vengono automaticamente condivisi tra Citrix e Microsoft per risolvere i problemi tecnici più rapidamente.

Raccolta dei log

I log del motore multimediale HDX si trovano sulla macchina dell’utente (non sul VDA). In caso di problemi, assicurarsi di allegare i log al proprio caso di supporto.

Log di Windows:

È possibile trovare i log di Windows in %TEMP% all’interno della cartella HDXTeams (AppData/Local/Temp/HDXTeams o AppData/Local/Temp/HdxRtcEngine). Cercare un file .txt chiamato webrpc_Day_Month_timestamp_Year.txt. Se si utilizzano versioni più recenti dell’app Citrix Workspace, ad esempio Citrix Workspace app 2009.5 o successive, archiviare i log in AppData\Local\Temp\HdxRtcEngine.

Ogni sessione crea una cartella separata per i log.

Log di Mac:

Log VDWEBRTC - registra l’esecuzione del canale virtuale.

Posizione: /Users/<User Name>/Library/Logs/Citrix Workspace/CitrixViewer_<Y_M_D_H_M_S>.txt
Log HdxRtcEngine - registra l’esecuzione dei processi su HdxRtcEngine.

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

Il log HdxRtcEngine è abilitato per impostazione predefinita.
Log Webrpc - sono i log più importanti che registrano l’esecuzione del completamento della libreria webrtc.

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

Log di Linux:

È possibile trovare i log di Linux nelle cartelle /tmp/webrpc/<current date>/ e /tmp/hdxrtcengine/<current date>/. Log Webrtc: /tmp/webrpc/<current date>/webrtc.log Log del kernel: /var/log/syslog

Log ICE/STUN/TURN:

Quando si stabilisce una chiamata, sono richieste queste quattro fasi ICE:

Raccolta dei candidati
Scambio di candidati
Controlli di connettività (richieste di bind STUN)
Promozione dei candidati

Nei log di HdxRtcEngine.exe, le seguenti voci sono le voci ICE (Interactive Connectivity Establishment) pertinenti. Queste voci devono essere presenti affinché la configurazione di una chiamata abbia successo. Vedere il seguente frammento di esempio per la fase di raccolta:

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

Se sono presenti più candidati ICE, l’ordine di preferenza è:

host
peer reflexive
server reflexive
transport relay

Se si riscontra un problema e si riesce a riprodurlo in modo coerente, si consiglia di fare clic su Guida > Segnala un problema in Teams. I log vengono condivisi tra Citrix e Microsoft per risolvere i problemi tecnici se è stato aperto un caso con Microsoft. L’acquisizione delle tracce CDF prima di contattare il supporto Citrix è inoltre utile. Per maggiori informazioni, consultare l’articolo del Knowledge Center CDFcontrol.

Per raccomandazioni sulla raccolta delle tracce CDF, consultare l’articolo del Knowledge Center Recommendations for Collecting the CDF Traces.

Tracce CDF lato VDA - Abilitare i seguenti provider di tracce CDF:

Tracce CDF lato VDA

Tracce CDF lato app Workspace - Abilitare i seguenti provider di tracce CDF:

Tracce CDF lato app Workspace

IcaClient_DriversVd_TeamsRedir (opzionale)
IcaClient_Multimedia_HdxTeams (richiede Citrix Workspace app 2012 o successiva)

La versione ufficiale di questo contenuto è in inglese. Per alcuni dei contenuti della documentazione Cloud Software Group è stata impiegata la traduzione automatica solo per comodità. Cloud Software Group non ha alcun controllo sui contenuti tradotti in modo automatico, che possono contenere errori, imprecisioni o linguaggio inadatto. Non viene offerta alcuna garanzia di alcun tipo, espressa o implicita, circa l'accuratezza, l'affidabilità, l'idoneità o la correttezza di qualsiasi traduzione dall'originale inglese in qualsiasi altra lingua, o che il prodotto o servizio Cloud Software Group sia conforme a qualsiasi contenuto in traduzione automatica, e qualsiasi garanzia fornita ai sensi del contratto di licenza per l'utente finale applicabile o i termini di servizio, o qualsiasi altro accordo con Cloud Software Group che il prodotto o il servizio sia conforme a qualsiasi documentazione non si applicheranno nella misura in cui tale documentazione sia in traduzione automatica. Cloud Software Group non sarà ritenuta responsabile per eventuali danni o problemi che potrebbero derivare dall'utilizzo di contenuti per cui si è impiegata la traduzione automatica.

È stato utile?

Monitorare, risolvere i problemi e supportare Microsoft Teams

September 16, 2025

Grazie al contributo di:

C C

September 16, 2025

Grazie al contributo di:

C C

È stato utile?