Introdução ao Monitoramento de Infraestrutura

Nota:

Os dois passos a seguir são válidos apenas para o monitoramento de componentes do Provisioning Service e StoreFront™.

Passo 1: Instalação do Citrix Infrastructure Monitor

Execute os passos a seguir para concluir a instalação no componente de destino e estabelecer a conexão para coleta segura de dados.

Nota:

A máquina na qual você está instalando o Citrix Infrastructure Monitor já deve ter o Provisioning Service e o StoreFront.

Passo 1.1: Identificar os componentes de destino

Identifique os componentes de destino, como servidores Provisioning Service ou StoreFront, que precisam ser monitorados.

Passo 1.2 Baixar o Citrix Infrastructure Monitor

Você pode baixar CitrixInfraMonitor.msi na página downloads da Citrix no servidor de destino identificado no Passo 1.1.

Passo 1.3: Executar o Citrix Infrastructure Monitor

Execute o instalador CitrixInfraMonitor.msi no componente de destino, seguindo as instruções do assistente de instalação.

Nota:

Usuários com privilégios administrativos podem instalar e configurar o Citrix Infrastructure Monitor no componente de destino.

Citrix Infrastructure Monitor

Após a instalação ser bem-sucedida, você pode visualizar o Serviço Citrix Infrastructure Monitor na seção Serviços:

Citrix Infrastructure Monitor

Etapa 1.4: Obtenha o token de registro

Obtenha o token fornecido no arquivo RegistrationToken.txt em C:\ProgramData\Citrix\InfraMonitor\RegistrationToken.txt no sistema onde o Citrix Infrastructure Monitor está instalado e mantenha-o pronto para uso em Etapa 2: Registrar o Citrix Infrastructure Monitor.

Requisitos de porta

Após instalar CitrixInfraMonitor.msi com sucesso, o instalador cria uma exceção para a porta 9595. Se você estiver usando qualquer firewall de terceiros, pode ter que permitir manualmente a comunicação TCP para esta porta para usar o serviço Citrix Infrastructure Monitoring.

A tabela a seguir fornece detalhes sobre os requisitos de porta de entrada para máquinas Provisioning Service e StoreFront :

Origem Destino Tipo Porta Protocolo Finalidade
DDC Máquina do Provisioning Service ou StoreFront TCP 9595 HTTP ou HTTPS Chamada para coletar métricas da máquina do Provisioning Service ou StoreFront.

Nota:

As máquinas do Provisioning Service e do StoreFront não fazem chamadas de saída para o serviço de Monitoramento de Infraestrutura.

Etapa 2: Registrar o Citrix Infrastructure Monitor

Você pode registrar o Citrix Infrastructure Monitor usando o seguinte:

  • UI do Director
  • SDK do PowerShell

Na UI do Director

Conclua o registro na UI do Director usando as seguintes etapas:

Etapa 2.1: Navegar até a página Conectar Componentes Citrix

Clique em Configurações > Conectar Componentes Citrix > Gerenciar.

Ou,

Clique em Infraestrutura > Gerenciar.

Configurações

Conectar Componentes Citrix

Etapa 2.2: Inserir detalhes do componente

Na tela Conectar Componentes Citrix, clique em Criar conexão. A janela Criar uma conexão é exibida.

Criar uma conexão

Certifique-se de que o CitrixInfraMonitor.msi esteja baixado e instalado no destino. Para obter mais informações, consulte Etapa 1 neste documento. Siga as instruções na tela e preencha os detalhes do componente necessários para estabelecer uma conexão segura.

  • Selecione um tipo de componente na lista suspensa. O componente pode ser Provisioning Service ou StoreFront.
  • Insira o nome do host.
  • Insira o nome de domínio.
  • Insira o nome de usuário da máquina Provisioning Service ou StoreFront.
  • Insira a senha da máquina Provisioning Service ou StoreFront.

Etapa 2.3: Autorizar a conexão

Obtenha o token do Citrix Infrastructure Monitor do arquivo RegistrationToken.txt em C:\ProgramData\Citrix\InfraMonitor\RegistrationToken.txt no sistema onde o Citrix Infrastructure Monitor está instalado.

Insira os detalhes do token obtido na interface do usuário do Director. Este token autoriza a conexão entre o site e o componente.

O texto do token presente no arquivo RegistrationToken.txt é regenerado quando você reinicia o serviço Citrix Infrastructure Monitor. Após o registro bem-sucedido, o arquivo de token é excluído da máquina. Se você precisar recriar um novo arquivo de token por qualquer motivo, reinicie o serviço Citrix Infrastructure Monitor. Por motivos de segurança, o arquivo de token é removido após três tentativas de registro falhas com um token inválido.

Etapa 2.4: Criar uma conexão

Depois que os detalhes forem preenchidos, clique em Criar. A conexão criada está disponível na lista de conexões na página Conectar Componentes Citrix.

Conectar Componentes Citrix

Usando o SDK remoto do PowerShell

Pré-requisito:

  • Certifique-se de que o Citrix Infrastructure Monitor esteja instalado na máquina StoreFront ou PVS.

Registre o Citrix Infrastructure Monitor no DDC para se comunicar com a máquina PVS ou StoreFront. Este registro serve para enviar as métricas de saúde da infraestrutura coletadas na máquina PVS ou StoreFront para o DDC.

Execute o seguinte comando PowerShell no Delivery Controller™ para registrar o Citrix Infrastructure Monitor:

Add-MonitorDirectorAgent -Fqdn <FQDN of component> -Component <component> -Domain <domain> -Username <username> -Password <password> -Token <token>
<!--NeedCopy-->

Observação:

O nome de usuário e a senha são parâmetros opcionais. No entanto, se você não fornecer esses parâmetros, algumas das métricas não estarão disponíveis para você.

Os parâmetros do comando anterior são os seguintes:

Parâmetro Descrição
Fqdn FQDN do servidor PVS ou StoreFront.
Component O componente que você está integrando. Por exemplo: PVS ou SF. PVS significa Citrix Provisioning™ e SF significa StoreFront.
Domain O domínio do qual todos os componentes fazem parte.
Username Nome de usuário do administrador.
Password Senha do usuário administrador.
Token Obtenha o token do Citrix Infrastructure Monitor do arquivo RegistrationToken.txt em C:\ProgramData\Citrix\InfraMonitor\RegistrationToken.txt no sistema onde o Citrix Infrastructure Monitor está instalado.

Nota:

  • O texto do token presente no arquivo RegistrationToken.txt é regenerado quando você reinicia o serviço Citrix Infrastructure Monitor. Após o registro ser bem-sucedido, o arquivo de token é excluído da máquina. Se precisar registrar novamente, reinicie o serviço Citrix Infrastructure Monitor.

  • Por motivos de segurança, o arquivo de token é removido após três tentativas de registro falhas com um token inválido.

Uma vez que você registra com sucesso a máquina PVS ou StoreFront, os detalhes do nome da máquina aparecem na guia Director > Infrastructure.

Um comando de exemplo para se registrar no Citrix Infrastructure Monitor é o seguinte:

Reiniciar monitor de infraestrutura

[Optional] Etapas para configurar HTTPS para o Citrix Infrastructure Monitor

Nota:

O serviço Citrix Infrastructure Monitor também funciona no modo HTTP e, neste caso, a seguinte configuração não é necessária. No entanto, recomendamos que você o use no modo HTTPS. Execute as seguintes etapas somente se precisar configurar HTTPS para o Citrix Infrastructure Monitor.

Etapa 1: Carregar o certificado para a máquina

  1. Obtenha um certificado PFX para sua máquina onde o Citrix Infrastructure Monitor está instalado. Para mais informações sobre a geração de arquivos PFX, consulte Como criar um arquivo PFX.

    Nota:

    Você também pode usar arquivos PFX protegidos por senha.

  2. Carregue o certificado para a máquina em qualquer local.

Etapa 2: Importar o certificado para os certificados do computador

  1. Clique em Iniciar > Executar > digite mmc e, em seguida, clique em OK. A janela Console 1 - [Console Root] é exibida.
  2. No menu Arquivo, clique em Adicionar/Remover Snap-in. A janela Adicionar ou Remover Snap-ins é exibida.

    Adicionar ou remover snap-in

  3. Em Snap-in, clique duas vezes em Certificados. A janela Snap-in de Certificados é exibida.

    Snap de certificado

  4. Selecione Conta do computador e clique em Avançar. A janela Selecionar Computador é exibida.

    Computador local

  5. Selecione Computador local.
  6. Clique em Concluir. A seção Certificados (Computador Local) é exibida na lista de snap-ins selecionados para o novo console.
  7. Clique em OK.
  8. Expanda Certificados, clique com o botão direito em Pessoal > Todas as Tarefas > Importar. O Assistente para Importação de Certificados é exibido.

    Expandir certificado

  9. Selecione Avançar > Procurar Arquivos. Navegue até o local onde você carregou o arquivo PFX, altere o tipo de arquivo para Todos os arquivos e, em seguida, selecione o certificado PFX respectivo.

    Assistente de importação de certificado

  10. Insira a Senha PFX. Você pode deixá-la em branco se não houver senha.
  11. Clique em Avançar.
  12. Para o Repositório de Certificados, certifique-se de que a opção Colocar todos os certificados no seguinte repositório esteja selecionada e que o Repositório de certificados esteja selecionado como Pessoal.

    Repositório de certificados

  13. Clique em Avançar.
  14. Revise os detalhes e clique em Concluir.
  15. Aguarde a confirmação. A mensagem A importação foi bem-sucedida aparece.
  16. Navegue até Certificados > Pessoal e certifique-se de que o certificado esteja presente.
  17. Exclua o arquivo de certificado PFX da máquina.

Etapa 3: Conceda acesso de leitura ao certificado

  1. Clique com o botão direito do mouse no certificado importado > Todas as Tarefas > Gerenciar Chaves Privadas.
  2. Na caixa de diálogo que se abre, selecione Adicionar e então procure por Serviço de Rede. Clique em OK.
  3. Selecione SERVIÇO DE REDE em Nomes de grupo ou de usuário.
  4. Permita acesso de Leitura em Permissões para SERVIÇO DE REDE.
  5. Clique em OK.

Etapa 4: Obtenha o Thumbprint

  1. Clique duas vezes no certificado importado.
  2. Na caixa de diálogo que se abre, navegue até a guia Detalhes e role até o final.
  3. Clique em Thumbprint.

    Armazenamento de impressão digital do certificado

  4. Copie o valor e mantenha-o pronto para a próxima etapa.

Etapa 5: Configurando a variável de ambiente

  1. Abra o Painel de Controle.
  2. Procure por ambiente e selecione Editar as variáveis de ambiente do sistema.
  3. Em Variáveis do Sistema (para todos os usuários), clique em Novo.

    Variável do sistema

  4. Especifique o nome da Variável como DIRECTOR_AGENT_HTTPS_CERTIFICATE_THUMBPRINT.
  5. Especifique a impressão digital da etapa anterior em valor da Variável.
  6. Clique em OK.

Etapa 6: Reiniciar CitrixInfraMonitorService

  1. Abra o PowerShell e execute o seguinte comando:

    Restart-Service CitrixInfraMonitorService
    <!--NeedCopy-->
    
  2. Certifique-se de que o HTTPS esteja habilitado capturando o módulo CitrixInfraMonitorService e procurando a linha de log Start to listen on HTTPS….

    Reiniciar monitor de infraestrutura

Etapa 7: Habilitar HTTPS na configuração do Monitor

Execute o seguinte comando em uma máquina Delivery Controller:

Set-MonitorConfiguration -DirectorAgentEnableHttps $true
<!--NeedCopy-->