insights
2024.10
true
- 发行说明
- 入门指南
- 访问和权限
- 安装和升级
- 与 Insights 交互
- 历史数据导出
- 日志
- 性能和可扩展性
重要 :
请注意此内容已使用机器翻译进行了部分本地化。
Insights
Last updated 2024年10月25日
故障排除
本页概述了 Insights 安装过程中可能发生的常见错误和错误,以及避免或纠正这些错误的潜在方法。
为了缩短支持团队的响应时间并提高效率,请务必在“捕获日志”页面中了解如何在需要调试时捕获日志。
重要事项:请确保您已严格遵循 Insights 安装说明。
- 如果使用自签名的证书,则必须为服务器使用 FQDN
insights.corp.uipath.com
或insights
)。 - Orchestrator 证书必须放置在 Insights 计算机上的本地计算机受信任根存储中。
- 如果在尝试更改 Insights 证书时遇到错误,请确保遵循更新 Insights 证书中提供的说明。
-
Insights 证书必须放置在 Orchestrator 计算机上的本地计算机受信任根存储中。
注意:如果要手动生成 Insights 的自签名证书,请确保该证书已使用私钥标记为“可导出”并导入到个人存储中。
指定的域不存在或无法联系
- Orchestrator 证书必须放置在 Insights 计算机上的本地计算机受信任根存储中。
- Insights 证书必须放置在 Orchestrator 计算机上的本地计算机受信任根存储中。
- 确保 Orchestrator 和 Insights 具有相同的
TLS
设置。
由于以下几个原因,门户网站可能会显示 500 错误:
- IIS 出现问题。
- Insights 应用程序可能存在问题,例如配置不正确或数据库连接存在问题。
要验证 IIS 问题,
安装 Insights 后,如果您转到“IIS 管理器”>“UiPath Insights 网站”>“
Logging
”,您可能会收到以下错误:
There was an error while performing this operation.
Details:
Filename: \\?\C:\...your installation path
There was an error while performing this operation.
Details:
Filename: \\?\C:\...your installation path
如果未正确安装 IIS Hosting Bundle,则可能会发生此错误。
要解决此问题,请执行以下步骤:
- 转到“添加或删除程序”,搜索“Microsoft .NET Core” ,然后单击“修改”。
- 在新打开的窗口中单击“修复”。
要检查 Insights 应用程序是否存在问题,请转到
C:\ProgramData\UiPath Insights\
查看 Insights 日志。如果找不到问题,请联系 UiPath 支持团队。
注意:如果这不能解决问题,我们建议卸载然后重新安装 IIS Hosting Bundle。
如果必须为大量数据建立索引,则 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 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 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
)
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
net stop was /y
net start w3svc
如果上述命令不成功,则可能需要重新启动计算机并重新运行。
- 首次使用产品时,如果仪表板数据显示不完整的问题可能是由于缓存所致。尝试转到“仪表板操作”,然后选择“清除缓存并刷新”。
- 更新 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.
在升级期间,
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
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