Skip to main content
ETW capture instructions
Thomas Giannini avatar
Written by Thomas Giannini
Updated over a week ago

ETW Capture Diagnostic - Instructions

We have prepared the instructions to use a tool for the affected players in order to capture some more information, and it would be very useful if you could follow these instructions to help us.

DISCLAIMER: The tool we ask you to use is the Windows profiler made by Microsoft. The profiler gathers information about operations on your PC at the moment of capture including list of processes running, files accessed, and the keys pressed. Please don't type passwords or any other private information during the capture.

Preparation

1. Download https://github.com/google/UIforETW/releases/download/1.54/etwpackage1.54.zip and unpack it to any location, for example on the Desktop;

2. Launch d:\etwpackage\bin\UIforETW.exe

On the first launch, it may prompt you to install Windows Performance Toolkit (WPT) - agree to installation.

Note:

In case you receive the error message shown in the following picture, please try to uninstall existing installations of Windows Development kits, WPT, Windows ADK and re-run the tool to let it finish installation in the default location (C:\Program Files (x86)\Windows Kits\10):

3. Adjust settings in the Main window and Settings window as shown on screenshots.

a. In the Main window, keep enabled: (see the picture below)

Compress Trace

Context switch call stack

CPU sampling callstack

Input Tracing: Full

Circular buffer tracing

b. In the Settings window, keep enabled: (see the picture below)

Record trace command

4. Press "Start Tracing" button. (see the picture below)

Among other things, the tool should write "Starting tracing to in-memory circular buffers..." and "Tracing is started." - it means that the tool works properly.

5. Start Hunt and play a match, while the "UI for ETW" tool is running in the background. Please make sure that VSync is disabled during this test. You can turn off VSync by navigating to Options -> Graphics -> Basic Settings.

Capturing info

1. When your reported issue happens, try to press some key which you don't usually use (for example, F5) - this will help us to find the occurrence in the capture faster.

2. After your issue, wait few seconds and press "Ctrl + Win + R".

The tool will save the last ~30 seconds of captured information into the file.

3. Saving takes some time (10-30 seconds), so game's performance at this time may be unstable - please wait this time until you capture next stall.

Providing info

1. Press "Cancel tracing" to stop profiling tool.

2. Captured trace files are listed in the Main tool's window on the bottom-left. Traces are named <date>_<time>_<username>.

You may add additional description to each captured trace: select it in the bottom-left list and then type extra information in the bottom-right text field. (see the picture below).

3. Right-click on the bottom-left list and press "Browse folder". Usually, trace files are saved in the Documents/etwtraces.

4. Gather all captured files and send it to us. Each capture is usually ~60-100 Mb.

To send the files we would suggest uploading it on a file sharing website, such as file.fm (you just need to drag and drop, no registration required), and then contacting us through the contact support button and creating a ticket. Include the link in the ticket sent.

Thanks a lot in advance for your cooperation!

Did this answer your question?