Instalación

Prerrequisitos para la instalación

1. Asegúrate de cumplir con los requisitos de hardware y software para Insights.
2. Instala Orchestrator o modifica una instalación existente para habilitar la característica de Insights.
3. Asegúrate de haber seguido las instrucciones de Orchestrator. Este certificado ha de tener claves tanto públicas como privadas y debe estar instalado en el listado raíz de confianza de la máquina Insights.
4. Asegúrate de que el certificado de Insights se coloca en Raíz de confianza del equipo Orchestrator.
5. Al especificar un nombre de host para Insights, asegúrate de que el nombre de host deseado se pueda resolver dentro de tu DNS.
6. Comprueba que el servidor donde se vaya a instalar Insights pueda comunicarse con los servidores donde esté instalado Orchestrator y viceversa,
   Importante: Es preferible utilizar un certificado SAN SSL enviado a una entidad de certificación en lugar de uno autofirmado.

   Los certificados autofirmados (y aquellos de tu propia entidad de certificados) deben estar instalados tanto en el almacén de certificados Raíz de confianza como en el Personal en el equipo Insights. El certificado también deberá estar marcado como Exportable.

   Ten en cuenta que cuando utilices un certificado autofirmado puedes experimentar problemas al acceder a Insights a través de Firefox, Internet Explorer o Edge.

Modificación de una instalación de Orchestrator para Insights

1. Desde el panel de control de Windows, selecciona Agregar o quitar programas.
2. Selecciona tu Orchestrator de la lista y haz clic en Modificar.
3. Sigue las instrucciones del instalador en pantalla, seleccionando la característica Integración de Insights:
   
   

   

   
   
   Nota: Una vez finalice la instalación, también deberás actualizar tu licencia de host para asegurarte de que la característica de Insights esté activada.

Instalación de Insights

1. Ejecuta el instalador UiPathInsightsInstaller.exe como administrador. Se mostrará así el asistente de instalación de UiPath Insights.
2. Selecciona la casilla de verificación Marcar aquí para aceptar el contrato de licencia para aceptar las condiciones del contrato y luego haz clic en Siguiente. Se mostrará así la configuración de Insights Server.
   
   

   

   
   
3. Cambia la configuración del servidor como desees:
   • Nombre del host del sitio web: utilizado para identificar el dispositivo en el que está instalado Insights. De forma predeterminada, está establecido en el nombre del host de la máquina, pero se puede modificar. Este nombre debe ser resoluble desde un servidor externo.
   • Puerto del sitio web: el puerto que se utilizará para la comunicación con Insights. Está configurado como 443 de forma predeterminada para habilitar el uso de HTTPS.
   • Añadir reglas de firewall para este puerto: al seleccionarlo, añadirás automáticamente reglas de firewall para este puerto, para garantizar la seguridad de tu equipo.
     Importante: Insights utiliza la dirección IP de bucle invertido para la comunicación entre los diferentes servicios. Estos puertos no utilizan HTTPS, así que para evitar que se pueda acceder a los puertos desde otras máquinas, asegúrese de que solo el puerto 443 esté abierto para recibir conexiones de fuentes externas (es decir, direcciones IP distinta de 127.0.0.1).
   • Directorio de compilación de Insights: si se define, establece el directorio en el que se almacenarán los datos de Insights después de que se hayan importado y compilado en el sistema.
     Important: This field is not required, if left blank the installer uses the default directory. La carpeta no puede ser la raíz de la unidad - D:\ ni tener una barra final.

     Vuelve a comprobar la ruta de instalación seleccionada. No es posible mover una instalación desde una ubicación a otra después de la instalación.

   • Asunto de certificado SSL: el nombre de asunto del certificado SSL que quieres utilizar para conexiones seguras con Insights. De forma predeterminada, se rellena con el nombre completo del equipo, pero puede modificarse.

Nota: el asunto del certificado SSL debe coincidir con el nombre de host del sitio web proporcionado anteriormente. Si utilizas un certificado existente, debe estar marcado como exportable y estar instalado en el almacenamiento de certificados personales de la máquina local.

• Crear un certificado autofirmado: si se selecciona, crea automáticamente un certificado autofirmado con el nombre del asunto especificado anteriormente. Consulta aquí si vas a utilizar Edge o Internet Explorer con certificados autofirmados.
  Importante: No recomendamos habilitar la opción Crear un certificado autofirmado porque es preferible utilizar un certificado SAN SSL enviado a una entidad de certificación.

  Si también utilizas un certificado autofirmado en tu máquina Orchestrator, los certificados de Orchestrator e Insights deben añadirse al listado raíz de confianza en ambas máquinas.

• Correo electrónico: el correo electrónico del usuario administrador local de Insights.

Nota: esta no debe coincidir con la dirección de correo electrónico de ningún usuario definido en Orchestrator.

• Contraseña: la contraseña para el usuario administrador local de Insights. Debe tener entre 8 y 20 caracteres y contener al menos 1 letra mayúscula, 1 letra minúscula, 1 número y 1 carácter especial (!, @, #, $, % ^, &, *).
  1. Haz clic en Siguiente. Se mostrará así la configuración de la base de datos de Insights.
     
     

     

     
     
  2. Rellena los detalles de la base de datos de la siguiente forma:
• Nombre del servidor del host: el nombre del equipo SQL Server donde está ubicada la base de datos de Insights. También puedes especificar un número de puerto personalizado aquí utilizando los dos puntos, como sql.uipath.com:1733.
• Nombre de la base de datos: el nombre de la base de datos de Insights especificada al instalar Orchestrator.
• Autenticación de Windows: si se selecciona, la conexión a Insights se llevará a cabo utilizando una cuenta de dominio. Consulta los pasos de configuración adicionales a continuación.
• Autenticación SQL: si se selecciona, la conexión a Insights se llevará a cabo utilizando la autenticación SQL. Si utilizas esta opción, los campos Nombre de usuario y Contraseña se podrán editar y deberás proporcionar el nombre de usuario y la contraseña SQL utilizados para conectarse a la base de datos.
  1. Haz clic en Siguiente. Se muestra la configuración de Orchestrator.
     
     

     

     
     
  2. Proporciona los detalles de la conexión para tu instancia de Orchestrator, de la siguiente forma:
• Punto final de Orchestrator - la URL de tu Orchestrator.
• Nombre de usuario - el nombre de usuario del tenant del Host. De forma predeterminada, es admin y no puede modificarse.
• Contraseña - la contraseña de la cuenta de administrador del Host.
  1. Haz clic en Siguiente. Se muestra la Configuración de la base de datos de Orchestrator.
     
     

     

     
     
  2. Rellena los detalles de la base de datos de Orchestrator, de la siguiente forma:
• Nombre de servidor de host: el nombre del equipo SQL Server donde está ubicada la base de datos de Orchestrator. También puedes especificar un número de puerto personalizado aquí utilizando los dos puntos, como sql.uipath.com:1733.
• Nombre de la base de datos: el nombre de la base de datos de Orchestrator especificada al instalar Orchestrator.
• Autenticación de Windows: si se selecciona, la conexión se llevará a cabo utilizando una cuenta de dominio.
• Autenticación SQL: si se selecciona, la conexión se llevará a cabo utilizando la autenticación SQL. Si utilizas esta opción, los campos Nombre de usuario y Contraseña se podrán editar y deberás proporcionar el nombre de usuario y la contraseña SQL utilizados para conectarse a la base de datos.
  1. Haz clic en Siguiente. Se mostrará así la configuración del servidor de correo electrónico.
     
     

     

     
     
     Nota: Si no configuras un servidor de correo electrónico, no se enviarán alertas ni notificaciones de correo electrónico de Insights. No obstante, podrás añadir una configuración del servidor de correo electrónico después de la instalación utilizando la función Modificar o la característica de Windows de agregar o quitar programas.
  2. Si lo deseas, configura tu servidor de correo electrónico para las notificaciones de Insights, de la siguiente forma:
• Host SMTP: escribe tu host SMTP.
• Puerto SMTP: escribe tu puerto SMTP. Por defecto se establece en 25, pero se puede modificar.
• Configuración TLS: utilizada para establecer la configuración de seguridad del servidor de correo electrónico. Tiene las siguientes opciones:
  • Segura: si se marca, la conexión utilizará TLS.
  • Ignorar TLS: si se selecciona (y Segura no), no se utilizará TLS. Select this option when connecting to a non-secure SMTP server.
  • Requerir TLS: si se selecciona (y **Segura no), necesitarás que la conexión se actualice a TLS, independientemente de la compatibilidad del servidor de correo electrónico.
• Nombre de usuario SMTP: la dirección de correo electrónico de la que se envían los mensajes de correo electrónico.
• Contraseña SMTP: la contraseña para la dirección de correo electrónico utilizada anteriormente.
• Desde la dirección: la dirección de correo electrónico desde la que se envían los mensajes de correo electrónico. Debe coincidir con la que se proporcionó en Nombre de usuario SMTP anteriormente.
• Desde el nombre en pantalla: un nombre en pantalla para la dirección de correo electrónico.

• Configuración avanzada del servidor de correo electrónico: tiene las siguientes opciones:

  • Depurar: si se selecciona, Insight registra todo el tráfico SMTP. Solo debe utilizarse para la resolución de problemas.
  • Registrador: si se selecciona, Insights registra todos los eventos (p. ej., la conexión del servidor).
  • Tiempo de espera de la conexión: el tiempo, en milisegundos, que hay que esperar para que se establezca una conexión.
  • Tiempo de espera de la bienvenida: el tiempo, en milisegundos, que hay que esperar para recibir la bienvenida tras establecer una conexión.

  • Tiempo de espera del socket: la duración, en milisegundos, de la inactividad que se permitirá.

    1. Haz clic en Instalar. Se iniciará así el proceso de instalación. Una vez completado, haz clic en Cerrar para salir del instalador.
       Importante:

       Una vez que la instalación de Insights se haya completado:

       • Asegúrate de que el nivel de confianza .NET de la aplicación Sisense está establecido en Full.
       • Abre el archivo consts.js ubicado en el directorio C:\Program Files\Sisense\app\query-proxy-service\src\common y establece el parámetro HEALTH_CHECK_TIMEOUT en 100000.

Configuración de la autenticación de Windows

Si utilizas la autenticación de Windows para conectarte a la base de datos de Insights (paso 4, anteriormente), deberás modificar las propiedades del inicio de sesión de los servicios Sisense.CLRConnectorsContainer y Sisense.JVMConnectorsContainer de la siguiente forma:

Nota: Si la cuenta que lleva a cabo este proceso no fue la que se utilizó al ejecutar el instalador de Insights, asegúrate de que forme parte del grupo administrador local.

1. Abre el administrador de servicios de Windows.
2. Haz clic con el botón derecho en Sisense.CLRConnectorsContainer y selecciona Propiedades.
3. En la ficha Iniciar sesión, selecciona el botón de selección Esta cuenta.
4. Escribe el nombre de usuario y la contraseña de la cuenta utilizada para conectarte a la base de datos SQL de Insights y haz clic en Aceptar.
5. Repite este proceso para el servicio Sisense.JVMConnectorsContainer.
6. Reinicia ambos servicios.

Configuración del tenant

Una vez se haya instalado Insights, deberás habilitarlo para tus tenants deseados utilizando la utilidad UiPath.InsightsAdminTool.exe.

Importante:

Cada tenant habilitado desencadena un proceso de "arranque en caliente" que recupera datos para la base de datos de Insights por el número de días de relleno que hayas configurado.

Dependiendo del volumen de datos y de las capacidades del hardware, pueden pasar varias horas antes de que todos los datos del tenant sean procesados y se puedan visualizar en Insights.

1. En el equipo donde está instalado Insights, ve al directorio \Orchestrator\Tools. Por ejemplo, cd C:\Program Files (x86)\UiPath\Orchestrator\Tools.
2. Ejecuta la utilidad UiPath.InsightsAdminTool.exe:
   
   

   

   
   
3. En el campo Usuario, introduce el usuario administrador del tenant host de Orchestrator. Es admin de forma predeterminada y no puede cambiarse.
4. Introduce la Contraseña del tenant host de Orchestrator y haz clic en Iniciar sesión. Se mostrará la ventana Seleccionar una característica.
   Importante: Insights 20.10.0 tiene un problema menor conocido en el panel de ROI. Por favor, visita las notas de la versión enlazadas para obtener instrucciones sobre cómo solventar este problema mediante la configuración del tenant.
   
   

   

   
   
5. Selecciona Habilitar Insights para los Tenants. Se mostrará así una lista de todos los tenants.
   
   

   

   
   
6. Para cada tenant, selecciona las siguientes opciones:
   • Insights habilitado: marca esta casilla para habilitar Insights para el tenant seleccionado.
   • Idioma del panel: el idioma deseado para tu panel.
   • Reemplazar recursos: selecciona Cubo para eliminar y reconstruir el cubo de datos de Insights; y Paneles si quieres reemplazar todos los paneles que incluyen OOTB con nuevos paneles OOTB.
   • Acceso a los paneles: selecciona los roles de usuarios/grupos que tienen acceso a Insights

     Paneles predeterminados de las siguientes opciones:

Todos: los paneles predeterminados se compartirán con todos los usuarios de Insights.

Consumidores: los paneles predeterminados se compartirán solo con los usuarios que tengan permisos de visualización para Insights.

Editores: los paneles predeterminados se compartirán solo con los usuarios que tengan permisos de edición para Insights.

Administrador de Insights: los paneles predeterminados no se compartirán automáticamente con ningún usuario de Insights; en cambio, el usuario administrador de Insights los compartirá manualmente desde el portal Insights.

• Reposición: marca esta casilla para habilitar una reposición de datos históricos e introduce el número de días deseado en el campo de entrada.
  1. Haz clic en Siguiente. Aparecerá así una ventana de advertencia; haz clic en Aceptar para continuar.
  2. Se habilitarán así los tenants y tu instalación habrá finalizado.
     Importante:

     De forma predeterminada, no se crearán tablas personalizadas a partir de esta versión. Deberás añadir procesos y colas a una lista de permitidos a través de la opción Administrar tablas personalizadas en la herramienta de administración. La página Administrar tablas personalizadas te permite seleccionar qué tablas de procesos y colas quieres añadir a Insights Cube.

     Para las implementaciones en las que el número deseado de tablas de procesos y colas supera el número máximo de 75 por tenant, habilitar la agrupación de tablas permitirá la combinación de múltiples procesos o colas en una sola tabla de grupo.

Toma de registros para despliegues en idiomas distintos al inglés

Para las implementaciones que utilizan datos que no son en inglés (que incluyen la ejecución de UiPath Robots o Studio en un idioma distinto al inglés), se deberán llevar a cabo algunos cambios para que todos los registros se ingieran correctamente:

Para que los registros históricos se repongan durante el arranque en caliente:

1. Abre el archivo UiPath.InsightsAdminTool.exe.config ubicado en el directorio C:\Program Files (x86)\UiPath\Orchestrator\Tools.
2. Busca la clave llamada "Insights.RobotLogsWarmStartupQueryCondition" y sustituye "execution ended" (ejecución finalizada) en el valor con la traducción correspondiente en el idioma utilizado en tu implementación.

Para la ingestión continua de registros:

1. Abre el archivo UiPath.Orchestrator.dll.config ubicado en C:\Program Files (x86)\UiPath\Orchestrator.
2. Busca el when condition llamado level y sustituye execution ended con la cadena traducida correspondiente en el idioma utilizado en tu implementación:

• 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 > Выполнение завершено

Ejemplos

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

Ten en cuenta que cualquier otro cambio en la cadena de este when condition no es compatible y puede requerir una reinstalación completa del producto si se implementa.

Cómo hacer frente a la vulnerabilidad de log4j

Para hacer frente a la vulnerabilidad de log4j, asegúrate de ejecutar la revisión para actualizar las dependencias a la versión no vulnerable más reciente de Apache Log4j.

Para obtener más información, consulta, la sección Consejos para UiPath Insights (anteriores a la versión 2021.10) sección en Consejos para seguridad de UiPath CVE-2021-44228, CVE-2021-45046 y CVE-2021-45105j.