Instalação

Pré-requisitos para a instalação

1. Certifique-se de atender aos Requisitos de Hardware e Software para o Insights.
2. Instale o Orchestrator ou modifique uma instalação existente habilitando a funcionalidade do Insights.
3. Certifique-se de ter seguido as instruções do orquestrador. Este certificado deve ter chaves públicas e privadas e deve ser instalado na Raiz Confiável da máquina do Insights.
4. Certifique-se de que o certificado do Insights seja colocado na Raiz Confiável da máquina do Orchestrator.
5. Ao especificar um nome de host para o Insights, certifique-se de que o nome de host desejado seja resolvido no seu DNS.
6. Verifique se o servidor em que o Insights será instalado pode comunicar-se com o(s) servidor(es) onde o Orchestrator está instalado e vice-versa,
   Importante: É preferível usar um certificado SSL SAN enviado a uma Autoridade de Certificação do que um certificado autoassinado.

   Certificados autoassinados (e aqueles da sua autoridade certificadora) devem ser instalados tanto na Raiz Confiável quanto no armazenamento de certificação Pessoal na máquina do Insights. O certificado deve ser marcado como Exportável.

   Observe que, ao usar um certificado autoassinado, você pode ter problemas se acessar o Insights por meio do Firefox, Internet Explorer ou Edge.

Modificando uma instalação do Orchestrator para o Insights

1. No Painel de Controle do Windows, selecione Adicionar ou remover programas.
2. Selecione seu Orchestrator na lista e clique em Modificar.
3. Siga o instalador na tela, selecionando a funcionalidade Integração do Insights:
   
   

   

   
   
   Observação: Após a instalação ser concluída, você também deve atualizar sua licença de Host para garantir que a funcionalidade do Insights esteja ativada.

Instalação do Insights

1. Execute o instalador UiPathInsightsInstaller.exe como administrador. O assistente do Instalador do UiPath Insights é exibido.
2. Selecione a caixa de seleção Marcar aqui para aceitar a licença para concordar com os termos do contrato, depois clique em Avançar. A Configuração do Servidor do Insights é exibida.
   
   

   

   
   
3. Altere a Configuração do Servidor conforme desejado:
   • Nome do host do site - usado para identificar o dispositivo no qual o Insights está instalado. Por padrão, isso é definido para o nome do host da máquina, mas pode ser editado. Este nome deve poder ser resolvido a partir de um servidor externo.
   • Porta do site - a porta a ser usada para a comunicação do Insights. Por padrão, isso é definido como 443 para habilitar o uso de HTTPS.
   • Adicionar regras de firewall para esta porta - se estiver selecionada, adiciona automaticamente regras de firewall para esta porta para garantir a segurança da sua máquina.
     Importante: O Insights usa o endereço de loopback para a comunicação entre diferentes serviços. Essas portas não estão usando HTTPS, então, para evitar que as portas sejam alcançadas de outras máquinas, certifique-se de que apenas a porta 443 esteja aberta para receber conexões de fontes externas (ou seja, Endereços de IP diferente de 127.0.0.1).
   • Diretório de Build do Insights - Se definido, determina o diretório onde os dados do Insights serão armazenados após a importação e integração no sistema.
     Importante: este campo não é necessário, se for deixado em branco o instalador usa o diretório padrão. A pasta não pode ser raiz da unidade - D:\ ou ter uma barra à direita.

     Verifique duas vezes o caminho de instalação selecionado. Não é possível mover uma instalação de um local para outro pós-instalação.

   • Entidade do Certificado SSL - o nome do assunto do certificado SSL que você deseja usar para proteger conexões com o Insights. Por padrão, é preenchido com o nome completo do computador, mas pode ser editado.

Observação: o assunto do certificado SSL deve corresponder ao nome do host do site fornecido acima. Se estiver usando um certificado existente, ele deve ser marcado como exportável e ser instalado no Armazenamento de Certificado Pessoal da Máquina local.

• Criar Certificado Autoassinado - se selecionado, cria automaticamente um certificado autoassinado com o nome do assunto especificado acima. Para usar o Edge ou o Internet Explorer com certificados autoassinados, consulte aqui.
  Importante: Não recomendamos habilitar a opção Criar Certificado Autoassinado, porque é preferível usar um certificado SSL SAN enviado a uma Autoridade de Certificação.

  Se também estiver usando um certificado autoassinado na sua máquina do Orchestrator, os certificados do Orchestrator e do Insights devem ser adicionados à raiz confiável de ambas as máquinas.

• E-mail - o e-mail do usuário administrador do Insights local.

Observação: não deve corresponder ao endereço de e-mail de qualquer usuário definido no Orchestrator.

• Senha - a senha para o usuário administrador do Insights local. Deve ter de 8 a 20 caracteres e conter pelo menos 1 letra maiúscula, 1 letra minúscula, 1 número e 1 caractere especial (!, @, #, $, %, ^, &, *).
  1. Clique em Avançar. A Configuração do Banco de Dados do Insights é exibida.
     
     

     

     
     
  2. Preencha os detalhes do banco de dados da seguinte maneira:
• Nome do Servidor - o nome da máquina SQL Server onde o banco de dados do Insights está localizado. Você também pode especificar um número de porta personalizado aqui usando um sinal de dois pontos, como sql.uipath.com:1733.
• Nome do Banco de Dados - nome do banco de dados do Insights especificado ao instalar o Orchestrator.
• Autenticação do Windows - se selecionado, a conexão com o Insights é feita usando uma conta de domínio. Veja as etapas de configuração adicionais abaixo.
• Autenticação SQL - se estiver selecionada, a conexão com o Insights é feita usando a autenticação SQL. Se estiver usando esta opção, os campos Nome de Usuário e Senha se tornam editáveis e você deve fornecer o nome de usuário e senha SQL usados para se conectar ao banco de dados.
  1. Clique em Avançar. A Configuração do Orchestrator é exibida.
     
     

     

     
     
  2. Forneça os detalhes de conexão para sua instância do Orchestrator, da seguinte maneira:
• Endpoint do Orchestrator - o URL do seu Orchestrator.
• Nome de usuário - o nome de usuário do tenant do Host. Por padrão, ele é admin e não pode ser editado.
• Senha - a senha para a conta de administrador do Host.
  1. Clique em Avançar. A Configuração do Banco de Dados do Orchestrator é exibida.
     
     

     

     
     
  2. Preencha os detalhes do banco de dados do Orchestrator da seguinte maneira:
• Nome do Servidor - o nome da máquina SQL Server onde o banco de dados do Orchestrator está localizado. Você também pode especificar um número de porta personalizado aqui usando um sinal de dois pontos, como sql.uipath.com:1733.
• Nome do Banco de Dados - o nome do banco de dados do Orchestrator especificado ao instalar o Orchestrator.
• Autenticação do Windows - se estiver selecionada, a conexão é feita usando uma conta de domínio.
• Autenticação SQL — se selecionado, a conexão é feita usando a autenticação SQL. Se estiver usando esta opção, os campos Nome de Usuário e Senha se tornam editáveis e você deve fornecer o nome de usuário e senha SQL usados para se conectar ao banco de dados.
  1. Clique em Avançar. A Configuração do Servidor de Email é exibida.
     
     

     

     
     
     Nota: Se você não configurar um servidor de e-mail, então os alertas de e-mail e as notificações do Insights não são enviadas. Você pode adicionar uma configuração do servidor de e-mail após a instalação usando a função Modificar da funcionalidade do Windows para Adicionar ou Remover Programas.
  2. Se desejar, configure seu servidor de e-mail para notificações do Insights da seguinte maneira:
• Host SMTP - insira seu host SMTP.
• Porta SMTP - insira sua porta SMTP. Por padrão, isso é definido como 25, mas pode ser editado.
• Configuração do TLS - usada para definir as configurações de segurança do servidor de e-mail. Oferece as seguintes opções:
  • Segura - se estiver marcada, a conexão usará TLS.
  • Ignorar TLS - se estiver selecionada (e Segura não estiver ), o TLS não será usado. Selecione esta opção ao se conectar a um servidor SMTP não seguro.
  • Exigir TLS - se estiver selecionada (e **Segura não estiver ), requer que a conexão seja atualizada para TLS independentemente do suporte do servidor de e-mail.
• Nome de Usuário SMTP - o endereço de e-mail do qual enviar mensagens de e-mail.
• Senha SMTP - a senha para o endereço de e-mail usado acima.
• From Address - o endereço de e-mail a partir do qual enviar mensagens de e-mail. Deve corresponder ao nome de Usuário SMTP acima.
• Do Nome de exibição - um nome de exibição para o endereço de e-mail.

• Configuração do Servidor de E-mail Avançada - tem as seguintes opções:

  • Debug - se estiver selecionada, o Insights registra todo o tráfego SMTP. Deve ser usado apenas para solucionar problemas.
  • Logger - se estiver selecionada, o Insights registra todos os eventos (por exemplo, conexão do servidor).
  • Tempo limite de conexo - tempo em milissegundos, para aguardar que uma conexão seja estabelecida.
  • Tempo limite de saudação - tempo, em milissegundos, para aguardar a saudação após uma conexão ser estabelecida.

  • Tempo limite do Socket - duração, em milissegundos, de inatividade a ser permitida.

    1. Clique em Instalar. O processo de instalação é iniciado. Após a conclusão, clique em Fechar para sair do instalador.
       Importante:

       Após a instalação do Insights ser concluída:

       • Certifique-se de que o Nível de Confiança .NET do aplicativo Sisense esteja definido como Full.
       • Abra o arquivo consts.js localizado no diretório C:\Program Files\Sisense\app\query-proxy-service\src\common e defina o parâmetro HEALTH_CHECK_TIMEOUT como 100000.

Configuração de Autenticação do Windows

Se você estiver usando a Autenticação do Windows para se conectar ao banco de dados do Insights (Etapa 4, acima), você deve modificar as propriedades de login dos serviços Sisense.CLRConnectorsContainer e Sisense.JVMConnectorsContainer da seguinte maneira:

Observação: Se a conta que executa este processo não for usada ao executar o instalador do Insights, certifique-se de que faça parte do grupo do Administrador local.

1. Abra o Windows Services Manager.
2. Clique com o botão direito do mouse em Sisense.CLRConnectorsContainer e selecione Propriedades.
3. Na aba Login, selecione o botão de rádio Esta conta.
4. Insira o nome de usuário e a senha da conta usada para se conectar ao banco de dados do Insights e clique em OK.
5. Repita este processo para o serviço Sisense.JVMConnectorsContainer.
6. Reinicie ambos os serviços.

Configuração do tenant

Após o Insights ser instalado, você deve habilitá-lo para o(s) tenant (s) desejado(s) usando o utilitárioUiPath.InsightsAdminTool.exe.

Importante:

Cada tenant habilitado dispara um processo de "inicialização otimizada", que busca dados no banco de dados do Insights para o número configurado de dias de provisionamento.

Dependendo do volume de dados e recursos de hardware, isso pode ocorrer várias horas antes que todos os dados do tenant sejam processados e possam ser visualizados no Insights.

1. Na máquina em que o Insights é instalado, navegue para o diretório\Orchestrator\Tools. Por exemplo, cd C:\Program Files (x86)\UiPath\Orchestrator\Tools.
2. Execute o utilitário UiPath.InsightsAdminTool.exe:
   
   

   

   
   
3. No campo Usuário, insira o usuário de administrador do tenant do Orchestrator host. Ele é administrador por padrão e não pode ser alterado.
4. Insira a Senha para o host tenant do Orchestrator e clique em Logon. A janela Selecionar uma funcionalidade é exibida.
   Importante: O Insights 20.10.0 tem um problema conhecido de pouca importância no Painel ROI. Acesse as notas de versão vinculadas para obter instruções sobre como corrigir esse problema usando Configuração do Tenant.
   
   

   

   
   
5. Selecione Habilitar Insights para Tenants. Uma lista de todos os tenants é exibida.
   
   

   

   
   
6. Para cada tenant, selecione as seguintes opções:
   • Insights habilitado - Marque esta caixa para habilitar o Insights para o tenant selecionado.
   • Idioma do Painel - O idioma desejado para seu painel.
   • Substituir Recursos - Selecione Cube para excluir e recriar o cubo de dados do Insights e Painéis se você quiser substituir todos os painéis incluídos do OOTB por novos painéis do OOTB.
   • Acesso ao Painel - Selecione as funções de usuário/grupos que recebem acesso ao Insights

     Painéis padrão das seguintes opções:

Todos - os painéis padrão são compartilhados com todos os usuários do Insights.

Consumidores - os painéis padrão são compartilhados apenas com usuários que têm permissões de Visualização para o Insights.

Editores - os painéis padrão são compartilhados apenas com usuários que têm permissões de Edição para o Insights.

Administrador do Insights - os painéis padrão não são automaticamente compartilhados com qualquer usuário do Insights, ao invés disso, o usuário Administrador do Insights os compartilha manualmente do portal do Insights.

• Backfill - Marque para habilitar um preenchimento de dados históricos e insira o número desejado de dias no campo de entrada.
  1. Clique em Avançar. Uma janela de aviso aparece e clique em OK para continuar.
  2. O(s) tenant(s) estão habilitados e sua instalação está concluída.
     Importante:

     Por padrão, nenhuma tabela personalizada será criada a partir desta versão. Você deve adicionar processos e filas a uma lista de permissões por meio da opção Gerenciar Tabelas Personalizadas na Ferramenta de Administração. A página Gerenciar Tabelas Personalizadas permite que você selecione tabelas de processos e de fila que deseja adicionar ao Insights Cube.

     Para implantações em que o número desejado de tabelas de processos e fila exceda o número máximo de 75 por tenant, habilitar o agrupamento de tabela permitirá a combinação de vários processos ou filas em uma única tabela de grupo.

Captação de logs para Implantações em Outros Idiomas

Para implantações usando dados não em inglês (incluindo executar UiPath Robot ou o Studio em um idioma diferente do inglês), algumas alterações devem ser feitas para garantir que todos os logs sejam captados corretamente:

Para que os logs históricos preencham durante a inicialização otimizada:

1. Abra o arquivo UiPath.InsightsAdminTool.exe.config localizado no diretório C:\Program Files (x86)\UiPath\Orchestrator\Tools.
2. Encontre a chave chamada "Insights.RobotLogsWarmStartupQueryCondition", substitua "execution ended" no valor com a tradução apropriada no idioma usado pela sua implantação.

Para a captação contínua de log:

1. Abra o arquivo UiPath.Orchestrator.dll.config localizado em C:\Program Files (x86)\UiPath\Orchestrator.
2. Encontre o when condition chamado level, e substitua execution ended pela string apropriada traduzida no idioma usado pela sua implantação:

• de > Ausführung beendet
• fr > Exécution terminée
• es-ES > Ejecución finalizada
• es-MX > Ejecución terminada
• ja > の実行が終了しました。
• ko > 실행이 종료되었습니다.
• zh-CN > 执行结束
• pt-pt > Execução terminada
• pt-BR > A execução terminou
• tr > Yürütme işlemi bitti
• ru > Выполнение завершено

Exemplos

• English

  <logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="false" minlevel="Info" writeTo="insightsRobotLogs"><filters defaultAction="Ignore"><when condition="level >= LogLevel.Error or ends-with('${message}',' execution ended')" action="Log" /></filters></logger>

• Português (BR)

  <logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="false" minlevel="Info" writeTo="insightsRobotLogs"><filters defaultAction="Ignore"><when condition="level >= LogLevel.Error or ends-with('${message}',' A execução terminou')" action="Log" /></filters></logger>

Observe que qualquer outra alteração de string para este when condition não é compatível e pode exigir uma reinstalação completa se implementada.

Como lidar com a vulnerabilidade do log4j

Para lidar com a vulnerabilidade do log4j, certifique-se de executar o hotfix para atualizar as dependências para a versão mais recente não vulnerável do Apache Log4j.

Para obter mais informações, consulte a seção UiPath Insights Advisory (anterior à versão 2021.10) seção no UiPath Security Advisory CVE-2021-44228, CVE-2021-45046 e CVE-2021-45105j.