Citrix Virtual Apps and Desktops

Monitorar, solucionar problemas e dar suporte ao Microsoft Teams

January 23, 2026

Contribuição de:

Monitorar o Teams

Esta seção fornece diretrizes para monitorar a otimização do Microsoft Teams com HDX. Se você estiver executando no modo otimizado e o HdxRtcEngine.exe estiver em execução na máquina cliente, um processo no VDA chamado WebSocketAgent.exe estará em execução na sessão. Use o Gerenciador de Atividades no Director para ver o aplicativo.

Monitorar o Teams no Gerenciador de Atividades

O status da otimização do Microsoft Teams pode ser visualizado na página “Detalhes do Usuário” do Director > painel “Detalhes da Sessão” > campo “Otimização do MS Teams”. A otimização do Microsoft Teams é fundamental para uma melhor experiência do usuário, como áudio e vídeo nítidos. Este recurso está disponível para VDA versão 2311 e posterior. As versões do aplicativo Citrix Workspace™ compatíveis estão listadas em Otimização para Microsoft Teams. O Director exibe o status da otimização do Microsoft Teams somente se o Microsoft Teams estiver em execução como um aplicativo publicado ou dentro de um desktop publicado. Para obter mais informações, consulte Status da otimização do Microsoft Teams.

Com a versão mínima 1912 do VDA, você pode monitorar chamadas ativas do Teams usando o Citrix HDX Monitor (versão mínima 3.11). O ISO do produto Citrix Virtual Apps and Desktops contém o hdxmonitor.msi mais recente na pasta layout\image-full\Support\HDX Monitor. Com a versão mínima 1912 do VDA, você pode monitorar chamadas ativas do Microsoft Teams usando o Citrix HDX Monitor (versão mínima 3.11). O ISO do produto Citrix Virtual Apps and Desktops contém o hdxmonitor.msi mais recente na pasta layout\image-full\Support\HDX Monitor.

Para obter mais informações, consulte Monitoramento no artigo da Central de Conhecimento CTX253754.

Solucionar problemas

Esta seção fornece dicas de solução de problemas para questões que você pode encontrar ao usar a otimização para Microsoft Teams. Para obter mais informações, consulte CTX253754.

No Virtual Delivery Agent

Existem quatro serviços instalados pelo BCR_x64.msi. Apenas dois são responsáveis pelo redirecionamento do Microsoft Teams no VDA.

Quatro serviços instalados pelo redirecionamento de conteúdo do navegador

O Citrix HDX Teams Redirection Service estabelece o canal virtual usado no Microsoft Teams. O serviço depende de CtxSvcHost.exe.
O Citrix HDX HTML5 Video Redirection Service é executado como WebSocketService.exe, escutando em 127.0.0.1:9002 TCP. O WebSocketService.exe executa duas funções principais:

i. A terminação TLS para WebSockets seguros recebe uma conexão WebSocket segura de vdiCitrixPeerConnection.js, que é um componente dentro do aplicativo Microsoft Teams. Você pode rastreá-lo com o “Monitor de Processos”. Para obter mais informações sobre certificados, consulte a seção Redirecionamento de vídeo TLS e HTML5 e redirecionamento de conteúdo do navegador.

Alguns softwares antivírus e de segurança de desktop interferem no funcionamento adequado do WebSocketService.exe e seus certificados. Embora o serviço Citrix HDX HTML5 Video Redirection possa estar em execução no console services.msc, o socket TCP localhost 127.0.0.1:9002 nunca está no modo de escuta, como visto no netstat. Tentar reiniciar o serviço faz com que ele trave (“Parando…”). Certifique-se de aplicar as exclusões adequadas para o processo WebSocketService.exe.

ii. Mapeamento de sessão do usuário. Quando o aplicativo Microsoft Teams é iniciado, o WebSocketService.exe inicia o processo WebSocketAgent.exe na sessão do usuário no VDA. O WebSocketService.exe é executado na Sessão 0 como uma conta LocalSystem.

Você pode usar o netstat para verificar se o serviço WebSocketService.exe está em um estado de escuta ativa no VDA.

Execute netstat -anob -p tcp a partir de uma janela de prompt de comando elevada:

Em uma conexão bem-sucedida, o estado muda para ESTABLISHED:

Importante:

O WebSocketService.exe escuta em dois sockets TCP, 127.0.0.1:9001 e 127.0.0.1:9002. A porta 9001 é usada para redirecionamento de conteúdo do navegador e redirecionamento de vídeo HTML5. A porta 9002 é usada para redirecionamento do Microsoft Teams. Certifique-se de não ter nenhuma configuração de proxy no sistema operacional Windows do VDA que possa impedir uma comunicação direta entre Teams.exe e WebSocketService.exe. Às vezes, quando você configura um proxy explícito no Internet Explorer 11 (“Opções da Internet” > “Conexões” > “Configurações da LAN” > “Servidor proxy”), as conexões podem fluir por um servidor proxy atribuído. Verifique se a opção “Ignorar servidor proxy para endereços locais” está marcada ao usar uma configuração de proxy manual e explícita.

Locais e descrições dos serviços

Serviço	Caminho para o executável no SO Windows Server	Fazer logon como	Descrição
Citrix HTML5 Video Redirection Service	“C:\Program Files (x86)\Citrix\System32\WebSocketService.exe” /service	Local System account	Fornece vários serviços HDX Multimídia com a estrutura inicial necessária para realizar o redirecionamento de mídia entre o desktop virtual e o dispositivo de endpoint.
Citrix HDX Browser Redirection Service	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g BrowserRedirSvcs	Esta conta (serviço local)	Fornece redirecionamento de conteúdo do navegador entre o dispositivo de endpoint e o desktop virtual.
Citrix Port Forwarding Service	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g PortFwdSvcs	Esta conta (serviço local)	Fornece encaminhamento de porta entre o dispositivo de endpoint e o desktop virtual para redirecionamento de conteúdo do navegador.
Citrix HDX Teams Redirection Service	“C:\Program Files (x86)\Citrix\System32\CtxSvcHost.exe” -g TeamsSvcs	Local System account	Fornece redirecionamento do Microsoft Teams entre o dispositivo de endpoint e o desktop virtual.

Aplicativo Citrix Workspace

No endpoint do usuário, o aplicativo Citrix Workspace para Windows instancia um novo serviço chamado HdxTeams.exe ou HdxRtcEngine.exe. Isso acontece quando o Microsoft Teams é iniciado no VDA e o usuário tenta ligar ou acessar os periféricos na pré-visualização. Se você não vir este serviço, verifique o seguinte:

Certifique-se de ter instalado no mínimo a versão 1905 do aplicativo Workspace para Windows. Você vê os binários HdxTeams.exe ou HdxRtcEngine.exe e webrpc.dll no caminho de instalação do aplicativo Workspace?
Se você validou a etapa 1, faça o seguinte para verificar se HdxTeams.exe ou HdxRtcEngine.exe está sendo iniciado.
1. Saia do Microsoft Teams no VDA.
2. Inicie services.msc no VDA.
3. Pare o Citrix HDX Teams Redirection Service.
4. Desconecte a sessão ICA®.
5. Conecte a sessão ICA.
6. Inicie o Citrix HDX Teams Redirection Service.
7. Reinicie o Citrix HDX HTML5 Video Redirection Service.
8. Inicie o Microsoft Teams no VDA.
Se você ainda não vir HdxTeams.exe ou HdxRtcEngine.exe sendo iniciado no endpoint do cliente, faça o seguinte:
1. Reinicie o VDA.
2. Reinicie o endpoint do cliente.

Suporte

A Citrix e a Microsoft dão suporte conjunto à entrega do Microsoft Teams a partir do Citrix Virtual Apps and Desktops™ usando a otimização para Microsoft Teams. Este suporte conjunto é o resultado de uma estreita colaboração entre as duas empresas. Se você tiver contratos de suporte válidos e encontrar um problema com esta solução, abra um tíquete de suporte com o fornecedor cujo código você suspeita estar causando o problema. Ou seja, Microsoft para o Teams ou Citrix para os componentes de otimização. A Citrix ou a Microsoft recebe o tíquete, faz a triagem do problema e o encaminha conforme apropriado. Não há necessidade de você entrar em contato com a equipe de suporte de cada empresa.

Quando você tiver um problema, recomendamos que clique em “Ajuda” > “Relatar um Problema” na interface do usuário do Teams. Os logs do lado do VDA são automaticamente compartilhados entre a Citrix e a Microsoft para resolver problemas técnicos mais rapidamente.

Coletando logs

Os logs do mecanismo de mídia HDX podem ser encontrados na máquina do usuário (não no VDA). Em caso de problemas, certifique-se de anexar os logs ao seu caso de suporte.

Logs do Windows

Você pode localizar os logs do Windows em %TEMP% dentro da pasta HDXTeams (AppData/Local/Temp/HDXTeams ou AppData/Local/Temp/HdxRtcEngine). Procure por um arquivo .txt chamado webrpc_Day_Month_timestamp_Year.txt. Se você estiver usando versões mais recentes do aplicativo Citrix Workspace, por exemplo, Citrix Workspace app 2009.5 ou posterior, armazene os logs em AppData\Local\Temp\HdxRtcEngine.

Cada sessão cria uma pasta separada para os logs.

Logs do Mac

Log VDWEBRTC - registra a execução do canal virtual.

Local:/Users/<User Name>/Library/Logs/Citrix Workspace/CitrixViewer_<Y_M_D_H_M_S>.txt
Log HdxRtcEngine - registra a execução dos processos no HdxRtcEngine.

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

O log HdxRtcEngine é habilitado por padrão.
Logs Webrpc - são os logs mais importantes que registram a execução do encerramento da biblioteca webrtc.

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

Logs do Linux

Você pode localizar os logs do Linux nas pastas /tmp/webrpc/<current date>/ and /tmp/hdxrtcengine/<current date>/. Log Webrtc: /tmp/webrpc/<current date>/webrtc.log Log do Kernel: /var/log/syslog

Logs ICE/STUN/TURN

Ao estabelecer uma chamada, estas quatro fases ICE são necessárias:

Coleta de candidatos
Troca de candidatos
Verificações de conectividade (solicitações de ligação STUN)
Promoção de candidatos

Nos logs do HdxRtcEngine.exe, as seguintes entradas são as entradas relevantes de Interactive Connectivity Establishment (ICE). Essas entradas devem estar presentes para que a configuração da chamada seja bem-sucedida. Veja o seguinte trecho de exemplo para a fase de coleta:

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 houver vários candidatos ICE, a ordem de preferência é:

host
reflexivo de par
reflexivo de servidor
retransmissão de transporte

Se você encontrar um problema e puder reproduzi-lo consistentemente, recomendamos que clique em “Ajuda” > “Relatar um problema” no Microsoft Teams. Os logs são compartilhados entre a Citrix e a Microsoft para resolver problemas técnicos se você abriu um caso com a Microsoft. A captura de rastreamentos CDF antes de entrar em contato com o Suporte Citrix também é benéfica. Para obter mais informações, consulte o artigo da Central de Conhecimento CDFcontrol.

Para recomendações sobre a coleta de rastreamentos CDF, consulte o artigo da Central de Conhecimento Recomendações para Coletar os Rastros CDF.

Rastros CDF do lado do VDA - Habilite os seguintes provedores de rastreamento CDF

Rastros CDF do lado do VDA

Rastros CDF do lado do aplicativo Workspace - Habilite os seguintes provedores de rastreamento CDF

Rastros CDF do lado do aplicativo Workspace

IcaClient_DriversVd_TeamsRedir (opcional)
IcaClient_Multimedia_HdxTeams (requer Citrix Workspace app 2012 ou posterior)

A versão oficial deste conteúdo está em inglês. Parte do conteúdo da documentação da Cloud Software Group é traduzida automaticamente para sua conveniência. A Cloud Software Group não tem controle sobre o conteúdo traduzido automaticamente, que pode conter erros, imprecisões ou linguagem inadequada. Nenhuma garantia de qualquer tipo, expressa ou implícita, é fornecida quanto à precisão, confiabilidade, adequação ou correção de quaisquer traduções feitas do original em inglês para qualquer outro idioma, ou quanto à conformidade do seu produto ou serviço Cloud Software Group com qualquer conteúdo traduzido automaticamente, e nenhuma garantia fornecida sob o contrato de licença de usuário final aplicável ou os termos de serviço, ou qualquer outro contrato com a Cloud Software Group, de que o produto ou serviço esteja em conformidade com qualquer documentação será aplicável na medida em que essa documentação tenha sido traduzida automaticamente. A Cloud Software Group não se responsabiliza por quaisquer danos ou problemas que possam surgir em decorrência do uso de conteúdo traduzido automaticamente.

Isso foi útil?

Monitorar, solucionar problemas e dar suporte ao Microsoft Teams

January 23, 2026

Contribuição de:

January 23, 2026

Contribuição de:

Isso foi útil?