Sondagem de Aplicativos e Desktops
A sondagem de aplicativos e desktops automatiza o processo de verificação da integridade dos aplicativos e desktops publicados em um site, iniciando-os sequencialmente para teste usando o StoreFront. Os resultados da sondagem estão disponíveis no Director.
Requisitos
- O Delivery Controller executa a versão 7.18 ou posterior para sondagem de aplicativos e a versão 1906 ou posterior para sondagem de desktops.
- As máquinas de endpoint que executam agentes de sondagem são máquinas Windows com o aplicativo Citrix Workspace™ para Windows versão 1808 ou posterior para sondagem de aplicativos e versão 1906 ou posterior para sondagem de desktops. O aplicativo Workspace para Unified Windows Platform (UWP) não é compatível.
- O Citrix Probe Agent oferece suporte à autenticação via StoreFront e Citrix Workspace usando credenciais do Active Directory. Nos casos em que o dispositivo de endpoint está conectado ao StoreFront/Workspace via Citrix Gateway, você pode se autenticar usando as credenciais de domínio do Citrix Gateway ou a autenticação multifator (MFA). O Citrix Probe Agent não oferece suporte a outros métodos de autenticação, como Single Sign-On (SSO).
- Certifique-se de que o Microsoft .NET Framework versão 4.7.2 ou posterior esteja instalado na máquina de endpoint onde você deseja instalar o Probe Agent.
Contas de usuário/permissões necessárias para executar a Sondagem:
- Um usuário StoreFront exclusivo para sondar em cada máquina de endpoint. O usuário StoreFront não precisa ser um administrador; as sondagens podem ser executadas em um contexto não administrativo.
- Contas de usuário com permissões de administrador do Windows para instalar e configurar o Citrix Probe Agent nas máquinas de endpoint.
- O usuário deve ser membro do mesmo domínio que os VDAs usados para o lançamento de aplicativos ou desktops. O Probe Agent atualmente não oferece suporte a vários domínios.
- A reutilização de contas de usuário existentes para sondagem pode desconectar as sessões ativas dos usuários. Uma conta de usuário administrador completa ou uma função personalizada com as seguintes permissões:
- Permissões de grupo de entrega:
- Somente leitura
- Permissões do Director:
- Criar\Editar\Remover Configuração do Servidor de E-mail de Alerta - se o servidor de e-mail ainda não estiver configurado
- Criar\Editar\Remover Configurações de Sondagem
- Visualizar página de Configurações
- Visualizar página de Tendências
- Permissões de grupo de entrega:
Configuração
Você pode agendar suas sondagens para serem executadas durante o horário de pico em várias regiões geográficas. Os resultados abrangentes da sondagem podem ajudar a solucionar problemas relacionados aos aplicativos, máquina de hospedagem ou conexão antes que os usuários os experimentem.
O Citrix Probe Agent versão 2103 e posterior oferece suporte à agregação de sites. Ao configurar o Citrix Probe Agent, selecione a opção “Agregação de Site do Workspace (StoreFront) Habilitada” para permitir a enumeração de aplicativos e desktops de sites agregados. As seguintes combinações de sites são compatíveis:
- Vários sites locais com uma URL do StoreFront.
- Sites locais e na nuvem com uma URL do StoreFront ou do Workspace.
- Vários sites na nuvem com uma URL do Workspace.
- Sites locais conectados ao StoreFront ou Workspace via Citrix Gateway.
Observação:
Você deve criar administradores ou usuários separados para configurar sondagens que tenham acesso a apenas um site.
Etapa 1: Instalar e configurar o Citrix Probe Agent
O Citrix Probe Agent é um executável do Windows que simula o lançamento real de aplicativos ou desktops pelo usuário através do StoreFront. Ele testa os lançamentos conforme configurado no Director e reporta os resultados de volta ao Director.
-
Identifique as máquinas de endpoint de onde você deseja executar a sondagem.
-
Usuários com privilégios administrativos podem instalar e configurar o Citrix Probe Agent na máquina de endpoint. Baixe o executável do Citrix Probe Agent disponível em https://www.citrix.com/downloads/citrix-virtual-apps-and-desktops/components/app-probe-agent.html. O link para download também está disponível na guia “Sondagens” no Director.
. -
Se você tiver sites agregados, selecione a opção “Agregação de Site do Workspace (StoreFront) Habilitada” para permitir a enumeração de aplicativos e desktops de sites agregados.
- Selecione um método de autenticação e insira as credenciais relevantes. As credenciais são criptografadas e armazenadas com segurança.
-
Configure com suas credenciais do Active Directory do StoreFront. Configure um usuário exclusivo do Workspace (StoreFront) em cada máquina de endpoint.

-
Escolha a opção “Citrix Gateway” se seu endpoint estiver conectado ao StoreFront via Citrix Gateway e configure com suas credenciais de domínio do Citrix Gateway.

-
Escolha a opção “Autenticação Multifator” se seu Gateway oferecer suporte a ela e insira a chave de autenticação de 16 dígitos. Isso está disponível apenas para o Citrix Gateway configurado com LDAP e OTP Nativo usando o Esquema de Login Único.
-
Na guia “Configurar para Exibir Resultado da Sondagem”, insira suas credenciais do Director e clique em “Validar”.

-
Selecione seu site e clique em “Avançar”.
- Na guia “Exibir Resumo”, certifique-se de que os detalhes configurados estejam precisos. Se precisar fazer alterações, vá para a guia respectiva e faça as atualizações.
Observação:
Você pode usar o script PowerShell contido em Automatizando a Instalação e Configuração do Citrix Probe Agent para automatizar a instalação e configuração do Citrix Probe Agent.
Etapa 2: Configurar a Sondagem no Director
Limitação:
A sondagem falha se aplicativos ou desktops forem iniciados para teste a partir de VDAs Windows que tenham o banner de mensagem de logon interativo habilitado. Isso ocorre porque um tempo limite é atingido devido à espera para aceitar a mensagem de logon interativo. Para desabilitar a mensagem de logon em um VDA de Servidor. Vá para “Configuração do Computador” > “Configurações do Windows” > “Configurações de Segurança” > “Políticas Locais” > “Opções de Segurança”.
Remova o texto nos seguintes campos e atualize a política da Microsoft.
- Logon Interativo: Texto da Mensagem para usuários que tentam fazer logon
- Logon Interativo: Título da Mensagem para usuários que tentam fazer logon
Atribua o usuário da sondagem a este VDA de Servidor específico com o banner de mensagem de logon interativo desabilitado para garantir que a sondagem possa passar do estado de Lançamento de Aplicativo ou Desktop.
Para obter mais informações, consulte https://learn.microsoft.com/en-us/windows/security/threat-protection/security-policy-settings/interactive-logon-message-text-for-users-attempting-to-log-on.
- Vá para “Sondagens” > “Sondagem de Aplicativos” ou “Sondagem de Desktops” e clique em “Criar Sondagem”.
- Na página “Criar Sondagem”, insira o nome da sondagem.
-
Selecione o agendamento:
- Escolha os dias da semana em que você deseja que a sondagem seja executada.
- Insira a hora de início em que você deseja que a sondagem seja executada.
- Além disso, você pode escolher a opção “Repetir em um dia”. Insira a hora de término e o intervalo em que você deseja que a sondagem se repita dentro de um dia. Por exemplo, a configuração abaixo ajuda a executar sondagens de aplicativos das 12:08 horas até as 16:34 horas, repetindo a cada 30 minutos todas as segundas, quartas, quintas e domingos.
- Selecione o número recomendado de aplicativos ou desktops a serem sondados, dependendo do intervalo.
- Selecione as máquinas de endpoint nas quais a sondagem deve ser executada.
- Insira os endereços de e-mail dos administradores para enviar os resultados das sondagens com falha. Configure seu servidor de e-mail em “Alertas” > “Configuração do Servidor de E-mail”.

Nesta configuração, as sessões de aplicativos são iniciadas às 12:08, 12:38, 13:08 e assim por diante até as 16:08, todas as segundas, quartas, quintas e domingos.
Observação:
- Após a configuração, o agente executa as sondagens configuradas a partir da próxima hora.
- As sondagens que foram configuradas antes da introdução da opção “Repetir em um dia” continuam a ser executadas no horário agendado. Elas têm a opção “Repetir em um dia” desabilitada por padrão.
- Recomenda-se que você configure as sondagens de forma que cada execução tenha um período de 5 minutos para evitar sobreposições.
Etapa 3: Execução da sondagem
O agente executa a sondagem de acordo com a configuração da sondagem que ele busca periodicamente no Director.
Ele inicia os aplicativos selecionados sequencialmente usando o StoreFront. O agente reporta os resultados de volta ao Director via banco de dados do Monitor. As falhas são reportadas em cinco estágios específicos:
- Acessibilidade do StoreFront - a URL do StoreFront configurada não está acessível.
- Autenticação do StoreFront - as credenciais do StoreFront configuradas são inválidas.
- Enumeração do StoreFront - a lista de aplicativos enumerados do StoreFront não contém o aplicativo ou desktop a ser sondado.
- Download do ICA® - o arquivo ICA não está disponível.
- Lançamento de Aplicativo/Desktop – o aplicativo ou desktop não pôde ser iniciado.
Etapa 4: Visualizar resultados da sondagem
Você pode ver os resultados da sondagem em “Sondagens”. A visualização de Sondagens oferece uma visão abrangente dos resultados da sondagem. Esses resultados ajudam a analisar e solucionar problemas proativamente, permitindo uma experiência de lançamento de sessão mais suave para os usuários.
A guia “Visão Geral” fornece um resumo de todas as sondagens configuradas em uma única visualização.

Você pode filtrar as sondagens com base em “Período de Tempo”, “Tipo de Sondagem”, “Nome do Endpoint”, “Nome do Aplicativo”, “Nome do Desktop” e “Tipo de Resultado da Sondagem”. As sondagens que correspondem aos critérios de filtro são exibidas com os seguintes detalhes por sondagem, aplicativo/desktop e endpoint.
Métricas de Sondagem mostra a contagem de execuções Agendadas, Planejadas, Ignoradas, Bem-sucedidas e Com Falha.
- Execuções Concluídas – o número de execuções de sondagem que foram concluídas.
- Execuções Com Falha – o número de execuções de sondagem que falharam.
- Execuções Ignoradas – o número de execuções que não foram concluídas devido ao endpoint estar inativo ou aos serviços estarem indisponíveis.
- Execuções Bem-sucedidas – o número de sondagens que foram concluídas com sucesso, sem falhas em nenhuma etapa durante o lançamento do aplicativo/desktop.
O número total de máquinas de endpoint também é exibido, com a contagem de máquinas ativas e inativas.
Estágios de Falha da Sondagem apresenta uma análise visual da distribuição de falhas para cada grupo de falhas. Ao analisar os estágios em que a maioria das falhas ocorreu, torna-se mais fácil interpretar os resultados da sondagem e solucionar problemas. A representação gráfica mostra o número de execuções de sondagem com falha para lançamento de aplicativo/desktop, downloads de arquivos ICA, enumeração do StoreFront/Workspace, acessibilidade do StoreFront/Workspace e autenticação do StoreFront/Workspace.
Isso ajuda a analisar os estágios em que a maioria das falhas ocorreu. Esta informação ajuda a entender rapidamente os resultados da sondagem e a solucionar problemas.
Algumas execuções de sondagem podem não ser concluídas devido ao endpoint estar inativo ou aos serviços estarem indisponíveis.
A guia “Execuções de Sondagem” fornece os resultados das execuções de sondagem concluídas em detalhes. Você pode detalhar para ver os detalhes de cada execução individual de uma sondagem selecionada. Você pode filtrar e analisar ainda mais com base em pontos de pivô importantes.

Você pode filtrar as execuções de sondagem com base em “Período de Tempo”, “Tipo de Sondagem”, “Nome do Endpoint”, “Nome do Aplicativo”, “Nome do Desktop” e “Estágio de Falha da Sondagem”. “Estágio de Falha da Sondagem” exibe o estágio em que a sondagem falhou. Clicar nos links “Nome da Sondagem”, “Execuções Agendadas”, “Execuções Com Falha”, “Nome do Aplicativo/Desktop” também leva você à página “Execuções de Sondagem” com a lista de execuções de sondagem que correspondem aos critérios de filtro.