Skip to content

Commit 575492e

Browse files
committed
Move diagnostics doc, add ETW directions.
1 parent fb9508d commit 575492e

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

diagnostics.md renamed to diagnostics/diagnostics.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,3 +39,16 @@ Navigate to `about:tracing`and use with the `Edge developer (navigation)` profil
3939
3. Grab all the files on disk for Edge - the below command will do the trick and create edgefiles.txt
4040

4141
`dir /s /b "c:\Program Files (x86)\Microsoft\EdgeWebView\" > edgefiles.txt`
42+
43+
## ETW Trace
44+
One of the best ways to help us understand when something is going wrong like failures to create WV2 or other unexpected behaviors is an [Event Tracing for Windows (ETW)](https://learn.microsoft.com/en-us/windows-hardware/test/wpt/event-tracing-for-windows) trace. This repo has a WV2 recording profile - [WebView2.wprp](WebView2.wprp) that includes the events that we find most useful.
45+
46+
ETW traces can get fairly large, so try to keep the amount of extra time spent when recording as small as possible. We also recommend closing any other apps using WV2 to make the trace more clear. Common apps using WV2 may include `widgets.exe`, `msteams.exe`, and Microsoft Office products.
47+
48+
To get an ETW trace:
49+
1. Download [WebView2.wprp](WebView2.wprp) from this repo.
50+
2. In an elevated command prompt run `wpr -start WebView2.wppr -filemode` (wpr.exe is included in Windows)
51+
3. Reproduce the issue.
52+
4. In an elevated command prompt run `wpr -stop trace.etl "trace"`.
53+
54+
ETW traces can contain sensitive information, if you're concerned with sharing one publicly in a GitHub issue, you can ask the WV2 developer you're working with for an email address to send to them privately.

0 commit comments

Comments
 (0)