Résolution des problèmes

Cette page fournit une vue d'ensemble des erreurs courantes qui peuvent se produire lors de l'installation d'Insights et des méthodes potentielles à adopter pour les éviter ou les corriger.

Pour améliorer le temps de réponse et l'efficacité de l'équipe d'assistance, assurez-vous de savoir comment capturer les journaux si nécessaire pour déboguer dans la page Capturer les journaux ( Capturing logs) .

Important: assurez-vous d'avoir bien suivi les instructions d'installation d'Insights.

Configurer les règles de journalisation

Si les journaux ne circulent pas selon le modèle prévu (c'est-à-dire tous les journaux, ou uniquement les derniers journaux ou les journaux d'erreurs), assurez-vous que votre configuration est correcte.

Erreurs de certificat

• Si vous utilisez un certificat auto-signé, vous devez utiliser le NOM DE DOMAINE COMPLET de votre serveur (c'est-à-dire insights.corp.uipath.com et non insights).
• Le certificat Orchestrator doit être placé dans le magasin Racine approuvée de la machine locale (Local Machine Trusted Root) de la machine Insights.
• Si vous rencontrez des erreurs lorsque vous essayez de modifier votre certificat Insights, assurez-vous de suivre les instructions fournies dans Mise à jour de votre certificat Insights (Updating Your Insights Certificate).

• Le certificat Insights doit être placé dans le magasin Racine approuvée de la machine locale (Local Machine Trusted Root) de la machine Orchestrator.

  Remarque : Si vous générez manuellement un certificat auto-signé pour Insights, assurez-vous qu'il est marqué comme exportable avec la clé privée et importé dans le magasin personnel.

  
  

  

  
  

Modification de la langue d'Insights

La sélection de la langue d'Insights s'effectue à partir des paramètres du locataire Orchestrator. Tous les utilisateurs de ce locataire partagent la même langue.

Erreurs TLS

Le domaine spécifié n’existe pas ou ne peut pas être contacté

• Le certificat Orchestrator doit être placé dans le magasin Racine approuvée de la machine locale (Local Machine Trusted Root) de la machine Insights.
• Le certificat Insights doit être placé dans le magasin Racine approuvée de la machine locale (Local Machine Trusted Root) de la machine Orchestrator.
• Assurez-vous qu'Orchestrator et Insights sont paramétrés de la même manière TLS.

Problèmes de connexion

• Vérifiez le port que vous avez spécifié lors de l'installation pour vous assurer qu'il est activé dans la machine et dans le pare-feu Windows.

Portail affichant l'erreur 500 après l'installation

Le portail peut afficher une erreur 500 pour plusieurs raisons :

1. Une erreur s'est produite avec IIS.
2. Il peut y avoir un problème avec l'application Insights, comme une configuration incorrecte ou des problèmes avec la connexion à la base de données.

Pour vérifier les problèmes IIS,

Après l'installation d'Insights, si vous accédez au gestionnaire IIS > site Web UiPath Insights > Logging, vous pouvez obtenir l'erreur suivante :

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

Cette erreur peut se produire si IIS Hosting Bundle n'a pas été installé correctement.

Pour résoudre ce problème, procédez comme suit :

1. Accédez à Ajouter ou supprimer des programmes, recherchez Microsoft .NET Core et cliquez sur Modifier
   
   

   

   
   
2. Cliquez sur Réparer dans la nouvelle fenêtre ouverte.
   
   

   

   
   

Pour vérifier les problèmes avec l'application Insights, accédez à C:\ProgramData\UiPath Insights\ pour consulter les journaux Insights. Si vous ne parvenez pas à localiser le problème, veuillez contacter l'assistance UiPath.

Remarque : Si cela ne résout pas le problème, nous vous recommandons de désinstaller puis de réinstaller le pack d'hébergement IIS.

Le service de publication World Wide Web (W3SVC) ne démarre pas

Lors de l'installation, vous pouvez rencontrer des problèmes IIS. Si le service W3SVC ne démarre pas, vous pouvez exécuter la commande suivante.

net start w3svc

La migration de la base de données échoue lors de l'installation

L'installation d'Orchestrator peut échouer lors de la migration de la base de données Insights (Insights Database) si elle doit indexer un grand nombre de données. Si l'installation échoue et que vous obtenez le journal d'erreurs suivant System.Exception: Migration failed, vous devez utiliser les scripts suivants pour indexer manuellement RobotLogs et Queueitems.

Indice JournauxRobots (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
    )

Indice FileAttenteObjetÉvénement (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);

Index des ÉvènementTâches (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
)

Problèmes de désinstallation

Pool d'applications non supprimé

Lorsque vous désinstallez Insights, vous pouvez rencontrer l'erreur suivante The port 443 (or 543) is being used by another web application or program. Cela peut être dû à IIS ou à un problème de désinstallation d'Insight.

Pour résoudre ce problème, ouvrez IIS et supprimez UiPath Insights de Sites.

Supprimez ensuite UiPath Insights et Provisioning des pools d'applications.

Erreur de désinstallation causée par le processus de travail

Lorsque vous désinstallez Insights, vous pouvez rencontrer l'erreur suivante The following applications should be closed before continuing the install: IIS Worker Process (Process Id: 6492 and Process Id: 8808) Cela peut être dû au processus de travail w3wp.exe qui est toujours en cours d'exécution.

Pour résoudre ce problème, ouvrez la console ou PowerShell et exécutez la commande suivante, puis cliquez sur Réessayer (Retry) dans la boîte de dialogue d'erreur pour poursuivre la désinstallation d'Insights.

net stop was /y
net start w3svc

Si la commande ci-dessus échoue, vous devrez peut-être redémarrer la machine et la réexécuter.

Problèmes divers

1. Lors de la première utilisation du produit, si un tableau de bord affiche des données incomplètes, cela peut être dû à un cache. Essayez d'aller dans « Actions du tableau de bord » (Dashboard actions), puis sélectionnez « Effacer le cache et actualiser » (Clear cache and refresh).
2. Mettre à jour les paramètres Looker sur la machine Insights Linux.

Accéder aux journaux

Si vous avez effectué l'installation d'Insights, procédez comme suit pour rechercher les journaux générés par le programme d'installation :

• Accédez au dossier %temp% ou %temp%/<sessionID>, où <sessionID> est le nombre entier de la session dans laquelle vous vous trouvez. Exemple : %temp% ou %temp%/2. Le nom du fichier journal est MSI*****.log, où les astérisques représentent des lettres aléatoires.
• Vous pouvez trouver les journaux d'installation de Looker dans le dossier %programdata%.
  Si vous avez effectué la mise à niveau vers la dernière version, les journaux d'installation de Looker se trouvent toujours dans le dossier C:\Users\UserName\_insights.
• Vous pouvez trouver les journaux du portail Insights et les journaux d'enregistrement dans l'Observateur d'événements Windows. Utilisez l'option Filtrer le journal actuel pour filtrer par source d'événement.
  
  

  

  
  

Erreur de mémoire insuffisante

Problème

Lors de la configuration de Looker en exécutant looker-initialization.sh sur une machine Linux ou en exécutant à distance Deploy-Looker.ps1 à partir d'une machine Windows, la configuration exécute une vérification du système pour s'assurer que l'environnement répond aux exigences. Au cours de cette vérification du système, l'erreur suivante peut se produire :

The looker server requires at least 16G Memory.

Cause possible

En raison de la conversion de binaire en décimal qui peut différer d'un fournisseur de cloud à l'autre, cette erreur peut se produire même si vous disposez de 16 Go de mémoire.

Solution

Selon la situation, il existe deux manières de contourner la vérification du système :

• Si vous utilisez looker-initialization.sh, utilisez l'indicateur -b.
• Si vous utilisez Deploy-Looker.ps1, vous pouvez passer le paramètre -BypassSystemCheck.

Problèmes de mise à niveau

La migration du jeu de données échoue lors de la mise à niveau

Lors de la mise à niveau, la longueur de la colonne ProcessingExceptionDetails dans le dbo.QueueItem et de la colonne HostMachineName dans le tableau dbo.JobEvents est modifiée. Si vous avez un ensemble de données volumineux, cela peut entraîner un délai d'attente lors de la mise à niveau. Pour éviter cela, utilisez le script suivant pour indexer manuellement les éléments :

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