Parallels-RAS-Logs: der vollständige Leitfaden zur Fehlersuche

Die Analyse der Parallels-RAS-Logs ist die wichtigste Fähigkeit für jeden Administrator, der eine leistungsfähige VDI-Infrastruktur betreiben will. Wenn Ihre Benutzer über Langsamkeit oder Verbindungsfehler klagen, werden diese Logdateien zu Ihren besten Verbündeten. Zu wissen, wo man suchen und welche Datei man öffnen muss, kann die mittlere Zeit bis zur Lösung (MTTR) drastisch verkürzen. In diesem Artikel erläutern wir die Rolle jeder Komponente, die betriebssystemspezifischen Speicherorte der Client-Logs und den Umgang mit den Protokollierungsstufen.

Der universelle Speicherort der Parallels-RAS-Logs (Serverseite)

Bevor wir auf die einzelnen Rollen eingehen, sollten Sie den Standardpfad auf Ihren Servern kennen. Bei praktisch allen Windows-Komponenten (Broker, Gateway, Agent) liegen die Logdateien hier:

C:ProgramDataParallelsRASLogs

Hinweis: Für den Zugriff auf diesen Ordner sind lokale Administratorrechte erforderlich. Manche Unterkomponenten wie Reporting oder Monitoring haben eigene Unterverzeichnisse.

Speicherorte der Logs nach Client-Typ

Die Fehlersuche beginnt oft am Endgerät. Hier finden Sie die Logdateien, je nachdem, welches Gerät der Endbenutzer verwendet:

• Windows: %AppData%2XClientClientLog.txt
• macOS: ~/Library/Containers/com.2X.Client.Mac/Data/ParallelsClient.log
• Linux: ~/.config/2X/Client/ClientLog.log
• IGEL OS: /userhome/.config/2X/Client/ClientLog.log
• Android: /storage/emulated/0/Android/data/com.parallels.client/files/logs/
• Web Client (HTML5): Die Logs liegen serverseitig auf dem Gateway: %ProgramData%ParallelsRASLogsHTML5GW.log

Die Struktur der Logs entschlüsseln

Parallels-RAS-Logs folgen einer genauen Syntax, die Ihnen hilft, Ereignisse miteinander in Beziehung zu setzen. So ist eine typische Logzeile aufgebaut:

[I00/00000123/T1EB8/P1988] 24-01-23 06:41:22 - Module version 19.1.1

Feld	Bedeutung	Rolle
MODULE	Komponenten-ID	Eindeutige Kennung der RAS-Komponente (z. B. I00)
ID	ID des Logeintrags	Fortlaufende Nummer des Eintrags
T (ThreadID)	Thread-ID	Kennung des Threads, der den Eintrag erzeugt hat
P (ProcessID)	Prozess-ID	PID des zugehörigen Windows-Prozesses
SESSIONID	Sitzungs-ID	(Optional) Identifiziert die konkrete Benutzersitzung
CORRELATIONCODE	Korrelations-ID	Eindeutiger Code, um eine Abfolge von Aktionen über mehrere Logdateien hinweg zu verfolgen

Der Broker: das Herz des Systems

Der Publishing Agent (Broker) ist das Gehirn Ihrer Umgebung. Seine Logs sind für den Gesamtzustand der Farm am wichtigsten.

• controller.log — Die Hauptdatei. Protokolliert die globale Aktivität, die Lastverteilung und die Kommunikation zwischen den Agents. Ihr Ausgangspunkt.
• licensing.log — Verwaltet Aktivierung und Lizenzkontingente. Wird der Zugriff wegen fehlender Lizenzen verweigert, schauen Sie zuerst hier nach.
• redundancy.log — Entscheidend in HA-Umgebungen, um die Synchronisierung zwischen den Brokern zu verfolgen.
• powershell.log — Unverzichtbar für das Debugging von Automatisierungs- und Bereitstellungsskripten.

Secure Gateway und Enrollment Server

Secure Gateway

• HTML5GW.log — Sehr umfangreich, da es jede WebSocket-Interaktion im Webportal protokolliert. Ideal, um Verbindungsabbrüche im Browsermodus zu diagnostizieren.
• gateway.log — Behandelt den gekapselten RDP-Verkehr der Thick Clients (Windows/Mac). Damit prüfen Sie, ob der SSL-Datenstrom durchkommt (Port 443).

Enrollment Server (SSO)

• EnrollServer.log — Protokolliert die Ausstellung kurzlebiger Zertifikate. Klappt die SAML-Authentifizierung, aber die Windows-Sitzung öffnet sich nicht, steht der Fehler hier.
• UserLogs — Ein nach Benutzern aufgeteilter Ordner, um Vorfälle zu isolieren, ohne die Gesamtanalyse zu verwässern.

Den Verbose-Modus beherrschen (Protokollierungsstufen)

Standardmäßig protokolliert RAS nur das Nötigste. Bei komplexen Bugs wechseln Sie in der RAS-Konsole über Tools > Options > Logging in den Verbose-Modus.

• Standardstufe: In der Produktion empfohlen, um Speicherplatz zu sparen.
• Verbose-Stufe: Erfasst jedes technische Detail.

Profi-Tipp: Sie können die Protokollierung für eine festgelegte Dauer aktivieren (z. B. 30 Minuten). RAS schaltet den Verbose-Modus nach Ablauf automatisch ab und verhindert so, dass ein vergessener Schalter den Speicher volllaufen lässt.

Expertentipp: das Systray-Tool

Auf Servern mit einem RAS-Agent befindet sich ein Parallels-Symbol im Infobereich der Taskleiste. Per Rechtsklick öffnen Sie sofort den Log-Ordner oder starten Dienste neu, ohne den Umweg über die Konsole.

Korrelationstabelle für die schnelle Fehlersuche

Art des Problems	Erster Reflex (Client)	Zweiter Reflex (Server)
Verbindungsfehler	Client-Log (Port 443)	gateway.log
SSO-/SAML-Fehler	Client-Log (Auth Flow)	EnrollServer.log
App startet nicht	Client-Log (Exit Code)	controller.log
Instabile Websitzung	Browserkonsole (F12)	HTML5GW.log

Die RAS-Insider-App ist kostenlos im App Store erhältlich: https://apps.apple.com/us/app/rasinsider/id6761124880