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: defender-endpoint/troubleshoot-av-performance-issues-with-wprui.md
+26-27Lines changed: 26 additions & 27 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -45,14 +45,13 @@ Manually
45
45
46
46
1. Download the [MDE Client Analyzer ](/defender-endpoint/download-client-analyzer).
47
47
48
-
1. Run the MDE Client Analyzer using [Live Response or locally](/defender-endpoint/run-analyzer-windows).
48
+
2. Run the MDE Client Analyzer using [Live Response or locally](/defender-endpoint/run-analyzer-windows).
49
49
50
50
> [!TIP]
51
51
> Before starting the trace, please make sure that the issue is reproducible. Additionally, close any applications that do not contribute to the reproduction of the issue.
52
52
53
53
54
-
55
-
1. Run the MDE Client Analyzer with the -a and -v switches
54
+
3. Run the MDE Client Analyzer with the -a and -v switches
56
55
57
56
PowerShellCopy
58
57
@@ -69,33 +68,33 @@ Manually
69
68
70
69
1. Download and install WPR.
71
70
72
-
1. Under *Windows Kits*, right-click **Windows Performance Recorder**.
71
+
2. Under *Windows Kits*, right-click **Windows Performance Recorder**.
73
72
74
73

75
74
76
-
1. Select **More**. Select **Run as administrator**.
75
+
3. Select **More**. Select **Run as administrator**.
77
76
78
-
1. Right-click **Yes** when the User Account Control dialog box appears.
77
+
4. Right-click **Yes** when the User Account Control dialog box appears.
79
78
80
79

81
80
82
-
1. Next, download the [Microsoft Defender for Endpoint analysis](https://github.com/YongRhee-MDE/Scripts/blob/master/MDAV.wprp) profile and save as `MDAV.wprp` to a folder such as `C:\temp`.
81
+
5. Next, download the [Microsoft Defender for Endpoint analysis](https://github.com/YongRhee-MDE/Scripts/blob/master/MDAV.wprp) profile and save as `MDAV.wprp` to a folder such as `C:\temp`.
83
82
84
-
1. In the WPR dialog box, select **More options**.
83
+
6. In the WPR dialog box, select **More options**.
85
84
86
85

87
86
88
-
1. Select **Add Profiles...** and browse to the path of the `MDAV.wprp` file.
87
+
7. Select **Add Profiles...** and browse to the path of the `MDAV.wprp` file.
89
88
90
-
1. A new profile named Microsoft Defender for Endpoint analysis should appear under Custom measurements.
89
+
8. A new profile named Microsoft Defender for Endpoint analysis should appear under Custom measurements.
91
90
92
91

93
92
94
93
> [!WARNING]
95
94
> If your Windows Server has 64 GB of RAM or more, use the custom measurement `Microsoft Defender for Endpoint analysis for large servers` instead of `Microsoft Defender for Endpoint analysis`. Otherwise, your system consumes a high amount of non-paged pool memory or buffers, leading to system instability. Explore **Resource Analysis** to choose profiles to add.
96
95
> This custom profile provides the necessary context for in-depth performance analysis.
97
96
98
-
1. To use the custom measurement Microsoft Defender for Endpoint verbose analysis profile in the WPR UI:
97
+
9. To use the custom measurement Microsoft Defender for Endpoint verbose analysis profile in the WPR UI:
99
98
100
99
1. Ensure no profiles are selected under the *First-level triage*, *Resource Analysis* and *Scenario Analysis* groups.
101
100
@@ -110,34 +109,34 @@ Manually
110
109
> [!IMPORTANT]
111
110
> Select **File** to use the file logging mode if you can directly reproduce the performance issue. Most issues fall under this category. However, if you cannot directly reproduce the issue, select Memory to use the memory logging mode. This prevents the trace log from inflating excessively due to long run times.
112
111
113
-
1. Now you're ready to collect data. Close all unnecessary applications. Click **Hide options** to keep the space occupied by the WPR window small.
112
+
10. Now you're ready to collect data. Close all unnecessary applications. Click **Hide options** to keep the space occupied by the WPR window small.
114
113
115
114

116
115
117
-
1. Select **Start**.
116
+
11. Select **Start**.
118
117
119
118

120
119
121
-
1. Reproduce the issue.
120
+
12. Reproduce the issue.
122
121
123
122
> [!TIP]
124
123
> Limit the data collection to a maximum of five minutes. Ideally, aim for two to three minutes, as a significant amount of data is being collected.
125
124
126
-
1. Select **Save**.
125
+
13. Select **Save**.
127
126
128
127

129
128
130
-
1. Fill in **Type in a detailed description of the problem:** with information about the problem and how you reproduced the issue.
129
+
14. Fill in **Type in a detailed description of the problem:** with information about the problem and how you reproduced the issue.
131
130
132
131

133
132
134
-
1. Select **File Name:** to determine where your trace file is saved. By default, it's saved to `%user%\Documents\WPR Files\`.
133
+
15. Select **File Name:** to determine where your trace file is saved. By default, it's saved to `%user%\Documents\WPR Files\`.
135
134
136
-
1. Select **Save**.
135
+
16. Select **Save**.
137
136
138
137

139
138
140
-
1. After the trace has been merged and saved, right-click **Open folder**.
139
+
17. After the trace has been merged and saved, right-click **Open folder**.
141
140
142
141

143
142
@@ -151,11 +150,11 @@ To collect a WPR trace using the command-line tool wpr.exe:
151
150
152
151
1. Download **[Microsoft Defender for Endpoint analysis](https://github.com/YongRhee-MDE/Scripts/blob/master/MDAV.wprp)** performance trace profile as `MDAV.wprp` in a local directory such as `C:\traces`.
153
152
154
-
1. Right-click the **Start Menu** icon and select **Windows PowerShell (Admin)** or **Command Prompt (Admin)** to open an Admin command prompt window.
153
+
2. Right-click the **Start Menu** icon and select **Windows PowerShell (Admin)** or **Command Prompt (Admin)** to open an Admin command prompt window.
155
154
156
-
1. Select **Yes** in the User Account Control dialog box.
155
+
3. Select **Yes** in the User Account Control dialog box.
157
156
158
-
1. At the **Command Prompt (Admin)**, run the following command to start a Microsoft Defender for Endpoint performance trace:
157
+
4. At the **Command Prompt (Admin)**, run the following command to start a Microsoft Defender for Endpoint performance trace:
159
158
160
159
```console
161
160
@@ -166,25 +165,25 @@ To collect a WPR trace using the command-line tool wpr.exe:
166
165
> [!WARNING]
167
166
> If your Windows Server has 64 GB of RAM or more, use profiles `WDForLargeServers.Light` and `WDForLargeServers.Verbose` instead of profiles `WD.Light` and `WD.Verbose`, respectively. Otherwise, your system consumes a high amount of non-paged pool memory or buffers, leading to system instability.
168
167
169
-
1. Reproduce the issue.
168
+
5. Reproduce the issue.
170
169
171
170
> [!TIP]
172
171
> Limit the data collection to a maximum of five minutes. Ideally, aim for two to three minutes, as a significant amount of data is being collected.
173
172
174
-
1. At the **Command Prompt (Admin)**, run the following command to start a Microsoft Defender for Endpoint performance trace:
173
+
6. At the **Command Prompt (Admin)**, run the following command to start a Microsoft Defender for Endpoint performance trace:
175
174
176
175
```console
177
176
wpr.exe -stop merged.etl "Timestamp when the issue was reproduced, in HH:MM:SS format" "Description of the issue" "Any error that popped up"
178
177
```
179
178
180
-
1. Wait until the trace is merged.
179
+
7. Wait until the trace is merged.
181
180
182
-
1. Include both the file and the folder in your submission to Microsoft Support.
181
+
8. Include both the file and the folder in your submission to Microsoft Support.
183
182
184
183
## See also
185
184
186
185
-[Collect Microsoft Defender Antivirus diagnostic data](collect-diagnostic-data.md)
187
186
-[Configure and validate exclusions for Microsoft Defender Antivirus scans](configure-exclusions-microsoft-defender-antivirus.md)
188
187
-[Performance analyzer for Microsoft Defender Antivirus](tune-performance-defender-antivirus.md)
189
188
190
-
[!INCLUDE [Microsoft Defender for Endpoint Tech Community](../includes/defender-mde-techcommunity.md)]
189
+
[!INCLUDE [Microsoft Defender for Endpoint Tech Community](../includes/defender-mde-techcommunity.md)]
0 commit comments