Fehlersuche und ‑behebung

Diese Seite bietet einen Überblick über häufige Fehler und Irrtümer, die bei der Installation von Insights auftreten können, sowie über mögliche Methoden, diese zu vermeiden oder zu beheben.

Um die Reaktionszeit und Effizienz des Supportteams zu verbessern, informieren Sie sich auf der Seite Erfassen von Protokollen , wie Protokolle erfasst werden, wenn dies für das Debuggen erforderlich ist.

Wichtig: Stellen Sie sicher, dass Sie die Anweisungen zur Insights-Installation genau befolgt haben.

Konfigurieren von Protokollregeln

Wenn die Protokolle nicht nach dem vorgesehenen Muster verlaufen (d. h. alle Protokolle oder nur die letzten Protokolle oder Fehlerprotokolle), stellen Sie sicher, dass Ihre Konfiguration korrekt ist.

Zertifikatfehler

• Wenn Sie selbstsignierte Zertifikate verwenden, müssen Sie den FQDN für Ihren Server verwenden (d. h. insights.corp.uipath.com oder insights).
• Das Orchestrator-Zertifikat muss im Zertifikatspeicher für lokale Maschinen mit vertrauenswürdigem Stamm auf der Insights-Maschine platziert werden.
• Wenn beim Versuch, Ihr Insights-Zertifikat zu ändern, Fehler auftreten, befolgen Sie die Anweisungen unter Aktualisieren Ihres Insights-Zertifikats.

• Das Insights-Zertifikat muss im Zertifikatspeicher für lokale Maschinen mit vertrauenswürdigem Stamm auf der Orchestrator-Maschine platziert werden.

  Hinweis: Wenn Sie ein selbstsigniertes Zertifikat für Insights manuell generieren, stellen Sie sicher, dass es mit dem privaten Schlüssel als exportierbar markiert und in den persönlichen Speicher importiert wird.

  
  

  

  
  

Ändern der Sprache von Insights

Die Auswahl der Insights-Sprache erfolgt über die Orchestrator-Mandanteneinstellungen. Alle Benutzer in diesem Mandanten verwenden dieselbe Sprache.

TLS-Fehler

Die angegebene Domäne ist nicht vorhanden oder kann nicht kontaktiert werden.

• Das Orchestrator-Zertifikat muss im Zertifikatspeicher für lokale Maschinen mit vertrauenswürdigem Stamm auf der Insights-Maschine platziert werden.
• Das Insights-Zertifikat muss im Zertifikatspeicher für lokale Maschinen mit vertrauenswürdigem Stamm auf der Orchestrator-Maschine platziert werden.
• Stellen Sie sicher, dass Orchestrator und Insights über die gleiche TLS-Einstellung verfügen.

Verbindungsprobleme

• Überprüfen Sie den Port, den Sie bei der Installation angegeben haben, um sicherzustellen, dass er auf der Maschine und in der Windows Firewall aktiviert ist.

Portal zeigt nach der Installation 500er Fehler an

Das Portal kann aus verschiedenen Gründen eine 500 anzeigen:

1. Bei IIS ist ein Fehler aufgetreten.
2. Möglicherweise liegt ein Problem mit der Insights-Anwendung vor, z. B. eine falsche Konfiguration oder Probleme mit der Datenbankverbindung.

Um IIS-Probleme zu überprüfen,

Wenn Sie nach der Installation von Insights zum IIS-Manager > UiPath Insights-Website > Logging gehen, wird möglicherweise der folgende Fehler angezeigt:

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

Dieser Fehler kann auftreten, wenn das IIS-Hostingpaket („Hosting Bundle“) nicht korrekt installiert wurde.

Führen Sie die folgenden Schritte aus, um dieses Problem zu beheben:

1. Gehen Sie zu Programme hinzufügen oder entfernen, suchen Sie nach Microsoft .NET Core und klicken Sie auf Ändern.
   
   

   

   
   
2. Klicken Sie im neu geöffneten Fenster auf Reparieren.
   
   

   

   
   

Um nach Problemen mit der Insights-Anwendung zu suchen, wechseln Sie zu C:\ProgramData\UiPath Insights\ , um die Insights-Protokolle zu überprüfen. Wenn Sie das Problem nicht finden können, wenden Sie sich an den UiPath-Support.

Hinweis: Wenn das Problem dadurch nicht gelöst wird, empfehlen wir die Deinstallation und anschließende Neuinstallation des IIS-Hostingpakets („Hosting Bundle“).

Der World Wide Web-Publishingdienst (W3SVC) wird nicht gestartet

Während der Installation können IIS-Probleme auftreten. Wenn der W3SVC-Dienst nicht gestartet werden kann, können Sie den folgenden Befehl ausführen.

net start w3svc

Die Datenbankmigration schlägt während der Installation fehl

Die Orchestrator-Installation kann während der Migration der Insights-Datenbank fehlschlagen, wenn sie einen großen Datensatz indizieren muss. Wenn die Installation fehlschlägt und Sie das folgende Fehlerprotokoll System.Exception: Migration failed erhalten, sollten Sie die folgenden Skripts verwenden, um die RobotLogs und Queueitems manuell zu indizieren.

RobotLogs-Index

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
    )

QueueItemEvents-Index

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

JobEvents-Index

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
)

Deinstallationsprobleme

Der Anwendungspool wurde nicht entfernt

Wenn Sie Insights deinstallieren, kann der folgende Fehler auftreten: The port 443 (or 543) is being used by another web application or program.. Dies kann durch IIS oder ein Insight-Deinstallationsproblem verursacht werden.

Um dieses Problem zu beheben, öffnen Sie IIS und entfernen Sie UiPath Insights aus Sites.

Entfernen Sie dann UiPath Insights und Provisioning aus den Anwendungspools.

Deinstallationsfehler, verursacht durch Arbeitsprozess

Wenn Sie Insights deinstallieren, kann der folgende Fehler auftreten: The following applications should be closed before continuing the install: IIS Worker Process (Process Id: 6492 and Process Id: 8808). Dies kann durch den w3wp.exe-Arbeitsprozess verursacht werden, der noch ausgeführt wird.

Um dieses Problem zu beheben, öffnen Sie die Konsole oder PowerShell, führen Sie den folgenden Befehl aus und klicken Sie dann im Fehlerdialogfeld auf Wiederholen, um die Insights-Deinstallation fortzusetzen.

net stop was /y
net start w3svc

Wenn der obige Befehl nicht erfolgreich ist, müssen Sie die Maschine möglicherweise neu starten und erneut ausführen.

Verschiedene Probleme

1. Wenn ein Dashboard bei der ersten Verwendung des Produkts unvollständige Daten anzeigt, kann dies an einem Cache liegen. Gehen Sie zu „Dashboard-Aktionen“ und wählen Sie dann „Cache leeren und aktualisieren“ aus.
2. Aktualisieren der Looker-Einstellungen auf der Insights Linux-Maschine.

Zugreifen auf Protokolle

Wenn Sie die Insights-Installation durchgeführt haben, führen Sie die folgenden Schritte aus, um die vom Installationsprogramm generierten Protokolle zu finden:

• Navigieren Sie zum Ordner %temp% oder %temp%/<sessionID>, in dem die <sessionID> die Ganzzahl der Sitzung ist, in der Sie sich befinden. Beispiel: %temp% oder %temp%/2. Der Name der Protokolldatei lautet MSI*****.log, wobei die Sternchen zufällige Buchstaben darstellen.
• Sie finden die Looker-Installationsprotokolle im Ordner %programdata%.
  Wenn Sie auf die neueste Version aktualisiert haben, befinden sich die Looker-Installationsprotokolle immer noch im Ordner C:\Users\UserName\_insights.
• Sie finden die Insights Portal-Protokolle und Bereitstellungsprotokolle in der Windows-Ereignisanzeige. Verwenden Sie die Option „Aktuelles Protokoll filtern“, um nach Ereignisquelle zu filtern.
  
  

  

  
  

Fehler wegen unzureichendem Speicher

Problem

Beim Einrichten von Looker durch Ausführen von looker-initialization.sh auf einer Linux-Maschine oder durch Remote-Ausführen von Deploy-Looker.ps1 auf einer Windows-Maschine führt das Setup eine Systemprüfung durch, um sicherzustellen, dass die Umgebung die Anforderungen erfüllt. Während dieser Systemprüfung kann der folgende Fehler auftreten:

The looker server requires at least 16G Memory.

Mögliche Ursache

Aufgrund der Konvertierung von binär nach dezimal, die je nach Cloud-Anbieter unterschiedlich sein kann, kann dieser Fehler auch bei 16 GB Speicher auftreten.

Lösung

Je nach Situation gibt es zwei Möglichkeiten, die Systemprüfung zu umgehen:

• Wenn Sie looker-initialization.sh verwenden, verwenden Sie das Flag -b.
• Wenn Sie Deploy-Looker.ps1 verwenden, können Sie den Parameter -BypassSystemCheck übergeben.

Upgrade-Probleme

Die Dataset-Migration schlägt während des Upgrades fehl

Während des Upgrades wird die Länge der Spalte ProcessingExceptionDetails im dbo.QueueItem und der Spalte HostMachineName in der Tabelle dbo.JobEvents geändert. Wenn Sie über ein großes Dataset verfügen, kann es während des Upgrades zu einer Zeitüberschreitung kommen. Um dies zu vermeiden, verwenden Sie das folgende Skript, um die Elemente manuell zu indizieren:

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