Collecting debug information - USS Agent for Windows

If you have been asked to collect debug information regarding a version of the USS Agent for Windows, please follow these steps.

Collect environmental information

Please provide your service provider with as much of the following as possible:

  • Version of the USS Agent installed - find this by right-clicking the tray icon and selecting About.
  • The Microsoft Windows operating system version - find this in Control Panel / System
  • Whether the operating system is 32-bit or 64-bit - find this in Control Panel / System
  • The names of any Internet security software installed, particularly anti-malware software, and the version numbers. Find this in Control Panel / Programs and Features list.
  • Where possible, the steps to re-create the issue

Automatically collect debug logs

The log files written out by the USS Agent are extremely helpful in understanding any problem. By default, standard debug level is enabled but you should change this to Extra Logging. To do this, right-click on the tray icon and then select Enable Extra Logging.

It is important that you now re-create the problem so that the agent can write the extra debug data to the log files.

Once you've have recreated the original problem, click the Collect debug data option.

By default all options are checked and this provides the most thorough information for troubleshooting. Click OK to start the collection and then send the resulting debug data file to your Service Provider.
If the file is too large to send via email a file transfer service is required. We advise using the free WeTransfer (external link) service or your organisations Sharepoint/Onedrive. You can send a link to the files back to the ticket you have received from Technical Support.

View Agent Status

you can easily view agent status to quickly diagnose issues with the agent, very useful alongside the Tray Icon Status Codes guide

Manually collecting a WFP diagnostic file Open an elevated command prompt

  1. Type netsh wfp capture start
  2. Re-create the problem, for example slow browsing or crash
  3. Type netsh wfp capture stop
  4. Zip up the resulting .cab file and email it to your Service Provider

Manually collecting a process dump

For more complex issues, it may be necessary to collect a Process Dump to allow deeper investigation into the problem.

If the problem resulted in a Blue Screen (BSOD) then the dump file should be located in:

%SystemRoot%\MEMORY.DMP

If there is no file here, or the crash results in the process itself stopping or hanging, follow these steps:

If you do not have the Create dump file option in Task Manager, you will need to use the manual ProcDump command line tool.
  1. Re-create the problem
  2. Press Ctrl + Alt + Del to start the Task Manager
  3. Click the Processes tab and order by Name
  4. Find the USS Agent Service process.
  5. Right-click and select Create dump file
  6. Wait a few moments whilst the process dump file is written out.
It is possible to copy and paste the path into Windows Explorer to make it easy to locate the file.
  1. Repeat the steps for all processes with the same name in the list.
  2. Zip up all of the resulting .dmp files and send them to your service provider.

Manually collect an Installation log

If you have experienced problems installing the agent then collect the installation log file and forward it to your service provider. The log can be created by running the installer file through msiexec, for example:

msiexec /i Setup64-4.x.x.xxxx.msi /L*V! uss_install.log

The file uss_install.log will be created in the current directory.


How did we do?