Introdução ao Monitoramento de Infraestrutura

Last published : Nov 13, 2026
Nota:
Os dois passos a seguir são válidos apenas para o monitoramento de componentes do Provisioning Service e StoreFront™.
Related information
Monitoramento de infraestrutura

Etapa 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.
Observação:
A máquina na qual você está instalando o Citrix Infrastructure Monitor já deve ter o Provisioning Service e o StoreFront.

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 CitrixInfraMonitor.msi na página 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.
Monitor de Infraestrutura Citrix
Após a instalação ser bem-sucedida, você pode visualizar o Serviço de Monitoramento de Infraestrutura Citrix na seção Serviços:
Monitor de Infraestrutura Citrix

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 Monitor de Infraestrutura Citrix está instalado e mantenha-o pronto para uso em Etapa 2: Registrar o Monitor de Infraestrutura Citrix.

Requisitos de porta

Após instalar CitrixInfraMonitor.msi com sucesso, o instalador cria uma exceção para a porta 9595. Se você estiver usando um firewall de terceiros, talvez precise permitir manualmente a comunicação TCP para esta porta para usar o serviço de Monitoramento de Infraestrutura Citrix.
A tabela a seguir fornece detalhes sobre os requisitos de porta de entrada para máquinas do 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 do Serviço de Provisionamento ou da máquina StoreFront.
Nota:
As máquinas do Serviço de Provisionamento 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 interface do usuário do Director

Conclua o registro na interface do usuário do Director usando as seguintes etapas:

Etapa 2.1: navegar para a página Conectar Componentes Citrix

Clique em Configurações > Conectar Componentes Citrix > Gerenciar.
Ou,
Clique em Infraestrutura > Gerenciar.
ConfiguraçõesConectar 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 seja 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 do Provisioning Service ou StoreFront.
  • Insira a senha da máquina do 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 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 uma 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.
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 se registrar no Citrix Infrastructure Monitor:
Add-MonitorDirectorAgent -Fqdn <FQDN of component> -Component <component> -Domain <domain> -Username <username> -Password <password> -Token <token>
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.
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 você 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.
Depois de registrar com sucesso a máquina PVS ou StoreFront, os detalhes do nome da máquina aparecerão na guia Director > Infraestrutura.
Um exemplo de comando para se registrar no Citrix Infrastructure Monitor é o seguinte:
Reiniciar monitor de infraestrutura

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 - é 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 de 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) 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.
    Expandir certificado
  9. Selecione Avançar > Procurar Arquivos. navegar 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á-lo 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 é exibida.
  16. navegar para 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 do mouse 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 Grupo ou nomes de usuário.
  4. Permita o 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, navegar para a guia Detalhes e role até o final.
  3. Clique em Impressão digital.
    Armazenamento de impressão digital do certificado
  4. Copie o valor e o mantenha pronto para a próxima etapa.

Etapa 5: Definindo a variável de ambiente

  1. Abra o Painel de Controle.
  2. Pesquise 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
  2. Certifique-se de que o HTTPS esteja habilitado capturando o módulo CitrixInfraMonitorService e procurando pela linha de log Start to listen on HTTPS....
    Reiniciar monitor de infraestrutura

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

Execute o seguinte comando em uma máquina Delivery Controller:
Set-MonitorConfiguration -DirectorAgentEnableHttps $true