**_Type of logs available:_** There are a number of logs that can be collected from the WEM Agent to help with troubleshooting/diagnosing an issue _Note:__Please make sure to revert all changes after completing log collection._ * _For logging information related to WEM Brokers, see _CTX228742 1. **WEM Agent Session Logs:** These logs are created by default in the base of the user’s profile * Citrix WEM Agent Init.log * This is the initialization log for the Agent; will log the Agent once the end user logs in * If the Agent fails to start up, this log will likely contain the relevant error message * Errors in this log are listed as **Exceptions**. * Created by default after user logs in: * Filenames: Citrix WEM Agent Init.log & Citrix WEM Agent.log * Location:%userprofile% * Citrix WEM Agent.log * This is the main Agent log, which will list what instructions the Agent is processing. * If one of the actions assigned to the current user is not showing, this log will likely contain the relevant error message. * Errors in this log are listed as **Exceptions**. * Must be manually enabled * Filename: Citrix WEM Agent Host Service Debug.log * Location:"%PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent" 2. **WEM Agent Debug Log** : These logs are created by default in the program directory * Citrix WEM Agent Host Service Debug.log * This log must be manually enabled for the WEM Agent Service. * There are 2 ways to manually enable these logs: 1. From the WEM Administration Console per “Configuration Set” 1. 1. Navigate to: “Advanced Settings” 2. Select “Configurations” click on “Agent Options” tab &place a checkmark next to “Debug Mode”. 1. 1. 2. In the Registry of the individual WEM Agent Machine: 1. 1. Navigate toin the registry: HKLM\System\CurrentControlSet\Control\Norskale\Agent Host 2. Change the value of AgentDebugModeLocalOverrideto 1 3. AgentServiceDebugModeLocalOverrideto1 4. Restart theCitrix WEM Agent Host Service. **** 3. **WEM Agent Event Viewer log** : This logis located in the**Applications and Services Logs** section of**Event Viewer** * WEM Agent Service: This event viewer log is present by default and contains basic events pertaining directly to the Agent service (cached settings, refresh event & connection events). * Created by default * Event log name:WEM Agent Service * Location:Inside Event Viewer under the section titled:**Applications and Services Logs** 4. **WCF Traces:** must be manually configured and are normally helpful when there are communication issues between the WEM Agent and the WEM Broker. * Example: you may need to review a WCF trace of the VUEMUIAgent.exe service if the WEM Agent is not checking in with the WEM Broker * * VUEMUIAgent.exe * * * WCF Traces: Must be manually enabled * Filename:vuemUIAgent-Traces.svclog * Location: "C:\Trace" * * **Steps to enable tracing:** 1. 1. 1. 1. * Close the WEM Agent by exiting the Agent from the taskbar at the bottom right hand side of the screen. * Make a backup copy of theVUEMUIAgent.exe.configfile located in the default location of: "%PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent". * Using Notepad or WordPad, edit the original .config file adding the multiple lines of code from the attached document named VuemUIAgent.txt to the file. * Paste the code into the file starting on the 3rd line in between the and markers, then save the file. **Here are contents of the file:** 1. 1. 1. 1. 1. 1. * Create a directory on the root of the C: drive called “trace” if one does not already exist. * Reproduce the issue * Stop theVUEMUIAgent.exeprocess if it is still running * Collect the log file * Citrix.Wem.Agent.Service.exe * * * Citrix.Wem.Agent.Service.exe * Filename:NorskaleAgentHostService-Traces.svclog * Location: "C:\Trace" * * **Steps to enable tracing:** 1. 1. 1. 1. * Close the WEM Agent by exiting the Agent from the taskbar at the bottom right hand side of the screen. * Stop the Windows Service calledCitrix WEM Agent Host Service * Make a backup copy of theCitrix.Wem.Agent.Service.exe.configfile located in the default location of %PROGRAMFILES(X86)%\Citrix\Workspace Environment Management Agent". * Using Notepad or Wordpad,edit the original .config file adding the multiple lines of code from the attached document named “Norskale Agent Host Service.txt” to the file. * Paste the code into the file starting on the 5th line just after the marker, then save the file. **Here are contents of the file:** 1. 1. 1. 1. 1. 1. * Create a directory on the root of the C: drive called “trace” if one does not already exist. * Start the Windows Service calledCitrix WEM Agent Host Service, reproduce the issue & collect the log file. ******REVERT ALL CHANGES AFTER COLLECTING THE APPROPRIATE LOGS******

Query Builder