Introdução ao Monitoramento de Infraestrutura

Observação:

As duas etapas a seguir são válidas apenas para o monitoramento de componentes do Provisioning Service e do StoreFront™.

Etapa 1: Instalação do Citrix Infrastructure Monitor

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

Etapa 1.1: Identificar os componentes de destino

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

Etapa 1.2 Baixar o Citrix Infrastructure Monitor

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

Etapa 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.

Observação:

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

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

• Etapa 1.4: Obter 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 na Etapa 2: Registrar o Citrix Infrastructure Monitor.

Requisitos de porta

Após instalar com êxito o CitrixInfraMonitor.msi, o instalador cria uma exceção para a porta 9595. Se você estiver usando um firewall de terceiros, talvez seja necessário 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:

• Observação:

  • As máquinas Provisioning Service e StoreFront não fazem chamadas de saída para o serviço Infrastructure Monitoring.

• Etapa 2: Registrar o Citrix Infrastructure Monitor

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

• Interface do usuário do Monitor
• SDK do PowerShell Remoto

Usando a interface do usuário do Monitor

Conclua o registro na interface do usuário do Monitor executando as etapas a seguir.

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

Clique em “Configurações” > “Conectar componentes Citrix” > “Gerenciar”.

Ou,

Clique em “Infraestrutura” > “Gerenciar”.

Etapa 2.2: Inserir detalhes do componente

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

Certifique-se de que o citrixinframonitor.msi esteja baixado e instalado no destino. Para obter mais informações, consulte a 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. 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.
• Selecione o “Local do recurso”.

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. Isso 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 ser 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 conexão

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

Usando o SDK do PowerShell Remoto

Observação:

A versão mínima necessária do PoshSDK é 7.42.26154.48609 ou posterior.

1. Certifique-se de que os pré-requisitos mencionados em Pré-requisitos sejam atendidos.

2. Configure o SDK do PowerShell Remoto.

3. Execute o seguinte comando do PowerShell para registrar o Citrix Infrastructure Monitor:

   
   Add-MonitorDirectorAgent -Fqdn <FQDN of component> -Component <component> -AdminAddress localhost:19097 -ResourceLocationId <resourceLocationID> -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:

Observação:

• 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.

Após registrar com sucesso a máquina Provisioning Service ou StoreFront, os detalhes do nome da máquina aparecem na guia Monitor > Infraestrutura.

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

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

Observação:

O serviço Citrix Infrastructure Monitor também funciona no modo HTTP e, neste caso, a configuração a seguir não é necessária. No entanto, recomendamos que você o utilize no modo HTTPS. Execute as etapas a seguir 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 obter mais informações sobre a geração de arquivos PFX, consulte Como criar um arquivo PFX.

   Observação:

   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 - [Raiz do Console]” é exibida.

2. No menu “Arquivo”, clique em “Adicionar/Remover Snap-in”. A janela “Adicionar ou Remover Snap-ins” é exibida.

   

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

   

4. Selecione “Conta de computador” e, em seguida, clique em “Avançar”. A janela “Selecionar Computador” é exibida.

   

5. Selecione “Computador local”.
6. Clique em “Concluir”. A seção “Certificados (Computador Local)” aparece 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.

   

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.

   

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”.

    

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 é exibida.
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: Fornecer acesso de leitura ao certificado

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

Etapa 4: Obter 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”.

   

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

Etapa 5: Definir 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”.

   

4. Especifique o nome da “Variável” como DIRECTOR_AGENT_HTTPS_CERTIFICATE_THUMBPRINT.
5. Especifique o thumbprint da etapa anterior em valor da “Variável”.
6. Clique em “OK”.

Etapa 6: Reiniciar o 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….

   

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

Você pode habilitar HTTPS no serviço Monitor, usando o SDK do PowerShell Remoto.

Observação:

A versão mínima exigida do PoshSDK é 7.44.26401.2361 ou posterior.

1. Certifique-se de que os pré-requisitos mencionados em Pré-requisitos sejam atendidos.

2. Configurar o SDK do PowerShell Remoto.

3. Execute o seguinte comando do PowerShell para habilitar HTTPS na configuração do Monitor:

   
   Set-DirectorAgentHttps -AdminAddress localhost:19097 -EnableHttps $true
   
   <!--NeedCopy-->
   

Observação:

Para verificar o valor das configurações existentes, execute o comando Get-DirectorAgentHttps -AdminAddress localhost:19097.

Caso precise desabilitar HTTPS na configuração do Monitor, execute o comando Set-DirectorAgentHttps -AdminAddress localhost:19097 -EnableHttps $false.