You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: diagnostics.md
-40Lines changed: 0 additions & 40 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,46 +7,6 @@ The <user data folder> is created in the app's folder by default:
7
7
<code><appfolder>\<app name>.exe.WebView2</code>
8
8
But apps can specify different user data folders. If they do, they generally know where it is.
9
9
10
-
## Traces
11
-
Sometimes issues don't cause a crash, but something still doesn't behave as expected. Or perhaps it manifest as bad performance, slow loading, etc. In these cases you can ask for traces that can be examined.
12
-
13
-
### Collecting TTD traces from customer environment
14
-
Some issues are reproducible only in customer environment and require a TTD trace from that environment. The instructions below might need to be re-tried until a successful trace is collected.
15
-
> Cmd windows (A) and (B) can be the same, but if so, the window needs to be started as admin from the beginning.
16
-
17
-
1. Force `--no-sandbox` for renderer processes (collecting traces for renderer processes requires this flag)
18
-
**Option (1)** - From cmd (A):
19
-
> SET WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS=--no-sandbox
20
-
SET WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS
21
-
22
-
**Option (2)** - From settings:
23
-
Edit system environment variables / Environment variables… / New…
24
-
Make sure to click "OK" on both settings windows.
25
-
26
-
1. Create directory for dumps
27
-
Make sure it's not in a network location (network locations have paths starting with `\\`)
**Note:** this is the external version of `tttrace` in `C:\Windows\System32` which ships with Windows. No additional setup should be required to use it.
35
-
36
-
1. Reproduce the issue
37
-
* If option (1) was used on step (1) above, make sure the launching app is restarted.
38
-
* If option (2) was used on step (1) above, launch the app from the same cmd window (A) where the environment variable was set.
39
-
40
-
1. Stop trace recording
41
-
```
42
-
tttracer /stop all
43
-
tttracer /cleanup
44
-
tttracer /delete all
45
-
```
46
-
47
-
* Verify collected trace hits the issue. If it doesn't, go through steps 2-5 again (use a different directory for step 3). Retries might be faster.
48
-
* Send all files in successful trace dumps directory for analysis.
49
-
50
10
## Graphics and GPU info
51
11
Issues where the WebView2 isn't displaying anything are most often caused by a launch failure, such as un-writeable user data folder, mismatched DPI awareness, or missing files (runtime or binaries). However, if the WebView2 has launched correctly (you can check return values and task manager) but the content is not there, then it might be due to a hosting and/or GPU driver issue.
52
12
1. Get the output of `edge://gpu` (wait for the page to load the 'log messages' section at the bottom).
0 commit comments