安装

安装前所需的必备程序

1. 确保您满足 Insights 的硬件和软件要求。
2. 安装 Orchestrator 或修改现有安装，以启用 Insights 功能。
3. 确保已按照 Orchestrator 说明操作。此证书必须同时具有公钥和密钥，且必须安装在 Insights 计算机“受信任的根”中。
4. 确保将 Insights 证书放置在 Orchestrator 计算机的受信任根中。
5. 为 Insights 指定主机名时，请确保所需主机名在 DNS 中可解析。
6. 确认将要安装 Insights 的服务器可以与已安装 Orchestrator 的服务器建立通信，反之亦然，
   重要事项：最好使用提交给证书颁发机构的 SAN SSL 证书，而不是使用自签名证书。

   自签名证书（以及您自己的证书颁发机构中的证书）必须同时安装在 Insights 计算机上受信任的根和个人证书存储区中。证书还必须标记为可导出。

   请注意，使用自签名证书时，如果通过 Firefox、Internet Explorer 或 Edge 访问 Insights，您可能会遇到问题。

修改 Orchestrator 安装以获取 Insights

1. 从 Windows“控制面板”中选择“添加或删除程序”。
2. 从列表中选择您的 Orchestrator ，然后单击“修改”。
3. 按照屏幕上的安装程序，选择“Insights 集成”功能：
   
   

   

   
   
   注意：安装完成后，还必须更新主机许可证，以确保激活 Insights 功能。

Insights 安装

1. 以 Administrator 身份运行 UiPathInsightsInstaller.exe 安装程序。系统将显示“UiPath Insights 安装程序”向导。
2. 选中“ 选中此处以接受许可协议 ” 复选框以同意协议中的条款，然后单击 “下一步”。 系统将显示“ Insights Server 配置 ”。
   
   

   

   
   
3. 根据需要更改服务器配置：
   • “网站主机名”- 用于标识安装 Insights 的设备。默认情况下，这设置为计算机主机名，但可以编辑。此名称必须可从外部服务器解析。
   • “网站端口”- 用于 Insights 通信的端口。默认情况下，它设置为 443，以启用 HTTPS。
   • “为此端口添加防火墙规则”- 如果选中，将自动为此端口添加防火墙规则，以确保计算机的安全。
     重要事项：Insights 使用环回 IP 地址实现不同服务之间的通信。这些端口未使用 HTTPS，因此，为防止其他计算机访问这些端口，请确保只开放 443 端口接收外部来源的连接（即127.0.0.1 以外的 IP 地址）。
   • “Insights 生成目录”- 如果已定义，请设置 Insights 数据在导入并内置到系统后将存储到的目录。
     重要事项：此字段非必填，如果留空，安装程序将使用默认目录。该文件夹不能是硬盘的根目录 - D:\ 或带有斜杠。

     仔细检查选定的安装路径。不支持将安装从一个位置移动到另一个安装后位置。

   • “SSL 证书主题”- 要用于保护与 Insights 连接的 SSL 证书的主题名称。默认情况下，这用完整的计算机名称填充，但可以编辑。

注意：SSL 证书主题必须与上面提供的网站主机名匹配。如果使用现有证书，则必须将其标记为可导出，并将其安装在“本地计算机个人证书存储区”下。

• 创建自签名证书 - 如果选中，将自动创建具有上述主题名称的自签名证书。有关将 Edge 或 Internet Explorer 与自签名证书结合使用的相关信息，请参阅此处。
  重要事项：我们不建议启用“创建自签名证书”选项，因为首选使用提交给证书颁发机构的 SAN SSL 证书。

  如果还要在 Orchestrator 计算机上使用自签名证书，则必须将 Orchestrator 和 Insights 证书添加到两台计算机上的受信任根中。

• “电子邮件”- 本地 Insights 管理员用户的电子邮件。

注意：这不得与在 Orchestrator 中定义的任何用户的电子邮件地址匹配。

• “密码 ” - 本地 Insights 管理员用户的密码。 长度必须为 8-20 个字符，并且至少包含 1 个 大写字母、 1 个小写字母、 1 个 数字和 1 个 特殊字符（!、 @、 #、 $、 %、 ^、 &、 *）。
  1. 单击 “下一步”。 系统将显示“ Insights 数据库配置 ”。
     
     

     

     
     
  2. 填写数据库详细信息，如下所示：
• “主机服务器名称”- Insights 数据库所在的 SQL Server 计算机的名称。您也可以使用冒号（如 sql.uipath.com:1733）在此处指定自定义端口号。
• 数据库名称 - 安装 Orchestrator 时指定的 Insights 数据库的名称。
• “Windows 身份验证”- 如果选中，则使用域帐户与 Insights 建立连接。请参阅下面的其他配置步骤。
• “SQL 身份验证”- 如果选中，则使用 SQL 身份验证建立连接。如果使用此选项，则“用户名”和“密码”字段将变为可编辑状态，并且您必须提供用于连接到数据库的 SQL 用户名和密码。
  1. 单击“下一步”。系统将显示“Orchestrator 配置”窗口。
     
     

     

     
     
  2. 提供 Orchestrator 实例的连接详细信息，如下所示：
• Orchestrator 端点 - Orchestrator 的 URL。
• 用户 名 - 主机 租户的用户名。 默认情况下，这是 admin ，并且无法编辑。
• “密码 ” - 主机 管理员帐户的密码。
  1. 单击“下一步”。系统将显示“Orchestrator 配置”窗口。
     
     

     

     
     
  2. 填写 Orchestrator 数据库详细信息，如下所示：
• “主机服务器名称”- Orchestrator 数据库所在的 SQL Server 计算机的名称。您也可以使用冒号（如 sql.uipath.com:1733）在此处指定自定义端口号。
• 数据库名称 - 安装 Orchestrator 时指定的 Orchestrator 数据库的名称。
• “Windows 身份验证”- 如果选中，则使用域帐户建立连接。
• “SQL 身份验证”- 如果选中，则使用 SQL 身份验证建立连接。如果使用此选项，则“用户名”和“密码”字段将变为可编辑状态，并且您必须提供用于连接到数据库的 SQL 用户名和密码。
  1. 单击“下一步”。系统将显示“电子邮件服务器配置”窗口。
     
     

     

     
     
     注意： 如果不配置电子邮件服务器，则不会发送 Insights 电子邮件警示和通知。 但是，您可以在安装后使用 Windows“添加或删除程序”功能的“ 修改 ”功能添加电子邮件服务器配置。
  2. 如果需要，请配置电子邮件服务器以接收 Insights 通知，如下所示：
• SMTP 主机 - 输入您的 SMTP 主机。
• “SMTP 端口”- 输入您的 SMTP 端口。默认情况下，这设置为 25，但可以编辑。
• TLS 配置 - 用于设置电子邮件服务器的安全设置。 它具有以下选项：
  • 安全 - 如果选中，则连接将使用 TLS。
  • 忽略 TLS - 如果选中（并且未选中“ 安全 ”），则不会使用 TLS。 连接到非安全 SMTP 服务器时选择此选项。
  • “需要 TLS ” - 如果选中（并且未选中“**安全”），则无论电子邮件服务器支持如何，都需要将连接升级到 TLS。
• “SMTP 用户名”- 邮件的发件人电子邮件地址。
• SMTP 密码 - 上面使用的电子邮件地址的密码。
• “发件人地址”- 邮件的发件人电子邮件地址。它必须与为上述“SMTP 用户名”提供的电子邮件地址匹配。
• “默认发件人显示名称”- 电子邮件地址的显示名称。

• 高级电子邮件服务器配置 - 它具有以下选项：

  • “调试 ” - 如果选中，则 Insight 记录所有 SMTP 流量。 仅应用于故障排除。
  • 记录器 - 如果选中，则 Insights 会记录所有事件（例如 服务器连接）。
  • “连接超时 ” - 等待建立连接的时间（以毫秒为单位）。
  • “问候语超时 ” - 建立连接后等待问候语的时间（以毫秒为单位）。

  • “套接字超时 ” - 允许的不活动持续时间（以毫秒为单位）。

    1. 单击“安装”。安装过程将启动。完成后，单击“关闭”以退出安装程序。
       重要提示：

       Insights 安装完成后：

       • 确保将 Sisense 应用程序的.NET 信任级别设置为Full 。
       • 打开 C:\Program Files\Sisense\app\query-proxy-service\src\common 目录中的 consts.js 文件，并将 HEALTH_CHECK_TIMEOUT 参数设置为 100000。

Windows 身份验证配置

如果您使用 Windows 身份验证连接到 Insights 数据库（上述步骤 4），则必须修改 Sisense.CLRConnectorsContainer 和 Sisense.JVMConnectorsContainer 服务的登录属性，如下所示：

注意：如果执行此过程的帐户不是运行 Insights 安装程序时使用的帐户，请确保它属于本地管理员组。

1. 打开 Windows 服务管理器。
2. 右键单击“Sisense.CLRConnectorsContainer”，然后选择“属性”。
3. 从“ 登录” 选项卡中，选择“ 此帐户 ” 单选按钮。
4. 输入用于连接到 Insights SQL 数据库的帐户的用户名和密码，然后单击“ 确定”。
5. 对 Sisense.JVMConnectorsContainer 服务重复此过程。
6. 重新启动这两项服务。

租户设置

安装 Insights 后，必须使用 UiPath.InsightsAdminTool.exe 实用程序为所需的租户启用它。

重要提示：

每个启用的租户都会触发一个“热启动”过程，该过程将根据您配置的回填天数，将数据提取到 Insights 数据库中。

根据数据量和硬件功能，可能需要几个小时才能处理所有租户数据并可供在 Insights 中查看。

1. 在安装 Insights 的计算机上导航到 \Orchestrator\Tools 目录，例如 cd C:\Program Files (x86)\UiPath\Orchestrator\Tools。
2. 运行 UiPath.InsightsAdminTool.exe 实用程序：
   
   

   

   
   
3. 在“用户”字段中，输入 Orchestrator host 租户的管理员用户。默认情况下为管理员，无法更改。
4. 输入 Orchestrator host 租户的密码，然后单击“登录”。系统会显示“选择测试用例”窗口。
   重要事项：Insights 20.10.0 中的 ROI 仪表板存在较小的已知问题。请访问链接的版本说明，获取有关如何使用“租户设置”解决此问题的相关指示。
   
   

   

   
   
5. 选择“为租户启用 Insights”。随即显示所有租户的列表。
   
   

   

   
   
6. 对于每个租户，请选择以下选项：
   • “启用 Insights”- 选中此框即可为所选租户启用 Insights。
   • “仪表板语言”- 仪表板需要显示的语言。
   • “替换资源”- 请选择要删除和重建 Insights 数据 Cube 的“Cube”和“仪表板”（如果要将所有包含 OOTB 的仪表板替换为新的 OOTB 仪表板）。
   • “仪表板访问”- 选择有权访问 Insights 的用户角色/组

     以下选项中的“默认仪表板”：

“全部”- 默认仪表板与所有 Insights 用户共享。

“使用者”- 默认仅与具有 Insights 查看权限的用户共享仪表板。

“编辑者”- 默认仅与具有 Insights 编辑权限的用户共享仪表板。

“Insighs 管理员”- 默认不会自动与任何 Insights 用户共享仪表板，而是由 Insights 管理员用户通过 Insights 门户手动执行共享。

• “回填”- 勾选即可启用历史数据回填功能，并在输入字段中输入所需的天数。
  1. 单击“下一步”。出现警告窗口，单击“确定”继续。
  2. 租户已启用，安装已完成。
     重要提示：

     默认情况下，从此版本开始不会创建任何自定义表格。您必须通过管理工具中的“管理自定义表格”选项将流程和队列列入白名单。通过“管理自定义表格”页面，您可以选择要添加到 Insights Cube 中的流程和队列表。

     对于期望的流程和队列表格数量超过每个租户最大数量 75 的部署，启用表格分组可允许将多个流程或队列组合到一个组表格中。

非英语部署的日志提取

对于使用非英语数据的部署（包括使用英语以外的其他语言运行机器人或 Studio），必须进行一些更改以确保正确提取所有日志：

对于要在热启动期间回填的历史日志：

1. 打开 C:\Program Files (x86)\UiPath\Orchestrator\Tools 目录中的 UiPath.InsightsAdminTool.exe.config 文件。
2. 查找称为“Insights.RobotLogsWarmStartupQueryCondition”的密钥，并将值中的“执行已结束”替换为部署所用语言的适当翻译。

对于正在进行的日志提取：

1. 打开位于 C:\Program Files (x86)\UiPath\Orchestrator 的 UiPath.Orchestrator.dll.config 文件。
2. 找到名为 level 的 when condition，并将 execution ended 替换为部署所用语言翻译的适当字符串。

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

示例

• 英文

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

• 葡萄牙语 (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>

请注意，实施后，您将无法更改此 when condition 的任何其他字符串，并且可能需要重新安装完整产品。

解决 Log4j 漏洞

要解决 log4j 漏洞，请确保运行热修复程序以将依赖项更新到 Apache Log4j 的最新无漏洞版本。

有关更多信息，请参阅UiPath Insights 咨询（版本 2021.10 之前） UiPath 安全咨询 CVE-2021-44228、CVE-2021-45046 和 CVE-2021-45105j中的部分。