The LoadGen Suite has many options, and we support multiple testing technologies. It's possible that LoadGen can behave differently in some circumstances, in this case, our support staff can ask you to send debug logging. In this article, we will explain how to turn on debug logging per component.
Most of the logfiles of LoadGen will use rolling files, which means additional files will be created, with a default of 20 and a maximum size of 5MB. This can also be changed in the different component configuration files.
Debug logging will impact the performance of the software
When enabling debug logging you must consider this will have a performance impact on the debugged components. We advise disabling debug logging when running an actual test.
LoadGen Configurator
- Open the Windows File Explorer.
- Open the following folder: %ProgramData%\LoadGen\Logging.
- Edit the "Configurator log configuration.dnk" file.
- Change <level value="Info" /> to <level value="Debug" />
You can find the actual log files at the following location: C:\Program Files\LoadGen\LoadGen Shared\LoadGen Configurator.log
LoadGen Director
- Open the Windows File Explorer.
- Open the following folder: %ProgramData%\LoadGen\Logging.
- Edit the "Director log configuration.dnk" file.
- Change <level value="Info" /> to <level value="Debug" />
You can find the actual log files at the following location: C:\Program Files\LoadGen\LoadGen Director\debug_dnk_d.log
LoadGen Studio
- Open the Windows File Explorer.
- Open the following folder: %ProgramData%\LoadGen\Logging.
- Edit the "Studio log configuration.dnk" file.
- Change <level value="Info" /> to <level value="Debug" />
You can find the actual log files at the following location: C:\Program Files\LoadGen\LoadGen Director\debug_dnk_s.log
LoadGen Studio - Citrix NetScaler
- Open the Windows File Explorer.
- Open the following folder: C:\Program Files\LoadGen\LoadGen Director\Resources.
- Backup the "ExternalLogin.xml"
- Edit the "ExternalLogin.xml" file.
- Replace <Enabled>false</Enabled> to <Enabled>true</Enabled>
- Create the following folder: C:\LoadGen
You can find the actual log files at the following location: C:\Program Files\LoadGen\LoadGen Studio\debug.log and the screenshots in C:\LoadGen.
LoadGen Analyzer
- Open the Windows File Explorer.
- Open the following folder: %ProgramData%\LoadGen\Logging.
- Edit the "Analyzer log configuration.dnk" file.
- Change <level value="Info" /> to <level value="Debug" />
You can find the actual log files at the following location: C:\Program Files\LoadGen\LoadGen Analyzer\debug_dnk_a.log
LoadGen Agent
You can change the LoadGen Agent logging directly on the LoadGen Director so the debug logging will be enabled on all your LoadGen Agents, or you can choose to only debug one particular LoadGen Agent.
- Open the Windows File Explorer.
- On the LoadGen Director (enable debug logging for all LoadGen Agents):
Open the following folder: C:\Program Files\LoadGen\LoadGen Director\LoadGen Agent. - On a particular LoadGen Agent:
Open the following folder: C:\Program Files (x86)\LoadGen\LoadGen Agent.
- On the LoadGen Director (enable debug logging for all LoadGen Agents):
- Edit the "LoadGenAgentLog.config" file.
- Change <level value="Info" /> to <level value="Debug" />
You can find the actual log files at the following location: C:\Program Files (x86)\LoadGen\LoadGen Agent\debug_LoadGenAgent.log
LoadGen Agent - Session logging Citrix and Remote Desktop Protocol
You can change the LoadGen Agent logging directly on the LoadGen Director so the debug logging will be enabled on all your LoadGen Agents, or you can choose to only debug one particular LoadGen Agent.
- Open the Windows File Explorer.
- On the LoadGen Director (enable debug logging for all LoadGen Agents):
Open the following folder: C:\Program Files\LoadGen\LoadGen Director\LoadGen Agent. - On a particular LoadGen Agent:
Open the following folder: C:\Program Files (x86)\LoadGen\LoadGen Agent.
- On the LoadGen Director (enable debug logging for all LoadGen Agents):
- Edit the "Citrix LoadBot Loglevel.txt" file.
- Change Error to Debug
You can find the actual log files at the following location: C:\Program Files (x86)\LoadGen\LoadGen Agent\debug_dnk_******.log (where ***** stands for the actual username and date).
LoadGen Agent - Session logging WMware Horizon
- Open the Windows File Explorer.
- Within the specific VDI machine:
Open the following folder: %AppData%\LoadGen\ (this must be the AppData folder of the actual test user). - Edit the "log_VM.dnk" file.
- Change <level value="Info" /> to <level value="Debug" />
You can find the actual log files at the following location: %AppData%\LoadGen\debug_dnk_Vmware.log.
LoadGen Agent - Session logging Azure Virtual Desktop
- Open the Windows File Explorer.
- Within the specific VDI machine:
Open the following folder: %AppData%\LoadGen\ (this must be the AppData folder of the actual test user). - Edit the "log_WVD.dnk" file.
- Change <level value="Info" /> to <level value="Debug" />
You can find the actual log files at the following location: %AppData%\LoadGen\debug_dnk_WVD.log.
LoadGen Agent - Session logging Local / FAT Client
- Open the Windows File Explorer.
- Within the specific VDI machine:
Open the following folder: %AppData%\LoadGen\ (this must be the AppData folder of the actual test user). - Edit the "log_lc.dnk" file.
- Change <level value="Info" /> to <level value="Debug" />
You can find the actual log files at the following location: %AppData%\LoadGen\debug_dnk_local.log.
LoadGen UAI (Enhanced Citrix, RDP or Local / FAT Client)
LoadGen Studio
- Open the Windows File Explorer.
- Within the machine where you have installed the LoadGen Studio:
Open the following folder: %AppData%\LoadGen\ (this must be the AppData folder of the actual test user). - Edit the "LoadGen Studio.ini" file.
- Change Logging=N to Logging=Y
- Restart the LoadGen Studio.
You can find the actual log files at the following location: %AppData%\LoadGen\LoadGen Studio.txt.
LoadGen Agent - Remote Desktop Client
- Open the Windows File Explorer.
- On the particular LoadGen Agent:
Open the following folder: %AppData%\LoadGen\ (this must be the AppData folder of the actual test user). - Edit the "DNKRDExec.ini" file.
- Change Logging=N to Logging=Y
- Restart your sessions.
You can find the actual log files at the following location: %AppData%\LoadGen\DNKRDExec.txt.
LoadGen Agent - Citrix Enhanced Client
- Open the Windows File Explorer.
- On the particular LoadGen Agent:
Open the following folder: %AppData%\LoadGen\ (this must be the AppData folder of the actual test user). - Edit the "WFica32.ini" file.
- Change Logging=N to Logging=Y
- Restart your sessions.
You can find the actual log files at the following location: %AppData%\LoadGen\WFica32.txt.
LoadGen Agent - Local / FAT Client
- Open the Windows File Explorer.
- On the particular LoadGen Agent:
Open the following folder: %AppData%\LoadGen\ (this must be the AppData folder of the actual test user). - Edit the "DNKLocalClient.ini" file.
- Change Logging=N to Logging=Y
- Restart your sessions.
You can find the actual log files at the following location: %AppData%\LoadGen\DNKLocalClient.txt.
LoadGen UAI Server Components (Enhanced Citrix, RDP or Local / FAT Client)
LoadGen UAI Service
- Open the Windows File Explorer.
- On the particular machine where the Add-in service is running.
Open the following folder: C:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\LoadGen (note you must do this folder by folder, as you probably don't have the right to open this folder directly). - Edit the "LoadGenUAI.ServerAddinLauncherSrvc.ini" file.
- Change Logging=N to Logging=Y
- Restart the Add-in service.
You can find the actual log files at the following location: C:\Windows\SysWOW64\config\systemprofile\AppData\Roaming\LoadGen\LoadGenUAI.ServerAddinLauncherSrvc.txt.
LoadGen UAI Server - user logging
- Open the Windows File Explorer.
- On the particular machine where the Add-in service is running.
Open the following folder: %AppData%\LoadGen\ (this must be the AppData folder of the actual test user). - Edit the "LoadGenUAI.ServerAddin.ini" file.
- Change Logging=N to Logging=Y
- Restart the Add-in service.
You can find the actual log files at the following location: %AppData%\LoadGen\LoadGenUAI.ServerAddin.txt.