Skip to content

Commit f1c1566

Browse files
author
Chetan Pandey
committed
Explain the two etw profiles
1 parent 0710390 commit f1c1566

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

diagnostics/etw.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,13 @@
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](resources/WebView2_CPU.wprp) that includes the events that we find most useful.
4+
This repo has two WebView2 recording profiles:
55

6-
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).
6+
1. **[WebView2_CPU.wprp](resources/WebView2_CPU.wprp) [Recommended]**: This is the default recording profile that captures most of the useful events for diagnosing WebView2 issues, including CPU sampling data. Use this profile for most scenarios.
7+
8+
2. **[WebView2.wprp](resources/WebView2.wprp)**: This profile is recommended when you need to capture longer scenarios and the size of the ETW traces becomes too large. It excludes some data (like CPU sampling data) to produce smaller trace files.
9+
10+
ETW traces can get fairly large, so try to keep the recording time as short as possible while still capturing the issue. If you need a longer trace, ask the WebView2 developer you're working with if `WebView2.wprp` will suffice.
711

812
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.
913
2. Download [WebView2_CPU.wprp](resources/WebView2_CPU.wprp) from this repo.

0 commit comments

Comments
 (0)