Het analyseren van Parallels RAS-logs is de belangrijkste vaardigheid voor elke beheerder die een goed presterende VDI-infrastructuur wil onderhouden. Wanneer je gebruikers last hebben van traagheid of verbindingsfouten, worden deze logbestanden je beste bondgenoten. Weten waar je moet zoeken en welk bestand je moet openen, kan de gemiddelde oplostijd (MTTR) drastisch verkorten. In dit artikel bespreken we de rol van elke component, de locaties van clientlogs per besturingssysteem en hoe je de logniveaus onder de knie krijgt.
De universele locatie van Parallels RAS-logs (serverzijde)
Voordat we de afzonderlijke rollen bespreken, is het belangrijk het standaardpad op je servers te kennen. Voor vrijwel alle Windows-componenten (Broker, Gateway, Agent) staan de logbestanden hier:
C:ProgramDataParallelsRASLogsOpmerking: voor toegang tot deze map zijn lokale beheerdersrechten nodig. Sommige subcomponenten, zoals Reporting of Monitoring, hebben hun eigen submappen.
Locaties van logs per type client
Probleemoplossing begint vaak bij het endpoint. Hier vind je de logbestanden, afhankelijk van het apparaat van de eindgebruiker:
- 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): de logs staan aan serverzijde op de Gateway:
%ProgramData%ParallelsRASLogsHTML5GW.log
De structuur van de logs ontcijferen
Parallels RAS-logs volgen een precieze syntaxis waarmee je gebeurtenissen aan elkaar kunt koppelen. Zo is een typische logregel opgebouwd:
[I00/00000123/T1EB8/P1988] 24-01-23 06:41:22 - Module version 19.1.1| Veld | Betekenis | Rol |
|---|---|---|
| MODULE | Component-ID | Unieke identificatie van de RAS-component (bijv. I00) |
| ID | ID van de logregel | Volgnummer van de regel |
| T (ThreadID) | Thread-ID | Identificatie van de thread die de regel heeft aangemaakt |
| P (ProcessID) | Proces-ID | PID van het bijbehorende Windows-proces |
| SESSIONID | Sessie-ID | (Optioneel) Identificeert de specifieke gebruikerssessie |
| CORRELATIONCODE | Correlatie-ID | Unieke code om een reeks acties over meerdere logbestanden te volgen |
De Broker: het hart van het systeem
De Publishing Agent (Broker) is het brein van je omgeving. Zijn logs zijn het belangrijkst voor de algehele gezondheid van de farm.
- controller.log — Het hoofdbestand. Registreert de globale activiteit, de loadbalancing en de communicatie tussen agents. Je startpunt.
- licensing.log — Beheert activering en licentiequota. Wordt de toegang geweigerd door onvoldoende licenties, kijk dan eerst hier.
- redundancy.log — Essentieel in HA-omgevingen om de synchronisatie tussen Brokers te volgen.
- powershell.log — Onmisbaar voor het debuggen van automatiserings- en uitrolscripts.
Secure Gateway en Enrollment Server
Secure Gateway
- HTML5GW.log — Erg omvangrijk, omdat het elke WebSocket-interactie in het webportaal vastlegt. Ideaal om verbroken verbindingen in browsermodus te diagnosticeren.
- gateway.log — Verwerkt het ingekapselde RDP-verkeer van de thick clients (Windows/Mac). Gebruik het om te controleren of de SSL-stroom doorkomt (poort 443).
Enrollment Server (SSO)
- EnrollServer.log — Legt de uitgifte van kortlevende certificaten vast. Slaagt de SAML-authenticatie maar opent de Windows-sessie niet, dan staat de fout hier.
- UserLogs — Een map die per gebruiker is opgesplitst, zodat je incidenten kunt isoleren zonder de totale analyse te vertroebelen.
De Verbose-modus beheersen (logniveaus)
Standaard legt RAS alleen het strikt noodzakelijke vast. Voor complexe bugs schakel je over naar Verbose-modus via Tools > Options > Logging in de RAS-console.
- Standaardniveau: aanbevolen in productie om schijfruimte te sparen.
- Verbose-niveau: legt elk technisch detail vast.
Tip van een pro: je kunt het loggen voor een vaste duur inschakelen (bijv. 30 minuten). RAS schakelt de Verbose-modus daarna automatisch uit, zodat een vergeten schakelaar je opslag niet volloopt.
Experttip: de systray-tool
Op servers met een RAS-agent staat een Parallels-pictogram in het systeemvak. Met een rechtermuisklik open je direct de logmap of herstart je services, zonder via de console te gaan.
Correlatietabel voor snelle probleemoplossing
| Type probleem | Eerste reflex (client) | Tweede reflex (server) |
|---|---|---|
| Verbindingsfout | Clientlog (poort 443) | gateway.log |
| SSO-/SAML-fout | Clientlog (Auth Flow) | EnrollServer.log |
| App start niet | Clientlog (Exit Code) | controller.log |
| Instabiele websessie | Browserconsole (F12) | HTML5GW.log |
De RAS Insider-app is gratis beschikbaar in de App Store: https://apps.apple.com/us/app/rasinsider/id6761124880
