Citrix DaaS

Cloud Health Check

O Cloud Health Check permite executar verificações que avaliam a integridade e a disponibilidade do site e de seus componentes. Você pode executar verificações de integridade para Virtual Delivery Agents (VDAs), servidores StoreFront e Profile Management. As verificações de integridade do VDA identificam possíveis causas para problemas comuns de registro VDA e inicializações de sessão.

Se houver problemas durante as verificações, o Cloud Health Check fornece um relatório detalhado e as ações para corrigi-los. Sempre que o Cloud Health Check é iniciado, ele verifica a versão mais recente dos scripts na CDN (Content Delivery Network) e baixa automaticamente os scripts se não estiverem presentes na máquina local. O Cloud Health Check sempre escolhe a versão local mais recente dos scripts para executar as verificações de integridade.

Nota:

O Cloud Health Check não é atualizado sempre que é executado.

Em um ambiente Citrix Cloud, execute o Cloud Health Check a partir de uma máquina ingressada no domínio para executar verificações em um ou mais VDAs ou servidores StoreFront.

Nota:

Não é possível instalar ou executar o Cloud Health Check em um Cloud Connector.

O log do aplicativo Cloud Health Check é armazenado em C:\ProgramData\Citrix\TelemetryService\CloudHealthCheck.log. Você pode usar esse arquivo para solucionar problemas.

Veja uma introdução ao Cloud Health Check.

Veja quando usar o Cloud Health Check.

Instalação

Para preparar seu ambiente para a instalação do Cloud Health Check, você deve ter uma máquina Windows ingressada no domínio.

Nota:

Não é possível instalar ou executar o Cloud Health Check no Cloud Connector.

  1. Na máquina ingressada no domínio, baixe o instalador do Cloud Health Check.
  2. Clique duas vezes no arquivo CloudHealthCheckInstaller_x64.msi.
  3. Clique na caixa de seleção para aceitar os termos.
  4. Clique em Install.

    cloud health check 1

  5. Após a conclusão da instalação, clique em Finish.

    cloud health check 2

Permissões e requisitos

Permissões:

  • Para executar verificações de integridade:

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

Para cada máquina VDA ou StoreFront em que você executa verificações de integridade:

  • O sistema operacional deve ser de 64 bits.
  • O Cloud Health Check deve ser capaz 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 acesso à Infraestrutura de Gerenciamento do Windows (WMI) deve estar habilitado na máquina.

Sobre verificações de integridade

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

Verificações de integridade VDA

Para registro no VDA, o Cloud Health Check 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 a inicialização de sessões em VDAs, o Cloud Health Check 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
  • Status do Citrix Universal Injection Driver (CTXUVI)

Para Profile Management em VDAs, o Cloud Health Check verifica:

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

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

Verificações de integridade do StoreFront

As verificações do StoreFront verificam se:

  • O serviço Citrix Default Domain está em execução
  • O serviço Citrix Credential Wallet está em execução
  • A conexão do servidor StoreFront com o Active Directory é pela porta 88
  • A conexão do servidor StoreFront com o Active Directory é pela porta 389
  • A conexão do servidor StoreFront com o Active Directory é pela porta 464
  • O URL de base tem um FQDN válido
  • O endereço IP correto da URL de base pode ser obtido
  • O pool de aplicativos do IIS está usando .NET 4.0
  • O certificado está vinculado à porta SSL para o URL do host
  • A cadeia de certificados está completa
  • Os certificados expiraram
  • Um certificado expira dentro de 30 dias

Executar o Cloud Health Check

Para executar o Citrix Cloud Health Check:

  1. Selecione Citrix > Citrix Cloud Health Check no menu Iniciar da máquina ou execute CloudHealthCheck.exe em C:\Program Files\Citrix\CloudHealthCheck.

    cloud health check 3

  2. Na tela principal do Cloud Health Check screen, clique em Add machine.

    cloud health check 4

  3. Digite o FQDN da máquina que você deseja adicionar. Nota: Embora a inserção de um alias DNS em vez de um FQDN possa parecer válida, as verificações de integridade podem falhar.
  4. Clique em Continue.
  5. Repita para adicionar outras máquinas, conforme necessário.

    cloud health check 5

  6. Para remover uma máquina adicionada manualmente, clique no X na extremidade direita da linha e confirme a exclusão. Repita para excluir outras máquinas adicionadas manualmente.

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

Importar máquinas VDA

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

  1. No Connector, gere o arquivo de lista de máquinas com o seguinte comando do 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

  1. Copie o arquivo machineList.txt para a máquina ingressada no domínio em que você deseja executar o Cloud Health Check.
  2. Na página Cloud Health Check, clique em Add Machine.
  3. Selecione o tipo de máquina Windows VDA.
  4. Clique em Import VDA machines.
  5. Selecione o arquivo machineList.txt.
  6. Clique em Open.

    cloud health check 6

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

  7. Marque a caixa de seleção ao lado de cada máquina em que você deseja executar verificações de integridade.

    O Cloud Health Check inicia automaticamente testes de verificação em cada máquina selecionada, certificando-se de que ele atende aos critérios listados nos testes de verificação. Se a verificação falhar, uma mensagem aparece na coluna Status e a caixa de seleção dessa máquina fica desmarcada. Em seguida, você pode:

    • Resolver o problema e marcar a caixa de seleção da máquina novamente. Isso aciona uma nova tentativa dos testes de verificação.
    • Ignorar essa máquina deixando sua caixa de seleção desmarcada. As verificações de integridade não são executadas para essa máquina.
  8. Quando os testes de verificação forem concluídos, clique em Continue.

    cloud health check 7

  9. 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).

  10. Clique em Start Checking.

    cloud health check 8

    Durante e após a verificação, a coluna Status indica o estado de verificação atual de uma máquina.

  11. Para interromper todas as verificações em andamento, clique em Stop Checking no canto inferior direito da página. Você não pode cancelar a verificação de integridade de uma única máquina; você só pode cancelar a verificação para todas as máquinas selecionadas.

    cloud health check 9

  12. Quando as verificações forem concluídas para todas as máquinas selecionadas, o botão Stop Checking no canto inferior direito muda para Done.

    cloud health check 10

    • Se uma verificação falhar, você poderá clicar em Retry na coluna Action.
    • Se uma verificação for concluída sem problemas encontrados, a coluna Action estará vazia.
    • Se uma verificação encontrar problemas, clique em View Details para exibir os resultados.

    cloud health check 11

Se você usar o Internet Explorer para exibir o relatório, deve clicar em Permitir conteúdo bloqueado para exibir o hiperlink.

Cloud health check 12

Depois que a verificação for concluída para todas as máquinas selecionadas, clicar em Back fará você perder os resultados da verificação.

Quando as verificações forem concluídas, clique em Done para retornar à tela principal do Cloud Health Check.

Recuperar máquinas VDA

O Cloud Health Check pode detectar e recuperar automaticamente VDAs de suas implantações do Citrix DaaS (anteriormente Citrix Virtual Apps and Desktops Service).

Para recuperar seus VDAs:

  1. Prepare uma nova máquina que esteja ingressada na mesma floresta do domínio da máquina em que o Cloud Health Check é executado.
  2. Abra o Cloud Health Check e clique em Find machine para entrar no Citrix Cloud.

    Recuperação do Cloud health check 1

  3. Selecione o cliente com o site da nuvem que você deseja recuperar.

    Recuperação do Cloud health check 2

A lista VDA é exibida no Cloud Health Check. A lista também é salva em um arquivo local localizado em \ProgramData\Citrix\TelemetryService\ChcDiscovery\ChcDiscoveredMachineList.json.

Recuperação do Cloud health check 3

Sua lista de máquinas carrega o cache local quando você abre o Cloud Health Check novamente. Se você fez alguma atualização em sua implantação, clique em Find machine para atualizar a lista de máquinas.

Nota:

  • O Cloud Health Check encontra máquinas somente na mesma floresta do domínio da máquina que executa o Cloud Health Check.
  • As sessões do Citrix Cloud expiram em uma hora. Após uma hora, você deve clicar em Find machine novamente para obter a lista VDA mais recente.
  • Uma mensagem de erro aparece se a recuperação da lista VDA falhar. Você pode verificar os detalhes em C:\ProgramData\Citrix\TelemetryService\CloudHealthCheck.log.

Recuperação do Cloud health check 4

Resultados da verificação de integridade

As verificações de integridade que geram relatórios contêm os seguintes elementos:

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

Executar o Cloud Health Check na linha de comando

O Cloud Health Check pode ser executado na linha de comando para ajudar os clientes a realizarem verificações de integridade. Para usar o Cloud Health Check na linha de comando, você deve ser um administrador na máquina em que o Cloud Health Check está sendo executado.

Nota:

Ao usar o Cloud Health Check na linha de comando, somente uma máquina pode ser verificada por vez. Somente uma instância do CloudHealthCheck.exe pode ser executada ao mesmo tempo na máquina de destino. Se você quiser verificar várias máquinas, as máquinas devem ser verificadas uma a uma, agrupando os cmdlets em um loop nos scripts cmdlet/PowerShell. Instâncias de IU abertas do Cloud Health Check também devem ser fechadas.

Cmdlets

Os cmdlets de linha de comando suportados são:

  • MachineFQDN - Esse cmdlet é obrigatório. Esse é o nome de domínio totalmente qualificado da máquina de destino.
  • MachineType - Esse cmdlet é opcional. O valor do cmdlet pode ser o VDA do Windows (valor padrão) ou o StoreFront.
  • ReportName - Esse cmdlet é opcional. O valor do cmdlet deve ser um nome de arquivo válido no Windows. O valor padrão é HealthCheckReport.
  • SkipAdminCheck - Esse cmdlet é opcional. Pode ser adicionado para ignorar as verificações que exigem privilégios de administrador.
  • UpdateScripts - Esse cmdlet é opcional. Pode ser adicionado para atualizar os scripts de verificação do servidor CDN.
  • DisableCeip - Esse cmdlet é opcional se o CEIP estiver habilitado na interface do usuário; adicione-o para desabilitar o CEIP.
  • Help - Mostrar informações de ajuda sobre os parâmetros.

Exemplos:

HealthCheckCLI.exe -MachineFQDN machine.domain.local

HealthCheckCLI.exe -MachineFQDN machine.domain.local -ReportName checkreport

HealthCheckCLI.exe -MachineFQDN machine.domain.local -SkipAdminCheck

HealthCheckCLI.exe -MachineFQDN machine.domain.local -UpdateScripts

HealthCheckCLI.exe -MachineFQDN machine1.domain.local,machine2.domain.local,machine3.domain.local

HealthCheckCLI.exe -Help

Nota:

Os nomes de parâmetros não diferenciam maiúsculas de minúsculas

Por padrão, a saída do console não é mostrada na janela do console da linha de comando. Você pode exibir manualmente a saída anexando |more ao cmdlet.

Exemplo: HealthCheckCLI.exe -MachineFQDN machine.domain.local|more

O padrão da linha de comando precisa de privilégios de administrador para ser executado. Adicione o parâmetro -SkipAdminCheck para substituir a necessidade de privilégios de administrador.

Códigos de saída

Os códigos de saída explicam o resultado das verificações do Cloud Health Check na linha de comando. Para obter o código de saída, você deve adicionar start /wait antes do cmdlet.

Exemplo: start /wait HealthCheckCLI.exe -MachineFQDN machine.domain.local

Os códigos de saída são:

  • 0 - Normal, verificação concluída e aprovada.
  • 1 - Falha, verificação concluída com problemas.
  • 2 - Erro, verificação não concluída; com erros.

Você também pode usar o cmdlet echo %errorlevel% para obter o código de saída do último comando executado.

Relatórios

O Cloud Health Check cria pastas com o nome da máquina em HealthCheckDataFolder para a máquina de destino. Um arquivo .html e um arquivo .json são criados na máquina em que o Cloud Health Check está instalado. Os relatórios de verificação de integridade estão localizados em HealthCheckDataFolder em %ProgramData%\Citrix\TelemetryService\HealthCheck\Data.

Os relatórios só são criados quando existem problemas na máquina de destino.

Nota:

Os arquivos de relatório são substituídos se o nome do relatório especificado existir.

Alertas e informações básicas são armazenados no relatório .json.

Imagem do relatório JSON

Os códigos de relatório são:

  • issueKey: uma descrição em texto simples do problema.
  • issueUuid: uma cadeia de caracteres de identificação exclusiva do problema.
  • fixRecommendation: a recomendação para correção do problema.
  • severity: indica se o problema deve ser corrigido. Um erro pode indicar que o componente (VDA ou StoreFront) não funcionou corretamente; um aviso indica que o componente funciona, mas pode ter alguns possíveis problemas.
  • issueName: o título do problema.
  • issueDescription: uma descrição detalhada do problema.

Atualizar o Cloud Health Check

Se houver uma nova versão do Cloud Health Check disponível, um link Update available será exibido no canto superior direito da janela do Cloud Health Check. Clique no link para acessar o Citrix Downloads e obter a nova versão.

Atualizar o Cloud Health Check

Agendador do Cloud Health Check

Use o agendador do Cloud Health Check para realizar verificações periódicas de integridade.

Configurar o agendamento

  1. Clique em Add machine na janela principal do Cloud Health Check para adicionar máquinas nas quais deseja executar verificações periódicas.

    agendador do cloud health check 1

  2. Clique no ícone de relógio e, em seguida, clique em Set schedule.

    agendador do cloud health check 2

  3. Selecione um horário para sua programação e clique em Next. A tarefa pode ser definida para ser repetida marcando a caixa de seleção Repeat task every.
  4. Escolha a saída dos resultados para o Log de Eventos do Windows. A tarefa pode ser configurada para gravar os resultados no Log de Eventos do Windows.
  5. Escolha disparar um script do PowerShell personalizado após a conclusão da verificação agendada e clique em Next.
    • Clique em Edit para editar o conteúdo do script no Windows PowerShell ISE, se necessário.
    • Clique em Locate para abrir o local do arquivo e usar um editor diferente para abrir o arquivo e editar o script.
    • Clique em Reset para redefinir o script para a configuração original.

      Nota:

      • Você não pode alterar o nome do script e o caminho do script.
      • Você pode implementar ações personalizadas usando o script ChcShceduledTrigger.ps1, como enviar um e-mail depois que o relatório de verificação agendada estiver pronto. Adicione o seguinte código ao final do script. Personalize o código para adicionar as contas de e-mail corretas e o endereço do servidor SMTP. Uma notificação por e-mail é enviada usando as credenciais da conta que a tarefa agendada executa.
    #Sending email example code:
    $body = "CreatedTime: $($report.CreatedTime)"
    $body = $body + "`nStatusCode: $($report.StatusCode)"
    $body = $body + "`nMachineCount: $($report.MachineReports.Count)"
    $from = "mock_email_accout"
    $to = "mock_email_accout"
    $smtpServer = "mock_smtp_server"
    
    Send-MailMessage -Subject "Citrix Cloud Health Check Scheduler Report" -Body $body -From $from -To $to -SmtpServer $smtpServer
    <!--NeedCopy-->
    

    agendador do cloud health check 3

  6. Selecione as máquinas para sua programação e clique em Next.

    agendador do cloud health check 4

  7. Insira as credenciais da conta em que a tarefa é executada e clique em Finish.

    agendador do cloud health check 5

  8. Uma tarefa CloudHealthCheckScheduler é criada no Agendador de Tarefas do Windows.

    agendador do cloud health check 6

Ver os resultados da programação

O ícone do relógio com um ponto vermelho indica que os problemas foram encontrados na última verificação. Para visualizar os resultados, clique no ícone do relógio e, em seguida, clique em View results.

Agendador do cloud health check 7

A página Schedule Reports mostra os resultados de todas as tarefas de verificação de integridade agendadas. Clique em View Report para verificar o relatório de cada programação.

Agendador do cloud health check 14

O relatório html lista o relatório geral de cada agendamento. Veja abaixo um exemplo de relatório:

Agendador do cloud health check 12

Todos os resultados da verificação de integridade são armazenados em uma pasta chamada ChcSchedule. O Cloud Health Check cria três arquivos durante cada execução de verificação. Até 500 logs de iteração são mantidos.

Agendador do cloud health check 8

Agendador do cloud health check 11

Se a caixa de seleção Output results to Windows Event Log estiver marcada, o resultado da verificação também será enviado para o Log de Eventos do Windows.

Agendador do cloud health check 13

Desativar agendamentos

  1. Clique no ícone de relógio e, em seguida, clique em Set schedule.

    agendador do cloud health check 9

  2. Clique em Off e clique em Finish para desativar o agendador.

    agendador do cloud health check 10

Mais informações

  • Você deve adicionar ou importar VDAs para o Cloud Health Check primeiro. Para obter mais informações, consulte Importar máquinas VDA.
  • O agendador do Cloud Health Check só pode agendar uma tarefa por vez em uma máquina ingressada no domínio. Se você definir a programação várias vezes, somente a última terá efeito.

Testes de verificação

Antes de iniciar uma 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 para que uma verificação de integridade seja executada. Se um teste falhar em uma máquina, o Cloud Health Check exibirá uma mensagem com sugestões de ações corretivas.

  • Cloud Health Check 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 habilitar a comunicação remota do PowerShell e o WinRM executando o PowerShell como administrador e, em seguida, executando o cmdlet Enable-PSRemoting. Para obter detalhes, consulte a ajuda da Microsoft para o cmdlet.
  • Cloud Health Check requires PowerShell 3.0 or later - Instale o PowerShell 3.0 ou posterior na máquina e, em seguida, ative a comunicação remota do PowerShell.
  • 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.

Coleta de dados de uso

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

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

Cloud health check 13

Correção automática

A correção automática permite que o Cloud Health Check detecte e corrija automaticamente determinados problemas alterando as configurações ou reiniciando os serviços.

A correção automática verifica os seguintes itens do registro do VDA, com as correções recomendadas:

  • Associação ao domínio da máquina VDA
    • Correção: Teste o canal de segurança de conexão com um modelo “repair” para corrigir
  • Status dos serviços VDA
    • Correção: Reinicie o serviço BrokerAgent
  • Comunicação com o Controller
    • Correção: Reinicie o serviço BrokerAgent
  • Sincronização de tempo com o Controller
    • Correção: Execute o comando W32tm

Para inicializações de sessão, a correção automática verifica o seguinte item, com a correção recomendada:

  • Status do serviço de início de sessão
    • Correção: Reinicie o serviço BrokerAgent

Esse recurso é ativado por padrão. Para desativá-lo, clique no ícone de engrenagem no canto superior direito da janela principal do Cloud Health Check e desmarque Attempt to automatically fix VDA issues during health check.

Autocorreção do Cloud health check 1

Relatório de resultados

Depois de executar a correção automática, há uma seção no relatório de resultados da verificação que mostra todos os detalhes:

Autocorreção do Cloud health check 2

Autocorreção do Cloud health check 3

Solução de problemas

Se o Cloud Health Check apresentar falha na execução ou ocorrer alguma exceção, verifique o log do Cloud Health Check em C:\ProgramData\Citrix\TelemetryService\CloudHealthCheck.log.

O log do Cloud Health Check de cada máquina de destino está em C:\ProgramData\Citrix\TelemetryService\HealthCheck\Data\$TargetMachineFQDN\log.txt.

Para ativar o log de depuração:

Edite C:\Program Files\Citrix\CloudHealthCheck\CloudHealthCheck.exe.config, atualize <add name="TraceLevelSwitch" value="3" /> to <add name="TraceLevelSwitch" value="4" />, salve o arquivo e reabra o Cloud Health Check.

Feedback

Para deixar comentários sobre o Cloud Health Check, responda à pesquisa da Citrix.