Citrix Scout
Introdução
O Citrix Scout coleta diagnósticos e executa verificações de saúde. 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 coleções de diagnósticos por meio do Citrix Insight Services. Você também pode usar o Scout para solucionar problemas, sozinho ou com a orientação do Citrix Support.
Você pode fazer upload de arquivos de coleção para a Citrix para análise e orientação do Citrix Support. Ou você pode salvar uma coleção localmente para sua própria análise e, posteriormente, fazer o upload do arquivo de coleta para a Citrix para análise.
O Scout oferece os seguintes procedimentos:
- Collect: Executa uma coleta única de diagnósticos nas máquinas que você seleciona em um site. Em seguida, você pode fazer o upload do arquivo para a Citrix ou salvá-lo localmente.
- Rastrear & Reproduzir: Inicia um rastreamento manual nas máquinas que você selecionar. Em seguida, você recria problemas nessas máquinas. Depois de recriar o problema, o rastreamento é interrompido. O Scout então coleta outros diagnósticos e carrega o arquivo para a Citrix ou salva o arquivo localmente.
- Cronograma: Agenda as coletas de diagnóstico para que ocorram diariamente ou semanalmente em um horário especificado nas máquinas que você selecionar. O arquivo é enviado automaticamente para a Citrix.
- Verificação de integridade: Executa verificações que medem a integridade e a disponibilidade do site e de seus componentes. Você pode executar verificações de integridade para Delivery Controllers, Virtual Delivery Agents (VDAs), servidores StoreFront e servidores de licenças Citrix. Se forem encontrados problemas durante as verificações, o Scout fornece um relatório detalhado. Cada vez que o Scout inicia, ele verifica se há scripts de verificação de saúde atualizados. Se novas versões estiverem disponíveis, o Scout as baixa automaticamente, para uso na próxima vez que as verificações de saúde forem executadas.
Nota:
Os procedimentos Trace & Reproduce, Schedulee Health Check atualmente não estão disponíveis para Linux VDA.
A interface gráfica descrita neste artigo é a principal forma de usar o Scout. Como alternativa, você pode usar o PowerShell para configurar coletas e uploads de diagnóstico únicos ou programados. Veja Call Home.
Onde dirigir 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ças. 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 (antigo serviço Citrix Virtual Apps and Desktops), execute o Scout a partir de um VDA para coletar diagnósticos locais.
O log do aplicativo Scout está armazenado em C:\ProgramData\Citrix\TElemetryService\ ScoutUI.log. Esse arquivo pode ser usado para solucionar problemas.
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 Rastreamento Always-on (AOT) também está incluído. As informações do AOT podem ser úteis na solução de problemas comuns, como registros de VDA e lançamentos de aplicativos/desktops. Nenhuma outra informação do Event Tracing for Windows (ETW) é coletada.
A coleção inclui:
- Entradas de registro criadas pelo Citrix Virtual Apps and Desktops em
HKEY_LOCAL_MACHINE\ SOFTWARE\ Citrix. - Informações sobre a Instrumentação de Gerenciamento do Windows (WMI) sob o namespace Citrix.
- Processos em execução.
- Crash dumps de processos Citrix que estão armazenados em %PROGRAMDATA%\ Citrix\ CDF.
- Informações sobre a política da Citrix, em formato CSV.
- Informações de instalação e atualização. A coleção pode incluir o registro completo do metainstalador do produto, registros MSI com falha, saída do analisador de registros MSI, registros 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, mantendo uma pequena pegada na 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.
- Começando com o Citrix Virtual Apps and Desktops 7 1808, os traços AOT são salvos no disco local por padrão. (Nas versões anteriores, os traços eram mantidos na memória.) Caminho padrão =
C:\Users\CitrixTelemetryService\AppData\Local\CitrixAOT. - Começando com o Citrix Virtual Apps and Desktops 7 1811, os traços 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-CitrixTraceou a string de registroHKEY_LOCAL_MACHINE\ SOFTWARE\ Citrix\Telemetry DefaultListen. - Os traços são anexados ao arquivo até que ele atinja 10% de
maxSize.
Para obter uma lista dos pontos de dados que o Scout coleta, consulte Call Home key datapoints.
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 Integrar com o Citrix Telemetry Service
O Linux VDA pode alterar automaticamente a porta de soquete ctxtelemetry ou a porta do serviço de telemetria. Nesse caso, você deve configurar a porta manualmente.
- Navegue até C:\Program Files\ Citrix\Telemetry Service
- Abra o arquivo ScoutUI.exe.config.
- 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"/>
- Salve as alterações e feche o arquivo.
- Abra o Scout novamente para garantir que ele carregue a configuração mais recente.
Sobre os exames de saúde
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 da 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 nos Delivery Controllers. Dependendo do tamanho do seu site, essas verificações podem levar até uma hora para serem concluídas.
Verificações de configuração do controlador de entrega
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 aplicativos e desktops virtuais:
- Um ou mais Delivery Controllers estão em um estado de falha.
- Há apenas um controlador de entrega no site.
- Os Delivery Controllers são de versões diferentes.
Além de atender às permissões e requisitos para verificações de saúde, as verificações de configuração do Delivery Controller exigem:
- Pelo menos um controlador está ligado.
- O Broker Service em execução em um controlador.
- Uma conexão ativa do Controller 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, lançamento de sessão e redirecionamento de fuso horário do VDA.
Para se registrar 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 do firewall do Windows
- Comunicação com o controlador
- Sincronização de horário com o controlador
- Status de registro do VDA
Para lançamentos de sessões em VDAs, o Scout verifica:
- Disponibilidade da porta de comunicação de lançamento da sessão
- Status dos serviços de lançamento da sessão
- Inicialização da sessão: configuração do firewall do Windows
- Licenças de acesso para clientes do VDA Remote Desktop Services
- Caminho de lançamento do aplicativo VDA
- Configurações do registro de inicialização da sessão
Para redirecionamento de fuso horário em VDAs, o Scout verifica:
- Instalação de hotfix do Windows
- Instalação do hotfix Citrix
- Configurações de política de grupo da Microsoft
- Configurações de política de grupo Citrix
Para gerenciamento de perfis em VDAs, o Scout verifica:
- Detecção de hipervisor
- Detecção de provisionamento
- Aplicativos e desktops virtuais Citrix
- Configuração pessoal do vDisk
- Loja de usuários
- Detecção do status do Profile Management Service
- Teste de conexão Winlogon.exe
Para executar verificações no Profile Management, você deve instalar e habilitar o Profile Management no VDA. Para obter mais informações sobre as verificações de configuração do Profile Management, consulte o artigo CTX132805do Knowledge Center.
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 à porta 88 do Active Directory
- Conexão do servidor StoreFront à porta 389 do Active Directory
- O URL base tem um FQDN válido
- O endereço IP correto do URL base pode ser recuperado
- O pool de aplicativos do IIS está usando o.NET 4.0
- Se o certificado está vinculado à porta SSL do URL do host
- Se a cadeia de certificados está completa
- Se os certificados expiraram
- Se um certificado expirará em breve (dentro de 30 dias)
Verificações do servidor de licenças
As verificações do servidor de licenças verificam:
- Conexão ao servidor de licenças a partir do Delivery Controller
- Status de acesso remoto do firewall do License Server
- Status do serviço de licenciamento Citrix
- 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 de licenciamento Citrix está sendo executado sob a conta do serviço local
- Presença do arquivo
Citrix.opt - Data de elegibilidade do Customer Success Services
- Atualização do Citrix License Server
- Se o certificado do Servidor de Licenças está no repositório raiz confiável do Delivery Controller
Além de atender às permissões e requisitos para verificações de saúde, 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 saúde
O procedimento de verificação de integridade compreende selecionar máquinas, iniciar a verificação e, em seguida, revisar o relatório de resultados.
- Lance o Scout. No menu Start da máquina, selecione Citrix > Citrix Scout. Na página de abertura, clique em Health Check.
-
Selecione máquinas. Clique em Encontre a máquina para descobrir as máquinas. A página Select machines lista todos os VDAs, Delivery Controllers e License Servers descobertos no site. Você pode filtrar a exibição pelo 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 Continuar.
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 License Servers.
O Scout inicia automaticamente os testes de verificação em cada máquina selecionada, certificando-se de que ela atenda aos critérios listados em Testes de verificação. Se a verificação falhar, uma mensagem será publicada na coluna Status e a caixa de seleção da máquina será desmarcada. Você também pode:
- Resolva o problema e marque a caixa de seleção da máquina novamente. Isso aciona uma nova tentativa dos testes de verificação.
- Ignore essa máquina (deixe a caixa de seleção desmarcada). As verificações de integridade não são executadas nessa máquina.
Quando os testes de verificação forem concluídos, clique em Continuar.
-
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 Comece a verificar.
Durante e após a verificação:
- A coluna Status indica o estado atual de verificação de uma máquina.
- Para interromper todas as verificações em andamento, clique em Parar de verificar no canto inferior direito da página. (Você não pode cancelar a verificação de integridade de uma única máquina, somente 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 em todas as máquinas selecionadas, o botão Stop Checking no canto inferior direito muda para Done.
- Se uma verificação falhar, você pode clicar em Retry na coluna Action .
- Se uma verificação for concluída sem nenhum problema encontrado, a coluna Action estará vazia.
- Se uma verificação encontrar problemas, clique em Exibir detalhes 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.)
- Quando as verificações forem concluídas, clique em Concluído para retornar à página de abertura do Scout.
Resultados da verificação de saúde
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 a verificação procurou nas máquinas de destino
Permissões e requisitos
Permissões:
-
Para coletar diagnósticos:
- Você deve ser administrador local e usuário de domínio para cada máquina da qual está coletando diagnósticos.
- Você deve ter permissão para gravar no diretório localAppData em cada máquina.
-
Para executar verificações de saúde:
- Você deve ser membro do grupo de usuários do domínio.
- Você deve ser administrador completo 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 scripts como pelo menos
RemoteSignedpara 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 ser capaz de se comunicar com a máquina.
- O compartilhamento de arquivos e impressoras deve estar ativado.
- O PSRemoting e o 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 a coleta de diagnóstico, a máquina deve estar executando uma versão</a>do Scout compatível com
.</li> </ul>
Não use o cifrão ($) em nomes de usuário especificados em nomes de caminhos. Isso impede a coleta de informações de diagnóstico.
O Scout executa testes de verificação nas máquinas que você seleciona, para garantir que esses requisitos sejam atendidos.
O Serviço de Telemetria para Windows é executado no Serviço de Rede.
A pasta AOT Trace é salva em C:\ProgramData\Citrix\TElemetryService\ CitrixAOT.
Somente usuários do SID do grupo Administrador, Sistema e Serviço de Telemetria têm permissão para acessar o registro HKEYLOCALMACHINE:SOFTWARE\ Citrix\Telemetry .
O SID do Serviço de Telemetria permanece no grupo Usuários do Registro de Desempenho após a desinstalação do Serviço de Telemetria, mas você pode removê-lo manualmente.
Testes de verificação
Antes do início de 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 sugestões de ações corretivas.
-
O Scout não consegue alcançar esta máquina - Certifique-se de que:
- A máquina está ligada.
- A conexão de rede está funcionando corretamente. (Isso pode incluir a verificação de que seu firewall está configurado corretamente.)
- O compartilhamento de arquivos e impressoras está ativado. Consulte a documentação da Microsoft para obter instruções.
-
Habilitar PSRemoting e WinRM - Você pode habilitar 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. - O Scout requer o PowerShell 3.0 (mínimo) - Instale o PowerShell 3.0 (ou posterior) na máquina e ative a comunicação remota do PowerShell.
- Não é possível acessar o diretório LocalAppData nesta máquina - Certifique-se de que a conta tenha permissão para gravar no diretório LocalAppData na máquina.
- Não é possível localizar o Citrix Telemetry Service - Certifique-se de que o Citrix Telemetry Service esteja instalado e iniciado na máquina.
- Não é possível obter o cronograma - Atualize a máquina para (no mínimo) o XenApp e o XenDesktop 7.14.
- O WMI não está sendo executado na máquina - Certifique-se de que o acesso à Instrumentação de Gerenciamento do Windows (WMI) esteja ativado.
- Conexões WMI bloqueadas - Ative o WMI no serviço Firewall do Windows.
- É necessária uma versão mais recente do Citrix Telemetry Service - (A versão é verificada somente para Collect and Trace & Reproduce.) 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 será incluída nas ações Collect ou Trace & Reproduce .
-
O Scout não pode se conectar ao soquete systemd nesta máquina - 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 as portas.
- A conexão de rede está funcionando corretamente. (Isso pode incluir a verificação de que seu firewall está configurado corretamente.)
-
O serviço de telemetria Linux VDA não foi iniciado nesta máquina - Certifique-se de que:
- A porta 7502 está aberta. Verifique se o Serviço de Telemetria Linux VDA 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 as portas.
- A conexão de rede está funcionando corretamente. (Isso pode incluir a verificação de que seu firewall está configurado corretamente.)
Compatibilidade de versões
Esta versão do Scout (3.x) deve ser executada em controladores e VDAs do Citrix Virtual Apps and Desktops (ou, no mínimo, XenApp e XenDesktop 7.14).
| Característica | Scout 2.23 | Escoteiro 3.0 | |
|---|---|---|---|
| Ofereça suporte a aplicativos e desktops virtuais Citrix (além de XenApp e XenDesktop 7.14 a 7.18) | sim | sim | |
| Suporte ao XenDesktop 5.x, 7.1—7.13 | sim | Não | |
| Suporta XenApp 6.x, 7.5 a 7.13 | sim | Não | |
| Fornecido com o produto | 7,1—7,13 | Começando com 7.14 | |
| Pode ser baixado do artigo CTX | sim | Não | |
| Capture traços de CDF | sim | sim | |
| Capture sempre rastreáveis (AOT) | Não | sim | |
| Permitir a 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 à Citrix | sim | sim | |
| Permitir que os dados de diagnóstico sejam salvos localmente | sim | sim | |
| Ofereça suporte às credenciais do Citrix Cloud | Não | sim | |
| Ofereça suporte às credenciais da Citrix | sim | sim | |
| Servidor proxy de suporte para uploads | sim | sim | |
| Ajustar horários | N/A | sim | |
| Suporte a scripts | Linha de comando (somente controlador local) | PowerShell usando cmdlets Call Home (qualquer máquina com o Serviço de Telemetria instalado) | |
| Exames de saúde | Não | sim | |
| Mascaramento de dados | Não | Começando com 3.17 |
Instale e atualize
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 na pasta x64\ Virtual Desktop Components ou x86\ Virtual Desktop Components na mídia de instalação do Citrix Virtual Apps and Desktops.
Quando você seleciona a ação Collect ou Trace & Reproduce , você é 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 compatível. 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 de instalação.
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 os downloads da Citrix ou acessar o Citrix Cloud Control Center.) Depois que as credenciais da sua conta forem validadas, um token será emitido.
Se você se autenticar com uma conta Citrix ou uma conta 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. Você pode então continuar no assistente do Scout.
O token é armazenado localmente na máquina em que você está executando o Scout. Para ativar o uso desse token na próxima vez que você executar Collect ou Trace & Reproduce, selecione o token Store e ignore essa etapa na caixa de seleção no futuro.
Você deve reautorizar toda vez que selecionar Schedule na página de abertura do Scout. Você não pode usar um token armazenado ao criar ou alterar uma programação.
Use um proxy para envios
Se quiser usar um servidor proxy para fazer upload de coleções para a Citrix, você pode instruir o Scout a usar as configurações de proxy definidas para as propriedades da Internet do seu navegador. Como alternativa, você pode especificar o endereço IP e o número da porta do servidor proxy.
Encontre a máquina
Para os procedimentos Collect, Trace & Reproducee Schedule , o Scout lista os controladores e VDAs que ele descobre automaticamente.
Ao executar o Scout Health Check no Delivery Controller, clique em Find machine para descobrir máquinas, incluindo controladores de entrega, VDAs, servidores de licenças e servidores StoreFront.
Quando você executa o Scout Health Check a partir de uma máquina associada ao domínio que não é 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 controladores e VDAs que ele descobre, você pode adicionar manualmente outras máquinas na implantação, como servidores StoreFront, servidores de licenças e servidores Citrix Provisioning.
Ao executar as verificações de saúde :
- Os servidores de licenças Citrix no domínio são descobertos automaticamente. Você não pode adicionar servidores de licenças manualmente.
- Atualmente, as verificações de saúde não oferecem suporte aos servidores Citrix Provisioning.
Em qualquer página do Scout que liste as máquinas descobertas, clique em + Adicionar máquina. Digite o FQDN da máquina que você deseja adicionar e clique em Continuar. Repita para adicionar outras máquinas, conforme necessário. (Embora a inserção de um alias de DNS em vez de um FQDN possa parecer válida, as verificações de integridade podem falhar.)
As máquinas adicionadas manualmente sempre aparecem no topo da lista de máquinas, acima das máquinas descobertas.
Uma maneira fácil de identificar uma máquina adicionada manualmente é o botão vermelho de exclusão na extremidade direita da linha. Somente máquinas adicionadas manualmente têm esse botão. As máquinas descobertas não.
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 se lembra das 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 no topo da lista.
Os traços de CDF não são coletados ao usar Trace & Reproduce nos 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 as verificações de saúde .
- No Delivery Controller ou Connector, gere o arquivo da lista de máquinas com o comando PowerShell. No Connector, você deve inserir as credenciais da Citrix e selecionar o cliente na caixa de diálogo pop-up.
Get-BrokerMachine| foreach { $_.DnsName } | out-file C:\machineList.txt
-
Copie o arquivo machineList.txt para a máquina associada ao domínio em que você deseja iniciar o Scout Health Check.
- Na página Scout Health Check, clique em Add Machine.
- Selecione o tipo de máquina Windows VDA .
- Clique em Importar máquinas VDA.
- Selecione o arquivo machineList.txt.
- Clique em Abrir.
As máquinas VDA importadas estão listadas na página Scout Health Check.
Colete diagnósticos
O procedimento Collect compreende selecionar máquinas, iniciar a coleta de diagnósticos e, em seguida, fazer o upload do arquivo contendo a coleção para a Citrix ou salvá-lo localmente.
-
Lance o Scout. No menu Start da máquina, selecione Citrix > Citrix Scout. Na página de abertura, clique em Collect.
-
Selecione máquinas.
- Em um controlador, a página Select machines lista todos os VDAs e controladores no site. Você pode filtrar a exibição pelo 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. A adição manual de máquinas não é suportada.
Marque a caixa de seleção ao lado de cada máquina da qual você deseja coletar diagnósticos e clique em Continuar.
O Scout inicia automaticamente os testes de verificação em cada máquina selecionada, garantindo que ela atenda aos critérios listados em Testes de verificação. Se a verificação falhar, uma mensagem será publicada na coluna Status e a caixa de seleção da máquina não será marcada. Você também pode:
-
Resolva o problema e marque a caixa de seleção da máquina novamente. Isso aciona uma nova tentativa dos testes de verificação.
-
Ignore 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 Continuar.
-
Colete 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 Comece a coletar.
Durante a coleta:
- A coluna **Status** indica o estado atual da coleta de uma máquina.
- Para interromper uma coleta em andamento em uma única máquina, clique em **Cancelar** na coluna **Ação** dessa máquina.
- Para interromper todas as coleções em andamento, clique em **Parar coleção** no canto inferior direito da página. Os diagnósticos das máquinas que concluíram a coleta são mantidos. Para retomar a coleta, clique em **Retry** na coluna **Action** para cada máquina.
- Quando a coleta 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 coleção mais recente substitui a anterior.
- Se uma coleta falhar, você pode 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 nela, a coleção será perdida.)
Quando a coleção for concluída, clique em **Continuar**.
- Salve ou faça o upload da coleção. Escolha se deseja fazer o upload do arquivo para a Citrix ou salvá-lo na máquina local.
Se você optar por fazer o upload do arquivo agora, continue com a Etapa 5.
Se você optar por salvar o arquivo localmente:
- Uma caixa de diálogo Windows **Save** é exibida. Navegue até o local desejado.
- Quando o salvamento local for concluído, o nome do caminho do arquivo será exibido e vinculado. Você pode visualizar o arquivo. Você pode fazer o upload do arquivo posteriormente para a Citrix. Veja [CTX136396](https://support.citrix.com/article/ctx136396).
Clique em **Concluído** para retornar à página de abertura do Scout. Você não precisa concluir nenhuma etapa adicional neste procedimento.
-
Autentique-se para uploads e, opcionalmente, especifique um proxy. Para obter detalhes, consulte Autorização de upload.
- Se você não se autenticou por meio do Scout, continue com esta etapa.
- Se você tiver se 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 Continuar. Você não precisa fornecer credenciais para esta coleção. Continue com a Etapa 6.
- Se você se autenticou anteriormente, mas deseja reautorizar e obter um novo token, clique em Alterar/Reautorizar e continue com esta etapa.
Escolha se você deseja usar as credenciais Citrix ou as credenciais do Citrix Cloud para autenticar o upload. Clique em Continuar. A página de credenciais aparece 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 Configurar proxy. Você pode instruir o Scout a usar as configurações de proxy definidas para as propriedades de 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 do proxy.
- Para uma conta do Citrix Cloud, clique em Gerar 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 do Scout.
- Para uma conta Citrix, insira suas credenciais.
Quando terminar, clique em Continuar.
-
Insira as informações sobre o upload.
- O campo de nome contém o nome padrão do arquivo para os diagnósticos coletados. Isso é suficiente para a maioria das coleções, embora você possa alterar o nome. (Se você excluir o nome padrão e deixar o campo de nome vazio, o nome padrão será usado.)
- Opcionalmente, especifique um número de caso de suporte Citrix de 8 dígitos.
- No campo opcional Descrição , descreva o problema e indique quando o problema ocorreu, se aplicável.
Quando terminar, clique em Iniciar upload.
Durante o upload, a parte inferior esquerda da página se aproxima da porcentagem do upload que foi concluído. Para cancelar um upload em andamento, clique em Stop Upload.
Quando o upload for concluído, o URL de sua localização será exibido e vinculado. Você pode seguir o link para o local da Citrix para ver a análise do upload ou copiar o link.
Clique em Concluído para retornar à página de abertura do Scout.
Rastreie e reproduza
O procedimento Trace and Reproduce compreende selecionar máquinas, iniciar um rastreamento, reproduzir problemas, concluir a coleta de diagnósticos e, em seguida, fazer o upload do arquivo para a Citrix ou salvá-lo localmente.
Esse procedimento é semelhante ao procedimento padrão Collect . No entanto, ele permite que você inicie um rastreamento em máquinas e depois recrie problemas nessas máquinas. Todas as coleções de diagnósticos incluem informações de rastreamento AOT. Esse procedimento adiciona traços de CDF para ajudar na solução de problemas.
-
Lance o Scout. No menu Start da máquina, selecione Citrix > Citrix Scout. Na página de abertura, clique em Trace & Reproduce.
-
Selecione máquinas. A página Select machines lista todos os VDAs e controladores no site. Você pode filtrar a exibição pelo nome da máquina. Marque a caixa de seleção ao lado de cada máquina da qual você deseja coletar traços e diagnósticos. Em seguida, clique em Continuar.
Para adicionar outras máquinas manualmente (como servidores StoreFront ou Citrix Provisioning), consulte Adicionar máquinas manualmente.
O Scout inicia automaticamente os testes de verificação em cada máquina selecionada, certificando-se de que ela atenda aos critérios listados em Testes de verificação. Se a verificação falhar em uma máquina, uma mensagem será publicada na coluna Status e a caixa de seleção dessa máquina será desmarcada. Você também pode:
- Resolva o problema e marque a caixa de seleção da máquina novamente. Isso aciona uma nova tentativa dos testes de verificação.
- Ignore essa máquina (deixe a caixa de seleção desmarcada). Diagnósticos e rastreamentos não são coletados dessa máquina.
Quando os testes de verificação forem concluídos, clique em **Continuar**.
- Comece o rastreamento. 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 coleta de traços continua enquanto você faz isso. Quando terminar de reproduzir o problema, clique em Continuar no Scout. Isso interrompe o rastreamento.
Depois de interromper o rastreamento, indique se você reproduziu o problema durante o rastreamento.
-
Colete diagnósticos de máquinas. Clique em Comece a coletar. Durante a coleta:
- A coluna Status indica o estado atual da coleta de uma máquina.
- Para interromper uma coleta em andamento em uma única máquina, clique em Cancelar na coluna Ação dessa máquina.
- Para interromper todas as coleções em andamento, clique em Parar coleção no canto inferior direito da página. Os diagnósticos das máquinas que concluíram a coleta são mantidos. Para retomar a coleta, clique em Retry na coluna Action para cada máquina.
- Quando a coleta 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 coleção mais recente substitui a anterior.
- Se uma coleta falhar, você pode 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 Continuar.
-
Salve ou faça o upload da coleção. Escolha se deseja fazer o upload do arquivo para a Citrix ou salvá-lo localmente.
Se você optar por fazer o upload do arquivo agora, continue com a Etapa 6.
Se você optar por salvar o arquivo localmente:
- Uma caixa de diálogo Salvar do Windows é exibida. Selecione o local desejado.
- Quando o salvamento local for concluído, o nome do caminho do arquivo será exibido e vinculado. Você pode visualizar o arquivo. Lembre-se: você pode fazer o upload do arquivo posteriormente da Citrix; consulte [CTX136396](https://support.citrix.com/article/ctx136396) para Citrix Insight Services.
Clique em **Concluído** para retornar à página de abertura do Scout. Você não precisa concluir nenhuma etapa adicional neste procedimento.
-
Autentique-se para uploads e, opcionalmente, especifique o proxy. Consulte Autorização de upload para obter detalhes sobre esse processo.
- Se você não se autenticou por meio do Scout, continue com esta etapa.
- Se você se autenticar por meio do Scout, o token de autorização armazenado será usado por padrão. Se é isso que você deseja fazer, escolha essa opção e clique em Continuar. Você não precisa fornecer credenciais para esta coleção. Continue com a Etapa 7.
- Se você se autenticou anteriormente, mas deseja reautorizar e obter um novo token, clique em Alterar/Reautorizar e continue com esta etapa.
Escolha se você deseja usar as credenciais Citrix ou as credenciais do Citrix Cloud para autenticar o upload. Clique em Continuar. A página de credenciais aparece 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 Configurar proxy. Você pode instruir o Scout a usar as configurações de proxy definidas para as 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 do proxy.
- Para uma conta do Citrix Cloud, clique em Gerar token. Seu navegador padrão é iniciado em uma página do Citrix Cloud em que um token é exibido. Copie o token e cole-o na página do Scout.
- Para uma conta Citrix, insira suas credenciais.
Quando terminar, clique em Continuar.
-
Forneça informações sobre o upload.
Insira os detalhes do upload:
- O campo de nome contém o nome padrão do arquivo para os diagnósticos coletados. Isso é suficiente para a maioria das coleções, embora você possa alterar o nome. (Se você excluir o nome padrão e deixar o campo de nome vazio, o nome padrão será usado.)
- Opcionalmente, especifique um número de caso de suporte Citrix de 8 dígitos.
- No campo opcional Descrição, descreva o problema e indique quando o problema ocorreu, se aplicável.
Quando terminar, clique em **Iniciar upload**.
Durante o upload, a parte inferior esquerda da página se aproxima da porcentagem do upload concluída. Para cancelar um upload em andamento, clique em **Stop Upload**.
Quando o upload for concluído, o URL de sua localização será exibido e vinculado. Você pode seguir o link para o local da Citrix para ver a análise do upload ou copiar o link.
Clique em **Concluído** para retornar à página de abertura do Scout.
Habilitar coleta adicional de registros
A função Ativar coleta adicional de registros permite que você use a função de rastreamento e reprodução com mais ferramentas, como perfmon, Netsh, DebugView e Wireshark.
Nota:
Isso só se aplica às máquinas locais.
Para configurar a coleta adicional de registros:
- Inicie o Citrix Scout.
- Clique na engrenagem Configurações .
- Clique em Habilitar a coleta adicional de registros com mais ferramentas.
- Clique em Salvar.
Para coletar registros adicionais:
- Na página inicial do Scout, clique em Trace & Reproduce.
- Na página Selecione máquinas , clique na engrenagem no lado direito da máquina local.
- Na página Selecione as ferramentas necessárias para registrar: , clique em Ferramentas de download.
-
Na página Download Tools , selecione as ferramentas que você deseja usar e clique em Download. As ferramentas são então baixadas, exceto o Wireshark. O Wireshark só pode ser baixado e instalado manualmente. Observação: se você optar por baixar outras ferramentas manualmente, deverá 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 emC:\ProgramData\Citrix\TElemetryService\ CDC\ Lib\Resources\Tools\ DebugView\. -
Na página Selecione as ferramentas necessárias para registrar: , clique em Atualizar Status. Todas as ferramentas selecionadas aparecem como Present na coluna Status.
- Selecione as ferramentas para registro e clique em Avançar.
- Siga as instruções Trace and Reproduce .
- Após a conclusão, verifique os registros no arquivo zip. Os registros são compactados na pasta CDClogs.
Nota:
Se a ferramenta Procmon for selecionada para rastreamento, os registros do Process Monitor podem crescer rapidamente. Certifique-se de selecionar somente as ferramentas necessárias. Você também pode monitorar o tamanho dos registros em %temp%\ Scout-CDC-Log.
Agende coletas
Nota:
Atualmente, você pode agendar coletas, mas não verificações de saúde.
O procedimento de agendamento compreende selecionar máquinas e, em seguida, definir ou cancelar a programação. As coleções agendadas são automaticamente enviadas para a Citrix. (Você pode salvar coleções agendadas localmente usando a interface do PowerShell. Consulte Citrix Call Home.)
-
Lance o Scout. No menu Iniciar da máquina, selecione Citrix > Citrix Scout. Na página de abertura, clique em Schedule.
-
Selecione máquinas. Todos os VDAs e controladores no site estão listados. Você pode filtrar a exibição pelo nome da máquina.
Quando você instalou VDAs e controladores usando a interface gráfica, se você definiu uma programação de Call Home (consulte Citrix Call Home), o Scout exibe essas configurações, por padrão. Você pode usar esta versão do Scout para iniciar coletas agendadas pela primeira vez ou alterar uma programação configurada anteriormente.
Embora você tenha ativado/desativado o Call Home por máquina durante a instalação do componente, uma programação configurada 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 Continuar.
Para adicionar outras máquinas manualmente (como servidores StoreFront ou Citrix Provisioning), consulte Adicionar máquinas manualmente.
O Scout inicia automaticamente os testes de verificação em cada uma das máquinas selecionadas, certificando-se de que elas atendam aos critérios em Testes de verificação. Se a verificação falhar em uma máquina, uma mensagem será publicada na coluna Status e a caixa de seleção dessa máquina será desmarcada. Você também pode:
- Resolva o problema e marque a caixa de seleção da máquina novamente. Isso aciona uma nova tentativa dos testes de verificação.
- Ignore essa máquina (deixe a caixa de seleção desmarcada). Os diagnósticos (ou traços) não são coletados dessa máquina.
Quando os testes de verificação forem concluídos, clique em **Continuar**.
A página de resumo lista as máquinas às quais os cronogramas são aplicados. Clique em **Continuar**.
-
Defina a programação. 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 o início da coleta.
- Para configurar uma programação diária para as máquinas selecionadas, clique em Diariamente. Insira a hora do dia (relógio de 24 horas) para o início da coleta.
- 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 que tenha sido configurado anteriormente para essas máquinas.
Clique em Continuar.
-
Autentique-se para uploads e, opcionalmente, especifique um proxy. Consulte Autorização de upload para obter detalhes sobre esse processo. Lembre-se: você não pode usar um token armazenado para se autenticar ao trabalhar com uma agenda do Scout.
Escolha se você deseja usar as credenciais Citrix ou as credenciais do Citrix Cloud para autenticar o upload. Clique em Continuar.
Na página de credenciais:
- Se você quiser usar um servidor proxy para o upload do arquivo, clique em **Configurar proxy**. Você pode instruir o Scout a usar as configurações de proxy definidas para as 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 do proxy.
- Para uma conta do Citrix Cloud, clique em **Gerar 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 do Scout.
- Para uma conta Citrix, insira suas credenciais.
Quando terminar, clique em **Continuar**.
Revise o cronograma configurado. Clique em **Concluído** para retornar à página de abertura do Scout.
Durante uma coleta, o log do aplicativo 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 confidenciais de segurança. O recurso de mascaramento de dados do Citrix Scout permite que você mascare 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áquinas, nomes de domínio, nomes de usuários, nomes de hipervisores, nomes de grupos de entrega, nomes de catálogos, nomes de aplicativos e SIDs.
Nota:
Os rastreamentos de CDF são criptografados e não podem ser mascarados.
Os registros do Linux VDA são compactados no formato
.tar.gz2e não podem ser mascarados.
Colete novos diagnósticos e realize o mascaramento de dados
Para usar o recurso de mascaramento de dados do Citrix Scout, inicie o Scout na linha de comando.
- No Windows, abra o prompt de comando como administrador.
- Vá para o diretório em que o Scout está instalado:
cd C:\Program Files\ Citrix\Telemetry Service. - Launch Scout:
ScoutUI.exe datamasking. - Clique em Collect ou Trace & Reproduce para coletar diagnósticos.
- Depois que a coleta for concluída, selecione Ativar mascaramento de dados. Essa opção é ativada por padrão.
- Configure a máscara de dados. Você pode usar as regras padrão ou personalizá-las.
- Selecione se deseja carregar ou salvar a coleção de diagnósticos.
- Se você selecionar Carregar a coleção de diagnósticos para o Citrix, os arquivos de diagnóstico mascarados serão enviados para o Citrix.
- Se você selecionar Salvar a coleção de diagnósticos em sua máquina local, tanto o diagnóstico original quanto o mascarado serão salvos no local especificado.
Execute o mascaramento de dados em diagnósticos existentes
- No Windows, abra o prompt de comando como administrador.
- Vá para o diretório em que o Scout está instalado:
cd C:\Program Files\ Citrix\Telemetry Service. - Inicie o Scout diretamente no modo de mascaramento de dados:
ScoutUI.exe datamasking FilePath. - Selecione “Ativar mascaramento de dados” para continuar. Essa opção é ativada por padrão.
- Configure a máscara de dados. Você pode executar o mascaramento de dados com as regras padrão ou personalizar as regras.
- Selecione se deseja carregar ou salvar a coleção de diagnósticos.
- Se você selecionar Carregar a coleção de diagnósticos para o Citrix, os arquivos de diagnóstico mascarados serão enviados para o Citrix.
- Se você selecionar Salvar a coleção de diagnósticos em sua máquina local, tanto o diagnóstico original quanto o mascarado serão salvos no local especificado.
Arquivo de dados mascarado e localizações de arquivos de mapeamento
Depois de carregar ou salvar a coleção de diagnósticos, clique no link para abrir o diagnóstico 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 para serem usados em futuros recursos e melhorias do produto. A coleta de dados é ativada por padrão.
Para alterar a coleta e o upload de dados de uso, clique na engrenagem Configurações na interface do usuário do Scout. Em seguida, você pode escolher se deseja enviar as informações selecionando Sim ou Não e clicando em Salvar.
Neste artigo
- Introdução
- O que é coletado
- Configuração do Scout
- Sobre os exames de saúde
- Execute verificações de saúde
- Permissões e requisitos
- Testes de verificação
- Compatibilidade de versões
- Instale e atualize
- Autorização de upload
- Encontre a máquina
- Adicionar máquinas manualmente
- Importar máquinas VDA
- Colete diagnósticos
- Rastreie e reproduza
- Habilitar coleta adicional de registros
- Agende coletas
- Mascaramento de dados
- Coleta de dados de uso