故障排除

针对安装 Insights 期间遇到的常见错误和配置错误的解决方案，包括有关捕获日志以获取支持的指南。

本页概述了 Insights 安装过程中可能发生的常见错误和错误，以及避免或纠正这些错误的潜在方法。

为了缩短支持团队的响应时间并提高效率，请务必在“捕获日志”页面中了解如何在需要调试时捕获日志。

重要提示：

请确保您已严格遵循 Insights 安装说明。

配置日志规则

如果日志未按预期模式流动（即所有日志，或仅最后一个日志或错误日志），请确保您的配置正确。

证书错误

• 如果使用自签名的证书，则必须为服务器使用 FQDN（即 insights.corp.uipath.com 而不是 insights）。

• Orchestrator 证书必须放置在 Insights 计算机上的本地计算机受信任根存储中。

• 如果在尝试更改 Insights 证书时遇到错误，请确保遵循更新 Insights 证书中提供的说明。

• Insights 证书必须放置在 Orchestrator 计算机上的本地计算机受信任根存储中。

  备注：

  如果要手动生成 Insights 的自签名证书，请确保该证书已使用私钥标记为可导出并导入到个人存储中。

  

更改 Insights 语言

从 Orchestrator 租户设置中选择 Insights 语言。该租户中的所有用户使用相同的语言。

TLS 错误

指定的域不存在或无法联系

• Orchestrator 证书必须放置在 Insights 计算机上的本地计算机受信任根存储中。
• Insights 证书必须放置在 Orchestrator 计算机上的本地计算机受信任根存储中。
• 确保 Orchestrator 和 Insights 具有相同的 TLS 设置。

连接问题

• 检查您在安装中指定的端口，以确保在计算机和 Windows 防火墙中启用。

门户在安装后显示 500 错误

由于以下几个原因，门户网站可能会显示 500 错误：

1. IIS 出现问题。
2. Insights 应用程序可能存在问题，例如配置不正确或数据库连接存在问题。

要验证 IIS 问题，

安装 Insights 后，如果您转到“IIS 管理器”>“UiPath Insights 网站”>“Logging”，您可能会收到以下错误：

There was an error while performing this operation.
Details:
Filename: \\?\C:\...your installation path

如果未正确安装 IIS Hosting Bundle，则可能会发生此错误。

要解决此问题，请执行以下步骤：

1. 转到“添加或删除程序” ，搜索“Microsoft .NET Core” ，然后选择“修改” 。

   

2. 在新打开的窗口中选择“修复” 。

   

要检查 Insights 应用程序是否存在问题，请转到 C:\ProgramData\UiPath Insights\ 查看 Insights 日志。如果找不到问题，请联系 UiPath 支持团队。

备注：

如果这不能解决问题，我们建议卸载然后重新安装 IIS Hosting Bundle。

万维网发布服务 (W3SVC) 未启动

在安装过程中，您可能会遇到 IIS 问题。如果 W3SVC 服务启动失败，您可以运行以下命令。

net start w3svc

安装期间数据库迁移失败

如果必须为大量数据建立索引，则 Orchestrator 安装可能会在 Insights 数据库迁移期间失败。如果安装失败并且您收到以下错误日志 System.Exception: Migration failed，则应使用以下脚本手动为 RobotLogs 和 Queueitems 建立索引。

机器人日志索引

IF NOT EXISTS(SELECT * FROM sys.indexes WHERE Name = 'IX_TenantId_ProcessName' and OBJECT_NAME(object_id) = 'RobotLogs')
    CREATE NONCLUSTERED INDEX [IX_TenantId_ProcessName] ON [dbo].[RobotLogs]
    (
        [TenantId] ASC,
        [ProcessName] ASC
    )

队列项目事件索引

if not exists (select * from sysindexes where id=object_id('dbo.QueueItemEvents') and name='TenantId_ProceStatus_QI_INDEX')
  CREATE NONCLUSTERED INDEX [TenantId_ProceStatus_QI_INDEX] ON dbo.QueueItemEvents (TenantId, ProcessingStatus) INCLUDE (QueueItemId);

作业事件索引

IF NOT EXISTS(SELECT * FROM sys.indexes WHERE Name = 'IX_JobEvents_JobId_TenantId' and OBJECT_NAME(object_id) = 'JobEvents')
CREATE NONCLUSTERED INDEX [IX_JobEvents_JobId_TenantId] ON [dbo].[JobEvents]
(
    [JobId] ASC,
    [TenantId] ASC
)

卸载问题

未删除应用程序池

卸载 Insights 时，可能会遇到以下错误 The port 443 (or 543) is being used by another web application or program.。这可能是由 IIS 或 Insight 卸载问题引起的。

要解决此问题，请打开 IIS 并从站点中删除 UiPath Insights。

然后从应用程序池中删除 UiPath Insights 和 Provisioning。

工作进程导致的卸载错误

卸载 Insights 时，可能会遇到以下错误 The following applications should be closed before continuing the install: IIS Worker Process (Process Id: 6492 and Process Id: 8808)。这可能是由仍在运行的 w3wp.exe 工作进程引起的。

要解决此问题，请打开控制台或 PowerShell 并运行以下命令，然后在错误对话框中选择“重试”以继续卸载 Insights。

net stop was /y
net start w3svc

如果此命令不成功，您可能需要重新启动计算机并重新运行。

其他问题

1. 首次使用产品时，如果仪表板数据显示不完整的问题可能是由于缓存所致。尝试转到“仪表板操作”，然后选择“清除缓存并刷新”。
2. 更新 Insights Linux 计算机上的 Looker 设置。

访问日志

如果您执行了 Insights 安装，请执行以下步骤以查找安装程序生成的日志：

• 导航至 %temp% 或 %temp%/<sessionID>文件夹，其中 <sessionID> 是您所在会话的整数。示例：%temp% 或 %temp%/2。日志文件的名称为 MSI*****.log，其中星号表示随机字母。
• 您可以在 %programdata% 文件夹中找到 Looker 安装日志。

如果您已升级到最新版本，则 Looker 安装日志仍位于 C:\Users\UserName_insights 文件夹中。

• 您可以在 Windows 事件查看器中找到 Insights 门户日志和配置日志。使用“筛选当前日志”选项按事件来源进行筛选。

  

内存不足错误

问题

通过在 Linux 计算机上运行 looker-initialization.sh 或通过 Windows 计算机远程运行 Deploy-Looker.ps1 来设置 Looker 时，安装程序会运行系统检查，以确保环境满足要求。在此系统检查期间，可能会发生以下错误：

The looker server requires at least 16G Memory.

可能的原因

由于云提供商之间从二进制到十进制的转换可能有所不同，因此即使您有 16 GB 内存，也可能会发生此错误。

解决方案

根据具体情况，有两种方法可以绕过系统检查：

• 如果您使用的是 looker-initialization.sh，请使用 -b 标志。
• 如果您使用的是 Deploy-Looker.ps1，则可以传递 -BypassSystemCheck 参数。

升级问题

升级期间数据集迁移失败

在升级期间，dbo.QueueItem 中的 ProcessingExceptionDetails 列和 dbo.JobEvents 中的 HostMachineName 列的长度会发生更改。如果您的数据集规模较大，这可能会在升级期间导致超时。为避免这种情况，请使用以下脚本手动为项目建立索引：

IF COL_LENGTH('[dbo].[QueueItems]', 'ProcessingExceptionDetails') IS NOT NULL 
AND 'Nvarchar' IN (
    SELECT DATA_TYPE FROM INFORMATION_SCHEMA.COLUMNS
    WHERE TABLE_NAME = 'QUEUEITEMS' 
        AND TABLE_SCHEMA = 'DBO' 
        AND COLUMN_NAME = 'PROCESSINGEXCEPTIONDETAILS'
)
BEGIN
    ALTER TABLE [dbo].[QueueItems]
    ALTER COLUMN ProcessingExceptionDetails NVARCHAR(MAX)
END

IF COL_LENGTH('[dbo].[JobEvents]', 'HostMachineName') IS NOT NULL 
AND 'Nvarchar' IN (
    SELECT DATA_TYPE FROM INFORMATION_SCHEMA.COLUMNS
    WHERE TABLE_NAME = 'JOBEVENTS' 
        AND TABLE_SCHEMA = 'DBO' 
        AND COLUMN_NAME = 'HOSTMACHINENAME'
)
BEGIN
    ALTER TABLE [dbo].[JobEvents]
    ALTER COLUMN HostMachineName NVARCHAR(MAX)
END