Citrix Scout
Introdução
O Citrix童子军coleta记录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.
- 跟踪和繁殖: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跟踪和繁殖,ScheduleeHealth Checkatualmente 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. ConsulteCall Home.
Onde executar o Scout:
- Em乌玛implantacao当地,执行o球探从它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 emC:\ProgramData\Citrix\TelemetryService\ScoutUI.log
. Esse arquivo pode ser usado para solução de 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 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) emCitrix 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 registroHKEY_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, consulteDatapoints 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, consulteIntegração com o Citrix Telemetry Service
O Linux VDA pode alterar automaticamente a porta do soquetectxtelemetry
ou a porta do serviço de telemetria. Em caso afirmativo, você deve configurar a porta manualmente.
- Navegue até C:\Program Files\Citrix\Telemetry Service
- Abra o arquivo ScoutUI.exe.config
- 英勇Altere o de LinuxVDATelemetryServicePort ouLinuxVDATelemetryWakeupPort para o que foi configurado no Linux VDA:
- Salve as alterações e feche o arquivo.
- 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 emC:\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 àspermissões e requisitosde 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.
- 乌玛conexao controlador com o banco de trabalho做de dados do site.
Verificações de integridade 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 início 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
- Armazenamento do usuário
- 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 CenterCTX132805.
Verificações de integridade do StoreFront
As verificações do StoreFront verificam:
- O serviço Citrix Default Domain está em execução
- O servico Citrix凭据的钱包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 àspermissões e requisitospara 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.
- Inicie o Scout. No menuIniciarda máquina, selecioneCitrix > Citrix Scout. Na página de abertura, clique emHealth Check.
Selecionarmáquinas. Clique emFind machinepara descobrir máquinas. A páginaSelect machineslista 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 emContinue.
Para adicionar outros tipos de componentes (como servidores StoreFront e máquinas VDA), consulteAdicionar máquinas manualmenteeImportar 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 nostestes de verificação. Se a verificação falhar, uma mensagem será publicada na colunaStatuse a caixa de seleção dessa máquina será desmarcada. Você pode:
- 解析器o问题e marcar caixa de载入史册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 emContinue.
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 emStart Checking.
Durante e após a verificação:
- A colunaStatusindica o estado de verificação atual de uma máquina.
- Para interromper todas as verificações em andamento, clique emStop Checkingno 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ãoStop Checkingno canto inferior direito muda paraDone.
- Se uma verificação falhar, você poderá clicar emRetryna colunaAction.
- Se uma verificação for concluída sem problemas encontrados, a colunaActionestará vazia.
- Se uma verificação encontrar problemas, clique emView Detailspara mostrar os resultados.
- Depois que a verificação for concluída para todas as máquinas selecionadas, não clique emBack. (Se você fizer isso, os resultados da verificação serão perdidos.)
- Quando as verificações forem concluídas, clique emDonepara 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 eRun Environment Testspara 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.
UseExecutar como administradorao 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 umaversã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.
A pasta de rastreamento AOT é salva emC:\ProgramData\Citrix\TelemetryService\CitrixAOT
.
Somente usuários no grupo Administrador, Sistema e Serviço de Telemetria SID têm permissão para acessar o registroHKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetry
.
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.
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. UsandoExecutar 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 (consulteInstalar e atualizar). Se você não atualizar o serviço, essa máquina não estará incluída nas açõesCollectou跟踪和繁殖.
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. ConsulteConfiguração do Scoutpara 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. ConsulteConfiguração do Scoutpara 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, consulteCTX130147.
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 |
Mascaramento de dados | Não | Começando com 3.17 |
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, executeTelemetryServiceInstaller_xx.msi
a partir dox64\Virtual Desktop Components
ou da pastax86\Virtual Desktop Components
ou na mídia de instalação do Citrix Virtual Apps and Desktops.
Quando você seleciona a açãoCollectou跟踪和繁殖, 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çõesCollectou跟踪和繁殖. 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ê se autenticar com uma conta da Citrix ou 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ê executarCollectou跟踪和繁殖, marque a caixa de seleçãoStore token and skip this step in the future.
Você deve reautorizar sempre que selecionarSchedulena 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 procedimentosCollect,跟踪和繁殖eScheduleo Scout lista os Controladores e VDAs que ele descobre automaticamente.
Quando você executa aVerificação de integridade do Scouta partir do Delivery Controller, clique emFind machinepara 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ê precisaadicionar máquinas manualmenteouimportar 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 executarverificaçõ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 emContinue. 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跟踪和繁殖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 executarverificações de integridade.
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
- Copie o arquivo machineList.txt para a máquina associada ao domínio que você deseja iniciar a verificação de integridade do Scout.
- Na página Verificação de integridade do Scout, clique emAdd Machine.
- Selecione o tipo de máquinaWindows VDA.
- Clique emImport VDA machines.
- Selecione o arquivo machineList.txt.
- Clique emOpen.
As máquinas VDA importadas estão listadas na página Scout Health Check.
Coletar diagnósticos
O procedimentoCollectinclui 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.
Inicie o Scout. No menuIniciarda máquina, selecioneCitrix > Citrix Scout. Na página de abertura, clique emCollect.
Selecionarmáquinas.
- Em um Controller, a páginaSelect machineslista 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), consulteAdicionar máquinas manualmente.
- Em outros componentes (como servidores VDA), a páginaSelect machineslista 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 emContinue.
O Scout inicia automaticamente testes de verificação em cada máquina selecionada, verificando se ele atende aos critérios listados nostestes de verificação. Se a verificação for malsucedida, uma mensagem será publicada na colunaStatuse a caixa de seleção dessa máquina não está marcada. Você pode:
- 解析器o问题e marcar caixa de载入史册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 emContinue.
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 emStart Collecting.
Durante a coleta:
- A colunaStatusindica o estado atual da coleta de uma máquina.
- Para interromper uma coleção em andamento em uma única máquina, clique emCancelna colunaActiondessa máquina.
- Para interromper todas as coleções em andamento, clique emStop Collectionno 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 emRetryna colunaActionde cada máquina.
- Quando a coleção for concluída para todas as máquinas selecionadas, o botãoStop Collectionno canto inferior direito muda paraContinue.
- Para coletar diagnósticos novamente, clique emCollect Againna colunaActiondessa máquina. A coleta mais recente substitui a anterior.
- Se uma coleção falhar, você poderá clicar emRetryna colunaAction. 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 emBack. (Se você clicar nesse botão, a coleta será perdida.)
Quando a coleção for concluída, clique emContinue.
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álogoSalvardo 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. ConsulteCTX136396.
Clique emDonepara retornar à página de abertura do Scout. Você não precisa concluir nenhuma outra etapa neste procedimento.
Autentique para uploads e, opcionalmente, especifique um proxy. Para obter detalhes, consulteAutorizaçã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 emContinue. 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 emChange/Reauthorizee continue com esta etapa.
Escolha se você deseja usar credenciais Citrix ou credenciais do Citrix Cloud para autenticar o upload. Clique emContinue. 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 emConfigure 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生成令牌. 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 emContinue.
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 opcionalDescription, descreva o problema e indique quando o problema ocorreu, se aplicável.
Quando terminar, clique emStart 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 emStop 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 emDonepara retornar à página de abertura do Scout.
Rastrear e reproduzir
O procedimentoTrace and Reproduceinclui 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 procedimentoCollectpadrã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.
Inicie o Scout. No menuIniciarda máquina, selecioneCitrix > Citrix Scout. Na página de abertura, clique em跟踪和繁殖.
Selecionarmáquinas. A páginaSelect machineslista 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 emContinuar.
Para adicionar outras máquinas manualmente (como servidores StoreFront ou Citrix Provisioning), consulteAdicionar 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 nostestes de verificação. Se a verificação falhar para uma máquina, uma mensagem será publicada na colunaStatuse a caixa de seleção dessa máquina não estará marcada. Você pode:
- 解析器o问题e marcar caixa de载入史册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 emContinue.
Inicie o traço. O resumo lista todas as máquinas das quais os traços são coletados. Clique emIniciar 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 emContinueno 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 emStart Collecting. Durante a coleta:
- A colunaStatusindica o estado atual da coleta de uma máquina.
- Para interromper uma coleção em andamento em uma única máquina, clique emCancelna colunaActiondessa máquina.
- Para interromper todas as coleções em andamento, clique emStop Collectionno 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 emRetryna colunaActionde cada máquina.
- Quando a coleção for concluída para todas as máquinas selecionadas, o botãoStop Collectionno canto inferior direito muda paraContinue.
- Para coletar diagnósticos novamente de uma máquina, clique emCollect Againna colunaActiondessa máquina. A coleta mais recente substitui a anterior.
- Se uma coleção falhar, você poderá clicar emRetryna colunaAction. 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 emBack. (Se você fizer isso, a coleção será perdida.)
Quando a coleção for concluída, clique emContinue.
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; consulteCTX136396com relação a Citrix Insight Services.
Clique emDonepara retornar à página de abertura do Scout. Você não precisa concluir nenhuma outra etapa neste procedimento.
Autenticar para uploads e, opcionalmente, especificar proxy. Veja aautorização de Uploadpara 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 emContinue. 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 emChange/Reauthorizee continue com esta etapa.
Escolha se você deseja usar credenciais Citrix ou credenciais do Citrix Cloud para autenticar o upload. Clique emContinue. 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 emConfigure 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生成令牌. 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 emContinue.
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 emStart 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 emStop 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 emDonepara retornar à página de abertura do Scout.
Habilitar coleta de logs adicionais
A funçãoEnable additional log collectionpermite 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:
- Inicie o Citrix Scout.
- Clique na engrenagem deSettings.
- Clique emEnable additional log collection with more tools.
- Clique emSalvar.
Para coletar logs adicionais:
- Na página inicial do Scout, clique em跟踪和繁殖.
- Na páginaSelect machines, clique na engrenagem no lado direito da máquina local.
- Na páginaSelect the tools require for logging:, clique emDownload Tools.
- Na páginaDownload Tools, selecione as ferramentas que deseja usar e clique emDownload. 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\
. 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áginaSelect the tools require for logging:, clique emRefresh Status. Todas as ferramentas selecionadas aparecem comoPresentna coluna Status.
- Selecione as ferramentas para registro e clique emNext.
- Siga as instruções emRastrear e reproduzir.
- Após a conclusão, verifique os logs no arquivo zip. Os logs são compactados na pastaCDCLogs.
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. ConsulteCitrix Call Home.)
Inicie o Scout. No menu Iniciar da máquina, selecioneCitrix > Citrix Scout. Na página de abertura, clique emSchedule.
Selecionarmá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 (consulteCitrix 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 emContinue.
Para adicionar outras máquinas manualmente (como servidores StoreFront ou Citrix Provisioning), consulteAdicionar máquinas manualmente.
O Scout inicia automaticamente testes de verificação nas máquinas selecionadas, verificando se ele atende aos critérios nostestes de verificação. Se a verificação falhar para uma máquina, uma mensagem será publicada na colunaStatuse a caixa de seleção dessa máquina não estará marcada. Você pode:
- 解析器o问题e marcar caixa de载入史册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 emContinue.
A página de resumo lista as máquinas às quais os agendamentos são aplicados. Clique emContinue.
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 emWeekly. 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 emDaily. 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 emOff. Isso cancela qualquer agendamento configurado anteriormente para essas máquinas.
Clique emContinue.
Autentique para uploads e, opcionalmente, especifique um proxy. Veja aautorização de Uploadpara 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 emContinue.
Na página de credenciais:
- Se você quiser usar um servidor proxy para o upload do arquivo, clique emConfigure 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生成令牌. 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 emContinue.
Revise o cronograma configurado. Clique emDonepara 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.
- 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
. - Lançamento Scout:
ScoutUI.exe datamasking
. - Clique emCollectou跟踪和繁殖para coletar diagnósticos.
- Após a conclusão da coleta, selecioneEnable data masking. Essa opção está ativada por padrão.
- Configure a máscara de dados. Você pode usar as regras padrão ou personalizar as regras.
- Selecione se deseja carregar ou salvar a coleta de diagnósticos.
- Se você selecionarUpload the diagnostics collection to Citrix, os arquivos de diagnóstico mascarados serão carregados para a Citrix.
- Se você selecionarSave 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
- 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 “Enable data masking” para continuar. Essa opção está 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 coleta de diagnósticos.
- Se você selecionarUpload the diagnostics collection to Citrix, os arquivos de diagnóstico mascarados serão carregados para a Citrix.
- Se você selecionarSave 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 engrenagemSettingsna usuario童子军做接口。低地颇得escolher se deseja enviar as informações selecionandoYesouNoe, em seguida, clicando emSave.
Neste artigo
- Introdução
- O que é coletado
- Configuração do Scout
- Sobre verificações de integridade
- Execute verificações de integridade
- Permissões e requisitos
- Testes de verificação
- Compatibilidade de versão
- Instalar e atualizar
- Autorização de upload
- Encontrar máquina
- Adicionar máquinas manualmente
- Importar máquinas VDA
- Coletar diagnósticos
- Rastrear e reproduzir
- Habilitar coleta de logs adicionais
- Agendar coletas
- Mascaramento de dados
- Coleta de dados de uso