Skip to content

Commit e4af480

Browse files
authored
Update ETW documentation to merge profiles (#5103)
* Update ETW documentation to merge profiles Add about merging the profiles in case if app has an explicit profile.
1 parent 8ea7783 commit e4af480

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

diagnostics/etw.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
# Gathering an ETW Trace
22
[Event Tracing for Windows (ETW)](https://learn.microsoft.com/en-us/windows-hardware/test/wpt/event-tracing-for-windows)traces include detailed events on system state and the activities WV2 was doing before and when an issue occurs.
33

4-
This repo has a WV2 recording profile - [WebView2_CPU.wprp](WebView2_CPU.wprp) that includes the events that we find most useful.
4+
This repo has a WV2 recording profile - [WebView2_CPU.wprp](WebView2_CPU.wprp) that includes the events that we find most useful.
55

66
ETW traces can get fairly large, so try to keep the amount of extra time spent when recording as small as possible. If you need a longer trace, ask the WV2 developer that you're working with if `WebView2.wprp` will suffice (it gathers less data).
77

88
1. Close Edge and 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.
9-
1. Download [WebView2_CPU.wprp](WebView2_CPU.wprp) from this repo.
10-
2. In an elevated command prompt run `wpr -start WebView2_CPU.wprp -filemode` (wpr.exe is included in Windows)
11-
3. Reproduce the issue.
12-
4. In an elevated command prompt run `wpr -stop trace.etl "trace"`.
9+
2. Download [WebView2_CPU.wprp](WebView2_CPU.wprp) from this repo.
10+
3. If your app has a specific profile, merge it with [WebView2_CPU.wprp](WebView2_CPU.wprp) to ensure all events are captured in a single ETL file.
11+
4. In an elevated command prompt run `wpr -start WebView2_CPU.wprp -filemode` (wpr.exe is included in Windows).
12+
5. Reproduce the issue.
13+
6. In an elevated command prompt run `wpr -stop trace.etl "trace"`.
1314

1415
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)