KB: How To Enable Debug Logging in Microsoft User Experience Virtualization (UE-V)

imageHere’s another UE-V article that I thought I’d share here for now, at least until there’s a better home for UE-V content somewhere else.  This Knowledge Base article talks about how to enable debug logging:

Summary

This article describes how to enable debug logging for the Microsoft User Experience Virtualization (UE-V) agent. This is useful in troubleshooting issues where settings or files are not replicating as expected. Typically, this process is ran on at least two different client machines to test replication.

More Information

First, identify the scenario you wish to trace. The two main variations for UE-V are tracing applications and tracing desktop settings. User application traces can be collected when an executable is launched; desktop settings must be recorded during logoff and subsequent logoff.

Traces collect data for all users logged in to a computer. If you wish to record a trace for a non-administrator account, you will need to either log in to a second desktop session (in the case of a Terminal Server, for example), or else launch a command prompt in the context of a member of the machine's local Administrators group by holding down the shift key and right-clicking on a shortcut to a Command Prompt. In addition, these commands must be ran in an elevated token.

Scenario 1: Tracing an Application

  1. Log on to the computer as a member of the local administrators group.

  2. Launch an elevated command prompt by right-clicking on a shortcut to Command Prompt and selecting Run as administrator.

  3. Create the trace definition by running these two commands in the elevated Command Prompt window: logman create trace UEV -P "Microsoft-User Experience Virtualization-App Agent" -ow -o uevtrace.etl

    logman update UEV -P "Microsoft-User Experience Virtualization-Agent Driver"

  4. Start the trace by typing the command logman start UEV

  5. Close any running instances of the application you are investigating, then launch the application.

  6. Reproduce the issue you are investigating, then close the application.

  7. Stop the trace by typing logman stop UEV

  8. Delete the trace definition by typing logman delete UEV

  9. Decode the trace by typing the command netsh trace convert uevtrace_000001.etl DUMP=TXT

Note: The first trace you take will be named uevtrace_000001.etl by default. Edit the command above if you take multiple traces to reflect the name of the ETL file.

Scenario 2: Tracing a Desktop Settings Issue

  1. Log on to the computer as a member of the local administrators group.

  2. Launch an elevated command prompt by right-clicking on a shortcut to Command Prompt and selecting Run as administrator.

  3. Create the trace definition by running these two commands in the elevated Command Prompt window: logman create trace UEV -P "Microsoft-User Experience Virtualization-App Agent" -ow -o uevtrace.etl

    logman update UEV -P "Microsoft-User Experience Virtualization-Agent Driver"

  4. Start the trace by typing the command logman start UEV

  5. Reproduce the issue you are investigating, then log off.

  6. Log back on to the server.

  7. Launch an elevated command prompt by right-clicking on a shortcut to Command Prompt and selecting Run as administrator.

  8. Stop the trace by typing logman stop UEV

  9. Delete the trace definition by typing logman delete UEV

  10. Decode the trace by typing the command netsh trace convert uevtrace_000001.etl DUMP=TXT

Note: The first trace you take will be named uevtrace_000001.etl by default. Edit the command above if you take multiple traces to reflect the name of the ETL file.

Alternate Method: Event Viewer Logging

If you wish to use Event Viewer rather than text file logging, use the steps below.

  1. Log on to the computer as a member of the local administrators group.
  2. Launch Event Viewer.
  3. Select View\Show Analytic and Debug Logs.
  4. Navigate to Event Viewer (Local)\Applications and Service Logs\Microsoft\User Experience Virtualization\App Agent.
  5. Right-click on Debug under App Agent and select Enable Log.
  6. Select OK when presented with the "Analytic and Debug logs may lose events when they are enabled. Do you want to enable this log?" dialog.
  7. Reproduce your issue.
  8. Right click Debug and select Refresh.
  9. Right click Debug and select Disable Log.
=====

For the most current version of this article please see the following:

2782997 - How To Enable Debug Logging in Microsoft User Experience Virtualization (UE-V)

J.C. Hornbeck | Knowledge Engineer | Management and Security Division

Get the latest System Center news on Facebook and Twitter :

clip_image001 clip_image002

App-V Team blog: https://blogs.technet.com/appv/
ConfigMgr Support Team blog: https://blogs.technet.com/configurationmgr/
DPM Team blog: https://blogs.technet.com/dpm/
MED-V Team blog: https://blogs.technet.com/medv/
Orchestrator Support Team blog: https://blogs.technet.com/b/orchestrator/
Operations Manager Team blog: https://blogs.technet.com/momteam/
SCVMM Team blog: https://blogs.technet.com/scvmm
Server App-V Team blog: https://blogs.technet.com/b/serverappv
Service Manager Team blog: https://blogs.technet.com/b/servicemanager
System Center Essentials Team blog: https://blogs.technet.com/b/systemcenteressentials
WSUS Support Team blog: https://blogs.technet.com/sus/

The Forefront Server Protection blog: https://blogs.technet.com/b/fss/
The Forefront Endpoint Security blog : https://blogs.technet.com/b/clientsecurity/
The Forefront Identity Manager blog : https://blogs.msdn.com/b/ms-identity-support/
The Forefront TMG blog: https://blogs.technet.com/b/isablog/
The Forefront UAG blog: https://blogs.technet.com/b/edgeaccessblog/