- Introdução
- Acesso e permissões
- Instalação e atualização
- Interação com o Insights
- Exportação de dados históricos
- Logs
- Desempenho e escalabilidade
Soluções para erros comuns e configurações incorretas encontradas durante a instalação do Insights, com orientação sobre a captura de logs para suporte.
Essa página fornece uma visão geral dos erros e equívocos comuns que podem ocorrer durante a instalação do Insights e métodos para evitá-los ou solucioná-los.
Para melhorar o tempo de resposta e a eficiência da equipe de suporte, certifique-se de descobrir como capturar logs, se necessário, para depurar na página Capturando logs .
Certifique-se de ter seguido atentamente as instruções de Instalação do Insights.
Configuração de regras de log
Se os logs não estiverem fluindo no padrão pretendido (ou seja, todos os logs, ou apenas os últimos logs ou logs de erro), certifique-se de que sua configuração esteja correta.
Erros de certificado
-
Se estiver usando certificados autoassinados, você deve utilizar o FQDN para seu servidor (ou seja,
insights.corp.uipath.com, nãoinsights). -
O certificado do Orchestrator deve ser colocado no armazenamento da Raiz confiável da máquina local na máquina do Insights.
-
Se você estiver encontrando erros ao tentar alterar seu certificado do Insights, certifique-se de seguir as instruções fornecidas em Atualização de seu certificado do Insights.
-
O certificado do Insights deve ser colocado no armazenamento na Raiz confiável da máquina local na máquina do Orchestrator.
Observação:Se você estiver gerando um certificado autoassinado manualmente para o Insights, certifique-se de que ele esteja marcado como exportável com a chave privada e importado para o armazenamento pessoal.
Como alterar o idioma do Insights
A seleção do idioma do Insights é feita a partir das configurações de tenant do Orchestrator. Todos os usuários desse tenant compartilham o mesmo idioma.
Erros do TLS
O domínio especificado não existe ou não pode ser contatado
- O certificado do Orchestrator deve ser colocado no armazenamento da Raiz confiável da máquina local na máquina do Insights.
- O certificado do Insights deve ser colocado no armazenamento na Raiz confiável da máquina local na máquina do Orchestrator.
- Certifique-se de que o Orchestrator e o Insights tenham a mesma configuração do
TLS.
Problemas de conexão
- Verifique qual porta você especificou na instalação para certificar-se de que ela esteja habilitada na máquina e no Firewall do Windows.
Portal exibindo o erro 500 após a instalação
O Portal pode exibir um 500 por alguns motivos:
- Ocorreu algum erro com a IIS.
- Pode haver um problema com o aplicativo Insights, como configuração incorreta ou problemas com a conexão com o banco de dados.
Para verificar problemas do IIS,
Após instalar o Insights, se você acessar o Gerenciador do IIS > site do UiPath Insights > Logging, pode encontrar o seguinte erro:
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
Esse erro pode ocorrer se o Pacote de Hospedagem do IIS não tiver sido instalado corretamente.
Para corrigir esse problema, siga as seguintes etapas:
-
Acesse Adicionar ou remover programas, procure pelo Microsoft .NET Core e selecione Modificar.
-
Selecione Reparar na janela recém-aberta.
Para verificar se há problemas com o aplicativo Insights, vá para C:\ProgramData\UiPath Insights\ para verificar os logs do Insights. Se você não conseguir localizar o problema, entre em contato com o suporte da UiPath.
Se isso não resolver o problema, recomendamos desinstalar e reinstalar o Pacote de Hospedagem do IIS.
O Serviço de Publicação na World Wide Web (W3SVC) não é iniciado
Durante a instalação, você pode encontrar problemas de IIS. Se o serviço W3SVC não iniciar, você pode executar o comando a seguir.
net start w3svc
net start w3svc
Falha na migração do banco de dados durante a instalação
A instalação do Orchestrator pode falhar durante a migração do banco de dados do Insights se for preciso indexar um conjunto de dados grande.Se a instalação falhar e você receber o log de erro a seguir, System.Exception: Migration failed você deve usar os seguintes scripts para indexar manualmente RobotLogs e Queueitems.
Índice de RobotLogs
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
)
Índice de QueueItemEvents
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);
Índice de JobEvents
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
)
Problemas de desinstalação
Pool de aplicativos não removido
Quando desinstalar o Insights, você pode encontrar o seguinte error The port 443 (or 543) is being used by another web application or program. Isso pode ser causado pelo IIS ou um problema de desinstalação do Insight.
Para resolver esse problema, abra o IIS e remova UiPath Insights de Sites.
Em seguida, remova UiPath Insightse Provisioningdo pool de aplicativos.
Error de desinstalação causado pela ação do trabalhador
Quando desinstalar o Insights, você pode encontrar o seguinte erro The following applications should be closed before continuing the install: IIS Worker Process (Process Id: 6492 and Process Id: 8808) Isso pode ser causado pelo processo de trabalho w3wp.exe que ainda esteja em execução.
Para resolver esse problema, abra o console ou o PowerShell e execute o comando a seguir e depois selecione Tentar novamente na caixa de diálogo de erro para continuar a desinstalar o Insights.
net stop was /y
net start w3svc
net stop was /y
net start w3svc
Se esse comando não for bem-sucedido, talvez seja necessário reiniciar a máquina e executá-lo novamente.
Problemas diversos
- No primeiro uso do produto, se um painel estiver exibindo dados incompletos, isso pode ser causado por um cache. Tente ir para "Ações do painel" e selecionar "Limpar cache e atualizar".
- Atualizar as configurações do Looker na máquina Linux do Insights
Como acessar os logs
Se você realizou a instalação do Insights, siga as etapas a seguir para encontrar os logs gerados pelo instalador:
- Navegue até a pasta
%temp%ou%temp%/<sessionID>, onde o<sessionID>é o número inteiro da sessão em que você está. Exemplo:%temp%ou%temp%/2. O nome do arquivo de log éMSI*****.log, onde os asteriscos representam letras aleatórias. - Você pode encontrar os logs de instalação do Looker na pasta
%programdata%.
Se você tiver feito atualização para a versão mais recente, os logs de instalação do Looker ainda estarão localizados na pasta C:\Users\UserName_insights.
-
Você pode encontrar os logs do Portal do Insights e logs de Provisão no Visualizador de eventos do Windows. Use a opção Filtrar log atual para filtrar por Origem do evento.
Error de memória insuficiente
Issue
Ao configurar o Looker executando looker-initialization.sh em uma máquina Linux ou executando Deploy-Looker.ps1 remotamente a partir de uma máquina Windows, a configuração executa uma verificação do sistema para garantir que o ambiente atenda aos requisitos. Durante esta verificação do sistema, o seguinte erro pode ocorrer:
The looker server requires at least 16G Memory.
Possível causa
Devido à conversão de binário para decimal que pode ser diferente entre provedores de nuvem, esse erro pode ocorrer mesmo se você tiver 16 GB de memória.
Solução
Dependendo da situação, existem duas maneiras pelas quais você pode ignorar a verificação do sistema:
- Se você estiver usando
looker-initialization.sh, use a sinalização-b. - Se você estiver usando
Deploy-Looker.ps1, você pode passar o parâmetro-BypassSystemCheck.
Problemas de atualização
Migração do conjunto de dados falha durante a atualização
Durante a atualização, o tamanho da coluna ProcessingExceptionDetails na tabela dbo.QueueItem e da coluna HostMachineName na tabela dbo.JobEvents é alterado. Se você tiver um conjunto de dados grande, isso pode causar um tempo limite durante a atualização. Para evitar o problema, use o seguinte script para indexar manualmente os itens:
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
- Configuração de regras de log
- Erros de certificado
- Como alterar o idioma do Insights
- Erros do TLS
- O domínio especificado não existe ou não pode ser contatado
- Problemas de conexão
- Portal exibindo o erro 500 após a instalação
- O Serviço de Publicação na World Wide Web (W3SVC) não é iniciado
- Falha na migração do banco de dados durante a instalação
- Índice de RobotLogs
- Índice de QueueItemEvents
- Índice de JobEvents
- Problemas de desinstalação
- Pool de aplicativos não removido
- Error de desinstalação causado pela ação do trabalhador
- Problemas diversos
- Como acessar os logs
- Error de memória insuficiente
- Issue
- Possível causa
- Solução
- Problemas de atualização
- Migração do conjunto de dados falha durante a atualização