Citrix Virtual Apps and Desktops

Citrix Scout

Introdução

O Citrix Scout coleta diagnósticos e executa verificações de integridade. Você pode usar os resultados para manter sua implantação do Citrix Virtual Apps and Desktops. A Citrix oferece uma análise abrangente e automatizada das coletas de diagnósticos por meio do Citrix Insight Services. Você também pode usar o Scout para solucionar problemas, por conta própria ou com as orientações do suporte da Citrix.

Você pode fazer upload de arquivos de coleção para a Citrix para análise e orientação do suporte da Citrix. Ou, você pode salvar uma coleta localmente para sua própria análise e depois fazer upload do arquivo de coleta para a Citrix para análise.

O Scout oferece os seguintes procedimentos:

  • Colect: Executa uma única coleta de diagnósticos em máquinas selecionadas em um site. Em seguida, você pode carregar o arquivo para o Citrix ou salvá-lo localmente.
  • Trace & Reproduce: Inicia um rastreamento manual nas máquinas selecionadas. Em seguida, você recria problemas nessas máquinas. Depois de recriar o problema, o rastreamento é interrompido. Em seguida, o Scout coleta outros diagnósticos e carrega o arquivo para o Citrix ou salva o arquivo localmente.
  • Schedule: agenda as coletas de diagnósticos para que ocorram diariamente ou semanalmente em um horário especificado nas máquinas selecionadas. O arquivo é carregado automaticamente para a Citrix.
  • Health Check: executa verificações que avaliam a integridade e a disponibilidade do site e de seus componentes. Você pode executar verificações de integridade para controladores de entrega, agentes de entrega virtuais (VDAs), servidores StoreFront e Servidores de licença Citrix. Se forem encontrados problemas durante as verificações, o Scout fornecerá um relatório detalhado. Cada vez que o Scout inicia, ele verifica se há scripts de verificação de integridade atualizados. Se novas versões estiverem disponíveis, o Scout as baixará automaticamente, para uso na próxima vez que as verificações de integridade forem executadas.

Nota:

Os procedimentos Trace & Reproduce, Schedule e Health Check atualmente não estão disponíveis para Linux VDA.

A interface gráfica descrita neste artigo é a principal maneira de usar o Scout. Como alternativa, você pode usar o PowerShell para configurar coleções e uploads de diagnóstico únicos ou agendados. Consulte Call Home.

Onde executar o Scout:

  • Em uma implantação local, execute o Scout a partir de um Delivery Controller para capturar diagnósticos ou executar verificações em um ou mais Virtual Delivery Agents (VDAs), Delivery Controllers, servidores StoreFront e servidores de licença. Você também pode executar o Scout a partir de um VDA para coletar diagnósticos locais.
  • Em um ambiente Citrix Cloud que usa o Citrix DaaS (anteriormente Citrix Virtual Apps and Desktops Service), execute o Scout a partir de um VDA para coletar diagnósticos locais.

O registro do aplicativo Scout é armazenado em C:\ProgramData\Citrix\TelemetryService\ScoutUI.log. Esse arquivo pode ser usado para solução de problemas.

Veja uma demonstração do Citrix Scout.

O que é coletado

Os diagnósticos coletados pelo Scout incluem arquivos de log de rastreamento do Citrix Diagnostic Facility (CDF). Um subconjunto de rastreamentos de CDF chamado AOT (Always-On Tracing) também está incluído. As informações de AOT podem ser úteis ao solucionar problemas comuns, como registros VDA e lançamentos de aplicativos/desktops. Nenhuma outra informação de Rastreamento de Eventos para Windows (ETW) é coletada.

A coleta inclui:

  • Entradas de registro criadas pelo Citrix Virtual Apps and Desktops em HKEY_LOCAL_MACHINE\SOFTWARE\Citrix.
  • Informações do Windows Management Instrumentation (WMI) em Citrix namespace.
  • Processos que estão em execução.
  • Despejos de memória de processos Citrix que são armazenados em %PROGRAMDATA%\Citrix\CDF.
  • Informações sobre políticas Citrix, em formato CSV.
  • Informações de instalação e atualização. A coleta pode incluir o log completo do metainstalador do produto, logs MSI com falha, saída do analisador de log MSI, logs do StoreFront, registros de verificação de compatibilidade de licenciamento e resultados de testes preliminares de atualização do site.

Sobre informações de rastreamento:

  • As informações de rastreamento são compactadas à medida que são coletadas, o que reduz o uso de recursos da máquina.
  • Em cada máquina, o Citrix Telemetry Service mantém as informações de rastreamento recentes compactadas por no máximo oito dias.
  • A partir do Citrix Virtual Apps and Desktops 7 1808, os rastreamentos AOT são salvos no disco local por padrão. (Em versões anteriores, os traços eram mantidos na memória.) Caminho padrão = C:\Users\CitrixTelemetryService\AppData\Local\CitrixAOT.
  • A partir do Citrix Virtual Apps and Desktops 7 1811, os rastreamentos AOT salvos em compartilhamentos de rede são coletados com outros diagnósticos.
  • Você pode modificar o tamanho máximo (padrão = 10 MB) e a duração da fatia, usando o cmdlet Enable-CitrixTrace ou a string de registro HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Telemetry DefaultListen.
  • Os rastreamentos são anexados ao arquivo até que o arquivo atinja 10% de MaxSize.

Para obter uma lista dos datapoints que o Scout coleta, consulte Datapoints chave do Call Home.

Configuração do Scout

O Scout pode ser configurado para funcionar em VDAs Linux. Para obter mais informações sobre Linux VDA e telemetria, consulte Integração com o Citrix Telemetry Service

O Linux VDA pode alterar automaticamente a porta do soquete ctxtelemetry ou a porta do serviço de telemetria. Em caso afirmativo, você deve configurar a porta manualmente.

  1. Navegue até C:\Program Files\Citrix\Telemetry Service
  2. Abra o arquivo ScoutUI.exe.config
  3. Altere o valor de LinuxVDATelemetryServicePort ou LinuxVDATelemetryWakeupPort para o que foi configurado no Linux VDA:
  • <add key="LinuxVDATelemetryServicePort" value="7502"/>
  • <add key="LinuxVDATelemetryWakeupPort" value="7503"/>
  1. Salve as alterações e feche o arquivo.
  2. Abra o Scout novamente para garantir que ele carregue a configuração mais recente.

Sobre verificações de integridade

Os dados da verificação de integridade são armazenados em pastas em C:\ProgramData\Citrix\TelemetryService\.

Verificações de integridade do site

As verificações de integridade do site estão incluídas no Environment Test Service, que fornece uma avaliação abrangente dos serviços FlexCast Management Architecture (FMA). Além de verificar a disponibilidade do serviço, essas verificações buscam outros indicadores de integridade, como conexões de banco de dados.

As verificações de integridade do site são executadas em Controladores de entrega. Dependendo do tamanho do seu site, essas verificações podem levar até uma hora para que sejam concluídas.

Verificações de configuração do Delivery Controller

Como parte das verificações de integridade do site. As verificações de configuração do Delivery Controller verificam se os seguintes problemas existem, com base nas recomendações da Citrix para sites de Virtual Apps and Desktops:

  • Um ou mais Delivery Controllers estão apresentando falha.
  • Há apenas um Delivery Controller no site.
  • Os Delivery Controllers são de versões diferentes.

Além do respeito às permissões e requisitos de verificações de integridade, as verificações de configuração do Delivery Controller exigem:

  • Pelo menos um controlador ligado.
  • O serviço Broker em execução em um controlador.
  • Uma conexão de trabalho do controlador com o banco de dados do site.

Verificações de integridade do VDA

As verificações de integridade do VDA identificam possíveis causas para problemas comuns de registro VDA, lançamento de sessão e redirecionamento de fuso horário.

Para registro no VDA, o Scout verifica:

  • Instalação do software VDA
  • Associação ao domínio da máquina VDA
  • Disponibilidade da porta de comunicação VDA
  • Status do serviço VDA
  • Configuração de firewall do Windows
  • Comunicação com o Controller
  • Sincronização de tempo com o Controller
  • Status de registro VDA

Para o lançamento de sessões em VDAs, o Scout verifica:

  • Disponibilidade da porta de comunicação de início de sessão
  • Status dos serviços de início de sessão
  • Iniciar sessão Configuração de firewall do Windows
  • Licenças de acesso para cliente do VDA Remote Desktop Services
  • Caminho de lançamento do aplicativo VDA
  • Configurações de registro de início de sessão

Para redirecionamento de fuso horário em VDAs, o Scout verifica:

  • Instalação de hotfix do Windows
  • Instalação de hotfix da Citrix
  • Configurações da política de grupo da Microsoft
  • Configurações da política de grupo Citrix

Para Profile Management em VDAs, o Scout verifica:

  • Detecção do Hypervisor
  • Detecção do Provisioning
  • Citrix Virtual Apps and Desktops
  • Configuração pessoal do vDisk
  • Loja de usuários
  • Detecção de status do Profile Management Service
  • Teste de hooking de Winlogon.exe

Para executar verificações no Profile Management, você deve instalar e ativar o Profile Management no VDA. Para obter mais informações sobre verificações de configuração do Profile Management, consulte o artigo do Knowledge Center CTX132805.

Verificações de integridade do StoreFront

As verificações do StoreFront verificam:

  • O serviço Citrix Default Domain está em execução
  • O serviço Citrix Credential Wallet está em execução
  • Conexão do servidor StoreFront com a porta 88 do Active Directory
  • Conexão do servidor StoreFront com a porta 389 do Active Directory
  • O URL base tem um FQDN válido
  • O endereço IP correto da URL base pode ser obtido
  • O pool de aplicativos do IIS está usando .NET 4.0
  • Se o certificado está vinculado à porta SSL para o URL do host
  • Se a cadeia de certificados está completa
  • Se os certificados expiraram
  • Se um certificado está expirando em breve (dentro de 30 dias)

Verificações do servidor de licenças

Verificações do Servidor de Licenças verificam:

  • Conexão do Servidor de Licenças do Delivery Controller
  • Status do acesso remoto do firewall do Servidor de Licenças
  • Status do serviço Citrix Licensing
  • Estado do período de carência do Servidor de Licenças
  • Conexão de portas do Servidor de Licenças
  • Se o daemon do fornecedor Citrix (CITRIX) está em execução
  • Se os relógios do sistema estão sincronizados
  • Se o serviço Citrix Licensing está sendo executado na conta de serviço local
  • Presença do arquivo CITRIX.opt
  • Data de qualificação dos Customer Success Services
  • Atualização do Servidor de Licenças Citrix
  • Se o certificado do Servidor de Licenças está no armazenamento raiz confiável do Delivery Controller

Além de atender às permissões e requisitos para verificações de integridade, o servidor de licenças deve estar associado a um domínio Caso contrário, o Servidor de Licenças não será descoberto.

Execute verificações de integridade

O procedimento de verificação de integridade inclui a seleção de máquinas, iniciar a verificação e, em seguida, revisar o relatório de resultados.

  1. Inicie o Scout. No menu Iniciar da máquina, selecione Citrix > Citrix Scout. Na página de abertura, clique em Health Check.
  2. Selecionar máquinas. Clique em Find machine para descobrir máquinas. A página Select machines lista todos os VDAs, controladores de entrega e servidores de licença descobertos no site. Você pode filtrar a exibição por nome da máquina. Marque a caixa de seleção ao lado de cada máquina da qual você deseja coletar diagnósticos e clique em Continue.

    Para adicionar outros tipos de componentes (como servidores StoreFront e máquinas VDA), consulte Adicionar máquinas manualmente e Importar máquinas VDA. Você não pode adicionar manualmente Citrix Provisioning Servers ou servidores de licenças.

    O Scout inicia automaticamente testes de verificação em cada máquina selecionada, certificando-se de que ele atende aos critérios listados nos testes de verificação. Se a verificação falhar, uma mensagem será publicada na coluna Status e a caixa de seleção dessa máquina será desmarcada. Você pode:

    • Resolver o problema e marcar a caixa de seleção da máquina novamente. Isso aciona uma nova tentativa dos testes de verificação.
    • Ignorar essa máquina (deixe a caixa de seleção desmarcada). As verificações de integridade não são executadas para essa máquina.

    Quando os testes de verificação forem concluídos, clique em Continue.

  3. Execute as verificações de integridade nas máquinas selecionadas. O resumo lista as máquinas em que os testes são executados (as máquinas que você selecionou que passaram nos testes de verificação). Clique em Start Checking.

    Durante e após a verificação:

    • A coluna Status indica o estado de verificação atual de uma máquina.
    • Para interromper todas as verificações em andamento, clique em Stop Checking no canto inferior direito da página. (Você não pode cancelar a verificação de integridade de uma única máquina, apenas todas as máquinas selecionadas. As informações das máquinas que concluíram as verificações são mantidas.
    • Quando as verificações forem concluídas para todas as máquinas selecionadas, o botão Stop Checking no canto inferior direito muda para Done.
    • Se uma verificação falhar, você poderá clicar em Retry na coluna Action .
    • Se uma verificação for concluída sem problemas encontrados, a coluna Action estará vazia.
    • Se uma verificação encontrar problemas, clique em View Details para mostrar os resultados.
    • Depois que a verificação for concluída para todas as máquinas selecionadas, não clique em Back. (Se você fizer isso, os resultados da verificação serão perdidos.)
  4. Quando as verificações forem concluídas, clique em Done para retornar à página de abertura do Scout.

Resultados da verificação de integridade

Para verificações Citrix geradoras de relatórios, os relatórios contêm:

  • Hora e data em que o relatório de resultados foi gerado
  • Máquinas que foram verificadas
  • Condições que o cheque procurava nas máquinas de destino

Permissões e requisitos

Permissões:

  • Para coletar diagnósticos:

    • Você deve ser um administrador local e usuário de domínio para cada máquina da qual você está coletando diagnósticos.
    • Você deve ter permissão para gravar no diretório LocalAppData em cada máquina.
  • Para executar verificações de integridade:

    • Você deve ser membro do grupo de usuários do domínio.
    • Você deve ser um administrador com direitos completos ou ter uma função personalizada com permissões somente leitura e Run Environment Tests para o site.
    • Defina a política de execução de script como pelo menos RemoteSigned para permitir que os scripts sejam executados. Por exemplo: Set-ExecutionPolicy RemoteSigned. Nota: outros privilégios de execução de scripts também podem funcionar.
  • Use Executar como administrador ao iniciar o Scout.

Para cada máquina da qual você coleta diagnósticos ou executa verificações de integridade:

  • O Scout deve ter a capacidade de se comunicar com a máquina.
  • O compartilhamento de arquivos e impressoras deve estar ativado.
  • PSRemoting e WinRM devem estar habilitados. A máquina também deve estar executando o PowerShell 3.0 ou posterior.
  • O Citrix Telemetry Service deve estar em execução na máquina.
  • O acesso à Infraestrutura de Gerenciamento do Windows (WMI) deve estar habilitado na máquina.
  • Para definir um cronograma para coleta de diagnóstico, a máquina deve estar executando uma versão Scout compatível.

Não use o cifrão ($) em nomes de usuário especificados em nomes de caminho. Isso impede a coleta de informações diagnósticas.

O Scout executa testes de verificação nas máquinas selecionadas para garantir que esses requisitos sejam atendidos.

O serviço de telemetria para Windows é executado no Serviço de Rede.

Uso de dados de Scout 1

A pasta de rastreamento AOT é salva em C:\ProgramData\Citrix\TelemetryService\CitrixAOT.

Somente usuários no grupo Administrador, Sistema e Serviço de Telemetria SID têm permissão para acessar o registro HKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetry.

Uso de dados de Scout 2

O SID do Serviço de Telemetria permanece no grupo Usuários do Log de Desempenho após a desinstalação do Serviço de Telemetria, mas você pode removê-lo manualmente.

Uso de dados de Scout 3

Testes de verificação

Antes de iniciar uma coleta de diagnóstico ou verificação de integridade, os testes de verificação são executados automaticamente para cada máquina selecionada. Esses testes garantem que os requisitos sejam atendidos. Se um teste falhar para uma máquina, o Scout exibirá uma mensagem, com ações corretivas sugeridas.

  • Scout cannot reach this machine - Certifique-se de que:

    • A máquina está ligada.
    • A conexão de rede está funcionando corretamente. (Isso pode incluir verificar se o firewall está configurado corretamente.)
    • O compartilhamento de arquivos e impressoras está ativado. Consulte a documentação da Microsoft para obter instruções.
  • Enable PSRemoting and WinRM - Você pode ativar a comunicação remota do PowerShell e o WinRM ao mesmo tempo. Usando Executar como administrador, execute o cmdlet Enable-PSRemoting. Para obter detalhes, consulte a ajuda da Microsoft para o cmdlet.
  • Scout requires PowerShell 3.0 (minimum) - Instale o PowerShell 3.0 (ou posterior) na máquina e, em seguida, ative a comunicação remota do PowerShell.
  • Unable to access LocalAppData directory on this machine - Verifique se a conta tem permissão para gravar no diretório LocalAppData na máquina.
  • Cannot locate Citrix Telemetry Service — Verifique se o Citrix Telemetry Service está instalado e foi iniciado na máquina.
  • Cannot get schedule - Atualize a máquina para (mínimo) XenApp e XenDesktop 7.14.
  • WMI is not running on the machine - Certifique-se de que o acesso ao Windows Management Instrumentation (WMI) está habilitado.
  • WMI connections blocked - Ative o WMI no serviço Firewall do Windows.
  • Newer version of Citrix Telemetry Service required - (A versão é verificada somente para Coletar e rastrear e reproduzir.) Atualize a versão do Serviço de Telemetria na máquina (consulte Instalar e atualizar). Se você não atualizar o serviço, essa máquina não estará incluída nas ações Collect ou Trace & Reproduce .
  • Scout cannot connect to the systemd socket on this machine - Certifique-se de que:

    • A porta 7503 está aberta. Verifique se o systemd ctxtelemetry.socket está escutando na porta 7503 da máquina. A porta pode ser diferente se a porta ctxtelemetry.socket tiver sido alterada. Consulte Configuração do Scout para ajustar portas.
    • A conexão de rede está funcionando corretamente. (Isso pode incluir verificar se o firewall está configurado corretamente.)
  • The Linux VDA Telemetry Service is not started on this machine - Certifique-se de que:

    • A porta 7502 está aberta. Verifique se o Linux VDA Telemetry Service está instalado e iniciado na máquina. A porta pode ser diferente se a porta do serviço de telemetria tiver sido alterada. Consulte Configuração do Scout para ajustar portas.
    • A conexão de rede está funcionando corretamente. (Isso pode incluir verificar se o firewall está configurado corretamente.)

Compatibilidade de versão

Esta versão do Scout (3.x) destina-se a ser executada em Controllers e VDAs do Citrix Virtual Apps and Desktops (ou no mínimo XenApp e XenDesktop 7.14).

Uma versão anterior do Scout é fornecida com as versões XenApp e XenDesktop anteriores a 7.14. Para obter informações sobre essa versão anterior, consulte CTX130147.

Se você atualizar um Controlador ou VDA anterior a 7.14 para a versão 7.14 (ou uma versão com suporte posterior), a versão anterior do Scout será substituída pela versão atual.

Recurso Scout 2.23 Scout 3.0
Suporte Citrix Virtual Apps and Desktops (além de XenApp e XenDesktop 7.14 a 7.18) Sim Sim
Suporte a XenDesktop 5.x, 7.1—7.13 Sim Não
Suporte a XenApp 6.x, 7.5 a 7.13 Sim Não
Entregue com produto 7.1–7.13 Começando com 7.14
Pode ser baixado do artigo CTX Sim Não
Capturar rastreamentos CDF Sim Sim
Capturar rastreamento constante (AOT) Não Sim
Permitir coleta de dados de diagnóstico Até 10 máquinas ao mesmo tempo (por padrão) Ilimitado (sujeito à disponibilidade de recursos)
Permitir que dados de diagnóstico sejam enviados para a Citrix Sim Sim
Permitir que dados de diagnóstico sejam salvos localmente Sim Sim
Suporte às credenciais do Citrix Cloud Não Sim
Suporte a credenciais Citrix Sim Sim
Suporte ao servidor proxy para uploads Sim Sim
Ajustar agendamentos N/A Sim
Suporte a scripts Linha de comando (somente Controller local) PowerShell usando cmdlets Call Home (qualquer máquina com o Serviço de Telemetria instalado)
Verificações de integridade Não Sim

Instalar e atualizar

Por padrão, o Scout é instalado ou atualizado automaticamente como parte do Citrix Telemetry Service quando você instala ou atualiza um VDA ou um controlador.

Se você omitir o Citrix Telemetry Service ao instalar um VDA ou remover o serviço posteriormente, execute TelemetryServiceInstaller_xx.msi a partir do x64\Virtual Desktop Components ou da pasta x86\Virtual Desktop Components ou na mídia de instalação do Citrix Virtual Apps and Desktops.

Quando você seleciona a ação Collect ou Trace & Reproduce, você será notificado se uma máquina estiver executando uma versão mais antiga do Citrix Telemetry Service. A Citrix recomenda usar a versão mais recente com suporte. Se você não atualizar o Serviço de Telemetria nessa máquina, ele não será incluído nas ações Collect ou Trace & Reproduce . Para atualizar o Serviço de Telemetria, use o mesmo procedimento que instalá-lo.

Autorização de upload

Se você planeja fazer upload de coleções de diagnóstico para a Citrix, você deve ter uma conta Citrix ou Citrix Cloud. (Essas são as credenciais que você usa para acessar downloads da Citrix ou acessar o Citrix Cloud Control Center.) Depois que as credenciais da conta forem validadas, um token é emitido.

  • Se você autenticar com uma conta Citrix, o processo de emissão de tokens não estará visível. Você simplesmente insere as credenciais da sua conta. Depois que a Citrix validar as credenciais, você poderá continuar no assistente Scout.
  • Se você se autenticar com uma conta do Citrix Cloud, clique em um link para acessar o Citrix Cloud usando HTTPS com seu navegador padrão. Depois de inserir suas credenciais do Citrix Cloud, o token é exibido. Copie o token e cole-o no Scout. Em seguida, você pode continuar no assistente Scout.

O token é armazenado localmente na máquina em que você está executando o Scout. Para habilitar o uso desse token na próxima vez que você executar Collect ou Trace & Reproduce, marque a caixa de seleção Store token and skip this step in the future .

Você deve reautorizar sempre que selecionar Schedule na página de abertura do Scout. Você não pode usar um token armazenado ao criar ou alterar um agendamento.

Usar um proxy para uploads

Se você quiser usar um servidor proxy para fazer upload de coleções para o Citrix, você pode instruir o Scout a usar as configurações de proxy definidas nas Propriedades da Internet do seu navegador. Como alternativa, você pode especificar o endereço IP e o número da porta do servidor proxy.

Encontrar máquina

No caso dos procedimentos Collect, Trace & Reproduce e Schedule o Scout lista os Controladores e VDAs que ele descobre automaticamente.

Quando você executa a Verificação de integridade do Scout a partir do Delivery Controller, clique em Find machine para descobrir máquinas, incluindo controladores de entrega, VDAs, servidores de licença e servidores StoreFront.

Quando você executa a verificação de integridade do Scout a partir de uma máquina associada ao domínio que não é Delivery Controller, o Scout não consegue descobrir máquinas automaticamente. Você precisa adicionar máquinas manualmente ou importar máquinas VDA.

Adicionar máquinas manualmente

Depois que o Scout listar os Controllers e VDAs detectados, você pode adicionar manualmente outras máquinas na implantação, como servidores StoreFront, License Servers e servidores Citrix Provisioning.

Ao executar verificações de integridade:

  • Os servidores de licença Citrix no domínio são descobertos automaticamente. Você não pode adicionar Servidores de Licenças manualmente.
  • No momento, as verificações de integridade não oferecem suporte aos servidores Citrix Provisioning.

Em qualquer página do Scout que lista as máquinas descobertas, clique em + Adicionar máquina.. Digite o FQDN da máquina que você deseja adicionar e clique em Continue. Repita para adicionar outras máquinas, conforme necessário. (Embora a inserção de um alias DNS em vez de um FQDN possa parecer válida, as verificações de integridade podem falhar.)

As máquinas adicionadas manualmente sempre aparecem na parte superior da lista de máquinas, acima das máquinas descobertas.

Uma maneira fácil de identificar uma máquina adicionada manualmente é o botão de exclusão vermelho na extremidade direita da linha. Somente máquinas adicionadas manualmente têm esse botão. Máquinas descobertas não o têm.

Para remover uma máquina adicionada manualmente, clique no botão vermelho na extremidade direita da linha. Confirme a exclusão. Repita para excluir outras máquinas adicionadas manualmente.

O Scout lembra as máquinas adicionadas manualmente até que você as remova. Quando você fecha e reabre o Scout, as máquinas adicionadas manualmente ainda estão listadas na parte superior da lista.

Rastreamentos CDF não são coletados ao usar Trace & Reproduce em servidores StoreFront. No entanto, todas as outras informações de rastreamento são coletadas.

Importar máquinas VDA

Você pode importar máquinas VDA na implantação ao executar verificações de integridade.

  1. Em Delivery Controller ou Connector, gere o arquivo de lista de máquinas com o comando PowerShell. No Connector, você deve inserir credenciais Citrix e selecionar o cliente na caixa de diálogo pop-up.

    Get-BrokerMachine| foreach { $_.DnsName } | out-file C:\machineList.txt

  2. Copie o arquivo machineList.txt para a máquina associada ao domínio que você deseja iniciar a verificação de integridade do Scout.
  3. Na página Verificação de integridade do Scout, clique em Add Machine.
  4. Selecione o tipo de máquina Windows VDA .
  5. Clique em Import VDA machines.
  6. Selecione o arquivo machineList.txt.
  7. Clique em Open.

As máquinas VDA importadas estão listadas na página Scout Health Check.

Verificação de integridade do Scout

Coletar diagnósticos

O procedimento Collect inclui a seleção de máquinas, iniciar a coleção de diagnósticos e, em seguida, carregar o arquivo que contém a coleção para a Citrix ou salvá-la localmente.

  1. Inicie o Scout. No menu Iniciar da máquina, selecione Citrix > Citrix Scout. Na página de abertura, clique em Collect.

  2. Selecionar máquinas.

    • Em um Controller, a página Select machines lista todos os VDAs e Controllers Você pode filtrar a exibição por nome da máquina. Para adicionar outras máquinas manualmente (como servidores StoreFront ou Citrix Provisioning), consulte Adicionar máquinas manualmente.
    • Em outros componentes (como servidores VDA), a página Select machines lista somente a máquina local. Não há suporte para adicionar máquinas manualmente.

    Marque a caixa de seleção ao lado de cada máquina da qual você deseja coletar diagnósticos e clique em Continue.

    O Scout inicia automaticamente testes de verificação em cada máquina selecionada, verificando se ele atende aos critérios listados nos testes de verificação. Se a verificação for malsucedida, uma mensagem será publicada na coluna Status e a caixa de seleção dessa máquina não está marcada. Você pode:

    • Resolver o problema e marcar a caixa de seleção da máquina novamente. Isso aciona uma nova tentativa dos testes de verificação.
    • Ignorar essa máquina (deixe a caixa de seleção desmarcada). Os diagnósticos não serão coletados dessa máquina.

    Quando os testes de verificação forem concluídos, clique em Continue.

  3. Coletar diagnósticos. O resumo lista todas as máquinas das quais os diagnósticos são coletados (as máquinas que você selecionou que passaram nos testes de verificação). Clique em Start Collecting.

    Durante a coleta:

    • A coluna Status indica o estado atual da coleta de uma máquina.
    • Para interromper uma coleção em andamento em uma única máquina, clique em Cancel na coluna Action dessa máquina.
    • Para interromper todas as coleções em andamento, clique em Stop Collection no canto inferior direito da página. Os diagnósticos de máquinas que concluíram a coleta são mantidos. Para retomar a coleção, clique em Retry na coluna Action de cada máquina.
    • Quando a coleção for concluída para todas as máquinas selecionadas, o botão Stop Collection no canto inferior direito muda para Continue.
    • Para coletar diagnósticos novamente, clique em Collect Again na coluna Action dessa máquina. A coleta mais recente substitui a anterior.
    • Se uma coleção falhar, você poderá clicar em Retry na coluna Action . Somente coleções bem-sucedidas são carregadas ou salvas.
    • Depois que a coleta for concluída para todas as máquinas selecionadas, não clique em Back. (Se você clicar nesse botão, a coleta será perdida.)

    Quando a coleção for concluída, clique em Continue.

  4. Salve ou carregue a coleta. Escolha se deseja carregar o arquivo para o Citrix ou salve-o na máquina local.

    Se você optar por carregar o arquivo agora, vá para a Etapa 5.

    Se você optar por salvar o arquivo localmente:

    • É exibida uma caixa de diálogo Salvar do Windows. Navegue até o local desejado.
    • Quando o salvamento local for concluído, o nome do caminho do arquivo é exibido e vinculado. Você pode visualizar o arquivo. Você pode fazer upload do arquivo mais tarde para a Citrix. Consulte CTX136396.

    Clique em Done para retornar à página de abertura do Scout. Você não precisa concluir nenhuma outra etapa neste procedimento.

  5. Autentique para uploads e, opcionalmente, especifique um proxy. Para obter detalhes, consulte Autorização de upload.

    • Se você não tiver autenticado por meio do Scout, continue com esta etapa.
    • Se você tiver autenticado por meio do Scout, o token de autorização armazenado será usado por padrão. Se for isso que você deseja fazer, selecione essa opção e clique em Continue. Você não é solicitado a fornecer credenciais para essa coleção. Vá para a Etapa 6.
    • Se você tiver autenticado anteriormente, mas quiser reautorizar e obter um novo token, clique em Change/Reauthorize e continue com esta etapa.

    Escolha se você deseja usar credenciais Citrix ou credenciais do Citrix Cloud para autenticar o upload. Clique em Continue. A página de credenciais será exibida somente se você não estiver usando um token armazenado.

    Na página de credenciais:

    • Se você quiser usar um servidor proxy para o upload do arquivo, clique em Configure proxy. Você pode instruir o Scout a usar as configurações de proxy definidas nas propriedades da Internet do seu navegador. Ou você pode inserir o endereço IP e o número da porta do servidor proxy. Feche a caixa de diálogo de proxy.
    • Para uma conta do Citrix Cloud, clique em Generate token. Seu navegador padrão é iniciado em uma página do Citrix Cloud na qual um token é exibido. Copie o token e cole-o na página Scout.
    • Para uma conta Citrix, insira suas credenciais.

    Quando terminar, clique em Continue.

  6. Insira informações sobre o upload.

    • O campo ‘name’ contém o nome padrão do arquivo para o diagnóstico coletado. Isso é suficiente para a maioria das coletas, embora você possa alterar o nome. (Se você excluir o nome padrão e deixar o campo nome vazio, o nome padrão será usado.)
    • Opcionalmente, especifique um número de caso do Citrix Support de 8 dígitos.
    • No campo opcional Description, descreva o problema e indique quando o problema ocorreu, se aplicável.

    Quando terminar, clique em Start Upload.

    Durante o upload, a parte inferior esquerda da página fornece um valor aproximado da porcentagem do upload que foi concluída. Para cancelar um upload em andamento, clique em Stop Upload.

    Quando o upload for concluído, a URL de sua localização é exibida e vinculada. Você pode seguir o link para o local Citrix para visualizar a análise do upload ou copiar o link.

    Clique em Done para retornar à página de abertura do Scout.

Rastrear e reproduzir

O procedimento Trace and Reproduce inclui a seleção de máquinas, iniciar um rastreamento, reproduzir problemas, concluir a coleção de diagnósticos e, em seguida, carregar o arquivo para o Citrix ou salvá-lo localmente.

Este procedimento é semelhante ao procedimento Collect padrão. No entanto, ele permite que você inicie um rastreamento em máquinas e recrie problemas nessas máquinas. Todas as coleções de diagnósticos incluem informações de rastreamento AOT. Este procedimento adiciona rastreamentos de CDF para ajudar na solução de problemas.

  1. Inicie o Scout. No menu Iniciar da máquina, selecione Citrix > Citrix Scout. Na página de abertura, clique em Trace & Reproduce.

  2. Selecionar máquinas. A página Select machines lista todos os VDAs e Controladores no site. Você pode filtrar a exibição por nome da máquina. Marque a caixa de seleção ao lado de cada máquina da qual você deseja coletar rastros e diagnósticos. Depois clique em Continuar.

    Para adicionar outras máquinas manualmente (como servidores StoreFront ou Citrix Provisioning), consulte Adicionar máquinas manualmente.

    O Scout inicia automaticamente testes de verificação em cada máquina selecionada, certificando-se de que ele atende aos critérios listados nos testes de verificação. Se a verificação falhar para uma máquina, uma mensagem será publicada na coluna Status e a caixa de seleção dessa máquina não estará marcada. Você pode:

    • Resolver o problema e marcar a caixa de seleção da máquina novamente. Isso aciona uma nova tentativa dos testes de verificação.
    • Ignorar essa máquina (deixe a caixa de seleção desmarcada). Diagnósticos e traços não são coletados dessa máquina.

    Quando os testes de verificação forem concluídos, clique em Continue.

  3. Inicie o traço. O resumo lista todas as máquinas das quais os traços são coletados. Clique em Iniciar rastreamento.

    Em uma ou mais das máquinas selecionadas, reproduza os problemas que você enfrentou. A coleção de rastreamento continua enquanto você está fazendo isso. Quando terminar de reproduzir o problema, clique em Continue no Scout. Isso interrompe o rastreamento.

    Depois de interromper o rastreamento, indique se você reproduziu o problema durante o rastreamento.

  4. Colete diagnósticos de máquinas. Clique em Start Collecting. Durante a coleta:

    • A coluna Status indica o estado atual da coleta de uma máquina.
    • Para interromper uma coleção em andamento em uma única máquina, clique em Cancel na coluna Action dessa máquina.
    • Para interromper todas as coleções em andamento, clique em Stop Collection no canto inferior direito da página. Os diagnósticos de máquinas que concluíram a coleta são mantidos. Para retomar a coleção, clique em Retry na coluna Action de cada máquina.
    • Quando a coleção for concluída para todas as máquinas selecionadas, o botão Stop Collection no canto inferior direito muda para Continue.
    • Para coletar diagnósticos novamente de uma máquina, clique em Collect Again na coluna Action dessa máquina. A coleta mais recente substitui a anterior.
    • Se uma coleção falhar, você poderá clicar em Retry na coluna Action . Somente coleções bem-sucedidas são carregadas ou salvas.
    • Depois que a coleta for concluída para todas as máquinas selecionadas, não clique em Back. (Se você fizer isso, a coleção será perdida.)

    Quando a coleção for concluída, clique em Continue.

  5. Salve ou carregue a coleta. Escolha se deseja carregar o arquivo para o Citrix ou salvá-lo localmente.

    Se você optar por carregar o arquivo agora, continue com a Etapa 6.

    Se você optar por salvar o arquivo localmente:

    • É exibida uma caixa de diálogo Salvar do Windows. Selecione o local desejado.
    • Quando o salvamento local for concluído, o nome do caminho do arquivo é exibido e vinculado. Você pode visualizar o arquivo. Lembre-se: Você pode fazer upload do arquivo mais tarde da Citrix; consulte CTX136396 com relação a Citrix Insight Services.

    Clique em Done para retornar à página de abertura do Scout. Você não precisa concluir nenhuma outra etapa neste procedimento.

  6. Autenticar para uploads e, opcionalmente, especificar proxy. Veja a autorização de Upload para obter detalhes desse processo.

    • Se você não tiver autenticado por meio do Scout, continue com esta etapa.
    • Se você for autenticado por meio do Scout, o token de autorização armazenado será usado por padrão. Se isso for o que você deseja fazer, escolha essa opção e clique em Continue. Você não é solicitado a fornecer credenciais para essa coleção. Vá para a Etapa 7.
    • Se você tiver sido autenticado anteriormente, mas quiser reautorizar e obter um novo token, clique em Change/Reauthorize e continue com esta etapa.

    Escolha se você deseja usar credenciais Citrix ou credenciais do Citrix Cloud para autenticar o upload. Clique em Continue. A página de credenciais será exibida somente se você não estiver usando um token armazenado.

    Na página de credenciais:

    • Se você quiser usar um servidor proxy para o upload do arquivo, clique em Configure proxy. Você pode instruir o Scout a usar as configurações de proxy definidas nas Propriedades da Internet do seu navegador. Ou você pode inserir o endereço IP e o número da porta do servidor proxy. Feche a caixa de diálogo de proxy.
    • Para uma conta do Citrix Cloud, clique em Generate token. Seu navegador padrão é iniciado para uma página do Citrix Cloud na qual um token é exibido. Copie o token e cole-o na página Scout.
    • Para uma conta Citrix, insira suas credenciais.

    Quando terminar, clique em Continue.

  7. Forneça informações sobre o upload.

    Insira os detalhes do upload:

    • O campo ‘name’ contém o nome padrão do arquivo para o diagnóstico coletado. Isso é suficiente para a maioria das coletas, embora você possa alterar o nome. (Se você excluir o nome padrão e deixar o campo nome vazio, o nome padrão será usado.)
    • Opcionalmente, especifique um número de caso do Citrix Support de 8 dígitos.
    • No campo opcional Description, descreva o problema e indique quando o problema ocorreu, se aplicável.

    Quando terminar, clique em Start Upload.

    Durante o upload, a parte inferior esquerda da página fornece um valor aproximado da porcentagem do upload que foi concluída. Para cancelar um upload em andamento, clique em Stop Upload.

    Quando o upload for concluído, a URL de sua localização é exibida e vinculada. Você pode seguir o link para o local Citrix para visualizar a análise do upload ou copiar o link.

    Clique em Done para retornar à página de abertura do Scout.

Habilitar coleta de logs adicionais

A função Enable additional log collection permite que você use a função trace e reproduza a função com mais ferramentas, como perfmon, Netsh, DebugView e Wireshark.

Nota:

Isso só se aplica a máquinas locais.

Para configurar a coleta de logs adicionais:

  1. Inicie o Citrix Scout.
  2. Clique na engrenagem de Settings.
  3. Clique em Enable additional log collection with more tools.
  4. Clique em Save.

Para coletar logs adicionais:

  1. Na página inicial do Scout, clique em Trace & Reproduce.
  2. Na página Select machines, clique na engrenagem no lado direito da máquina local.
  3. Na página Select the tools require for logging:, clique em Download Tools.
  4. Na página Download Tools, selecione as ferramentas que deseja usar e clique em Download. As ferramentas são baixadas, exceto o Wireshark. O Wireshark só pode ser baixado e instalado manualmente. Nota: se optar por baixar outras ferramentas manualmente, você deve extrair o conteúdo do arquivo .zip baixado para C:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\<toolname>. Por exemplo, se você baixar o arquivo DebugView.zip, descompacte o conteúdo do arquivo em C:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\DebugView\.
  5. Na página Select the tools require for logging:, clique em Refresh Status. Todas as ferramentas selecionadas aparecem como Present na coluna Status.
  6. Selecione as ferramentas para registro e clique em Next.
  7. Siga as instruções em Rastrear e reproduzir.
  8. Após a conclusão, verifique os logs no arquivo zip. Os logs são compactados na pasta CDCLogs.

Nota:

Se a ferramenta Procmon for selecionada para o rastreamento, os logs de Process Monitor poderão crescer rapidamente. Certifique-se de selecionar apenas as ferramentas que são necessárias. Você também pode monitorar o tamanho dos logs em %temp%\Scout-CDC-Log.

Agendar coletas

Nota:

No momento, você pode agendar coletas, mas não verificações de integridade.

O procedimento Schedule compreende a seleção de máquinas e, em seguida, definir ou cancelar a programação. As coletas agendadas são carregadas automaticamente para o Citrix. (Você pode salvar coleções agendadas localmente usando a interface do PowerShell. Consulte Citrix Call Home.)

  1. Inicie o Scout. No menu Iniciar da máquina, selecione Citrix > Citrix Scout. Na página de abertura, clique em Schedule.

  2. Selecionar máquinas. Todos os VDAs e Controllers no site estão listados. Você pode filtrar a exibição por nome da máquina.

    Quando você instalou VDAs e Controllers usando a interface gráfica, se você definir um agendamento do Call Home (consulte Citrix Call Home), o Scout exibirá essas configurações, por padrão. Você pode usar esta versão do Scout para iniciar coleções agendadas pela primeira vez ou alterar uma programação configurada anteriormente.

    Embora você tenha habilitado/desativado o Call Home para cada máquina separadamente durante a instalação do componente, um agendamento configurado no Scout afeta todas as máquinas selecionadas.

    Marque a caixa de seleção ao lado de cada máquina da qual você deseja coletar diagnósticos e clique em Continue.

    Para adicionar outras máquinas manualmente (como servidores StoreFront ou Citrix Provisioning), consulte Adicionar máquinas manualmente.

    O Scout inicia automaticamente testes de verificação nas máquinas selecionadas, verificando se ele atende aos critérios nos testes de verificação. Se a verificação falhar para uma máquina, uma mensagem será publicada na coluna Status e a caixa de seleção dessa máquina não estará marcada. Você pode:

    • Resolver o problema e marcar a caixa de seleção da máquina novamente. Isso aciona uma nova tentativa dos testes de verificação.
    • Ignorar essa máquina (deixe a caixa de seleção desmarcada). Diagnósticos (ou rastreamentos) não são coletados dessa máquina.

    Quando os testes de verificação forem concluídos, clique em Continue.

    A página de resumo lista as máquinas às quais os agendamentos são aplicados. Clique em Continue.

  3. Defina o agendamento. Indique quando você deseja que o diagnóstico seja coletado. Lembre-se: A programação afeta todas as máquinas selecionadas.

    • Para configurar uma programação semanal para as máquinas selecionadas, clique em Weekly. Escolha o dia da semana. Insira a hora do dia (relógio de 24 horas) para que a coleta comece.
    • Para configurar uma programação diária para as máquinas selecionadas, clique em Daily. Insira a hora do dia (relógio de 24 horas) para que a coleta comece.
    • Para cancelar uma programação existente para as máquinas selecionadas (e não substituí-la por outra), clique em Off. Isso cancela qualquer agendamento configurado anteriormente para essas máquinas.

    Clique em Continue.

  4. Autentique para uploads e, opcionalmente, especifique um proxy. Veja a autorização de Upload para obter detalhes desse processo. Lembre-se: Você não pode usar um token armazenado para autenticar ao trabalhar com um agendamento do Scout.

    Escolha se você deseja usar credenciais Citrix ou credenciais do Citrix Cloud para autenticar o upload. Clique em Continue.

    Na página de credenciais:

    • Se você quiser usar um servidor proxy para o upload do arquivo, clique em Configure proxy. Você pode instruir o Scout a usar as configurações de proxy definidas nas Propriedades da Internet do seu navegador. Ou você pode inserir o endereço IP e o número da porta do servidor proxy. Feche a caixa de diálogo de proxy.
    • Para uma conta do Citrix Cloud, clique em Generate token. Seu navegador padrão é iniciado em uma página do Citrix Cloud na qual um token é exibido. Copie o token e cole-o na página Scout.
    • Para uma conta Citrix, insira suas credenciais.

    Quando terminar, clique em Continue.

    Revise o cronograma configurado. Clique em Done para retornar à página de abertura do Scout.

    Durante uma coleta, o log de aplicativos do Windows de cada máquina selecionada contém entradas sobre a coleta e o upload.

Mascaramento de dados

As informações de diagnóstico coletadas usando o Citrix Scout podem conter informações sigilosas quanto à segurança. O recurso de mascaramento de dados Citrix Scout permite mascarar dados confidenciais em arquivos de diagnóstico antes de enviá-los para a Citrix.

O mascaramento de dados do Scout é configurado para mascarar o endereço IP, nomes de máquina, nomes de domínio, nomes de usuário, nomes de hipervisor, nomes de grupo de entrega, nomes de catálogo, nomes de aplicativos e SIDs.

Nota:

Os rastreamentos CDF são criptografados e não podem ser mascarados.

Os logs Linux VDA são compactados para o formato .tar.gz2 e não podem ser mascarados.

Colete novos diagnósticos e execute o mascaramento de dados

Para usar o recurso de mascaramento de dados do Citrix Scout, inicie o Scout a partir da linha de comando.

  1. No Windows, abra o prompt de comando como administrador.
  2. Vá para o diretório em que o Scout está instalado: cd C:\Program Files\Citrix\Telemetry Service.
  3. Lançamento Scout: ScoutUI.exe datamasking.
  4. Clique em Collect ou Trace & Reproduce para coletar diagnósticos.
  5. Após a conclusão da coleta, selecione Enable data masking. Essa opção está ativada por padrão.
  6. Configure a máscara de dados. Você pode usar as regras padrão ou personalizar as regras.
  7. Selecione se deseja carregar ou salvar a coleta de diagnósticos.
    • Se você selecionar Upload the diagnostics collection to Citrix, os arquivos de diagnóstico mascarados serão carregados para a Citrix.
    • Se você selecionar Save the diagnostics collection on your local machine, tanto o diagnóstico original quanto o mascarado serão salvos no local especificado.

Execute o mascaramento de dados em diagnósticos existentes

  1. No Windows, abra o prompt de comando como administrador.
  2. Vá para o diretório em que o Scout está instalado: cd C:\Program Files\Citrix\Telemetry Service.
  3. Inicie o Scout diretamente no modo de mascaramento de dados: ScoutUI.exe datamasking filePath.
  4. Selecione “Enable data masking” para continuar. Essa opção está ativada por padrão.
  5. Configure a máscara de dados. Você pode executar o mascaramento de dados com as regras padrão ou personalizar as regras.
  6. Selecione se deseja carregar ou salvar a coleta de diagnósticos.
    • Se você selecionar Upload the diagnostics collection to Citrix, os arquivos de diagnóstico mascarados serão carregados para a Citrix.
    • Se você selecionar Save the diagnostics collection on your local machine, tanto o diagnóstico original quanto o mascarado serão salvos no local especificado.

Masked data file and mapping file locations

Depois de carregar ou salvar a coleção de diagnósticos, clique no link para abrir os diagnósticos original e mascarado e abra o arquivo de informações de mapeamento.

Coleta de dados de uso

Quando você usa o Scout, a Citrix usa o Google Analytics para coletar dados de uso anônimos que serão usados para futuros recursos e melhorias do produto. A coleta de dados está ativada por padrão.

Para alterar a coleta e o upload de dados de uso, clique na engrenagem Settings na interface do usuário do Scout. Você pode escolher se deseja enviar as informações selecionando Yes ou No e, em seguida, clicando em Save.

Coleta de dados de uso do Scout