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
+39-39Lines changed: 39 additions & 39 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,10 +22,10 @@ ms.custom:
22
22
# Troubleshoot Microsoft Defender Antivirus performance issues with WPRUI
23
23
24
24
> [!TIP]
25
-
> First, review common reasons for performance issues such as high cpu in [Troubleshoot performance issues related to Microsoft Defender Antivirus real-time protection (rtp) or scans (scheduled or on-demand](/defender-endpoint/troubleshoot-performance-issues)).
26
-
> Then, run the [Microsoft Defender Antivirus Performance Analyzer](/defender-endpoint/tune-performance-defender-antivirus)which makes analyzing the reason for a high cpu in Microsoft Defender Antivirus (Antimalware Service Executable or Microsoft Defender Antivirus service or MsMpEng.exe)
27
-
> If for any reason, the Microsoft Defender Antivirus Performance Analyzer doesn't provide with the root cause of the high cpu utilization, then, next run [Processor Monitor](/defender-endpoint/troubleshoot-av-performance-issues-with-procmon) to find narrow down or root cause the high cpu utilization in Microsoft Defender Antivirus.
28
-
> And the last tool in the toolbelt is to run a Windows Performance Recorder UI (WPRUI) or Windows Performance Recorded (WPR command-line) discussed in this article.
25
+
> First, review common reasons for performance issues such as high CPU usage in [Troubleshoot performance issues related to Microsoft Defender Antivirus real-time protection (rtp) or scans (scheduled or on-demand](/defender-endpoint/troubleshoot-performance-issues)).
26
+
> Then, run the [Microsoft Defender Antivirus Performance Analyzer](/defender-endpoint/tune-performance-defender-antivirus)to analyze the cause of high CPU usage in Microsoft Defender Antivirus (Antimalware Service Executable, Microsoft Defender Antivirus service, or MsMpEng.exe).
27
+
> If the Microsoft Defender Antivirus Performance Analyzer does not identify the root cause of high CPU utilization, run [Processor Monitor](/defender-endpoint/troubleshoot-av-performance-issues-with-procmon) to narrow down or determine the root cause of the high CPU utilization in Microsoft Defender Antivirus.
28
+
> The final tool in your toolkit is to run the Windows Performance Recorder UI (WPRUI) or the Windows Performance Recorder (WPR command-line) as discussed in this article.
29
29
30
30
## Capture performance logs using Windows Performance Recorder
31
31
@@ -35,23 +35,23 @@ WPR is part of the Windows Assessment and Deployment Kit (Windows ADK) and can b
35
35
36
36
Alternatively, follow the steps in [Capture performance logs using the WPR UI](/editor/MicrosoftDocs/defender-docs-pr/defender-endpoint%2Ftroubleshoot-performance-issues.md/main/ae28f1cf-14bc-fb9c-5f0c-873a683e907c/?branch=main&branchFallbackFrom=main%2C), or use the command-line tool *wpr.exe*[Capture performance logs using the WPR CLI](/editor/MicrosoftDocs/defender-docs-pr/defender-endpoint%2Ftroubleshoot-performance-issues.md/main/ae28f1cf-14bc-fb9c-5f0c-873a683e907c/?branch=main&branchFallbackFrom=main%2C). Both are available in Windows 8 and later versions.
37
37
38
-
There are two ways to capture a Windows Performance Recorder (WPRUI) trace:
38
+
There are two ways to capture the Windows Performance Recorder (WPRUI) trace:
39
39
40
-
Using the MDE Client Analyzer
40
+
1.Using the MDE Client Analyzer
41
41
42
-
Manually
42
+
1.Manually
43
43
44
44
## Using the MDE Client Analyzer
45
45
46
46
1. Download the [MDE Client Analyzer ](/defender-endpoint/download-client-analyzer).
47
47
48
-
2. Run the MDE Client Analyzer using [Live Response or locally](/defender-endpoint/run-analyzer-windows).
48
+
1. Run the MDE Client Analyzer using [Live Response or locally](/defender-endpoint/run-analyzer-windows).
49
49
50
50
> [!TIP]
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.
51
+
> Before starting the trace, make sure the issue is reproducible. Additionally, close any applications that do not contribute to the reproduction of the issue.
52
52
53
53
54
-
3. Run the MDE Client Analyzer with the -a and -v switches
54
+
1. Run the MDE Client Analyzer with the -a and -v switches
55
55
56
56
PowerShellCopy
57
57
@@ -64,79 +64,79 @@ Manually
64
64
### Capture performance logs using the WPR UI
65
65
66
66
> [!TIP]
67
-
> If multiple devices are experiencing this issue, try using the one with the most RAM.
67
+
> If multiple devices are experiencing this issue, use the one with the most RAM.
68
68
69
69
1. Download and install WPR.
70
70
71
-
2. Under *Windows Kits*, right-click **Windows Performance Recorder**.
71
+
1. Under *Windows Kits*, right-click **Windows Performance Recorder**.
72
72
73
73

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

80
80
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`.
81
+
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`.
82
82
83
-
6. In the WPR dialog box, select **More options**.
83
+
1. In the WPR dialog box, select **More options**.
84
84
85
85

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

92
92
93
93
> [!WARNING]
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.
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 may consume a high amount of non-paged pool memory or buffers, leading to system instability.To address this, explore**Resource Analysis** to choose profiles to add.
95
95
> This custom profile provides the necessary context for in-depth performance analysis.
96
96
97
-
9. To use the custom measurement Microsoft Defender for Endpoint verbose analysis profile in the WPR UI:
97
+
1. To use the custom measurement Microsoft Defender for Endpoint verbose analysis profile in the WPR UI:
98
98
99
99
1. Ensure no profiles are selected under the *First-level triage*, *Resource Analysis* and *Scenario Analysis* groups.
100
100
101
-
2. Select **Custom measurements**.
101
+
1. Select **Custom measurements**.
102
102
103
-
3. Select **Microsoft Defender for Endpoint analysis**.
103
+
1. Select **Microsoft Defender for Endpoint analysis**.
104
104
105
-
4. Select **Verbose** under *Detail* level.
105
+
1. Select **Verbose** under *Detail* level.
106
106
107
-
5. Select **File** or **Memory** under Logging mode.
107
+
1. Select **File** or **Memory** under Logging mode.
108
108
109
109
> [!IMPORTANT]
110
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.
111
111
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.
112
+
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.
113
113
114
114

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

119
119
120
-
12. Reproduce the issue.
120
+
1. Reproduce the issue.
121
121
122
122
> [!TIP]
123
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.
124
124
125
-
13. Select **Save**.
125
+
1. Select **Save**.
126
126
127
127

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

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

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

142
142
@@ -150,11 +150,11 @@ To collect a WPR trace using the command-line tool wpr.exe:
150
150
151
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`.
152
152
153
-
2. Right-click the **Start Menu** icon and select **Windows PowerShell (Admin)** or **Command Prompt (Admin)** to open an Admin command prompt window.
153
+
1. Right-click the **Start Menu** icon and select **Windows PowerShell (Admin)** or **Command Prompt (Admin)** to open an Admin command prompt window.
154
154
155
-
3. Select **Yes** in the User Account Control dialog box.
155
+
1. Select **Yes** in the User Account Control dialog box.
156
156
157
-
4. At the **Command Prompt (Admin)**, run the following command to start a Microsoft Defender for Endpoint performance trace:
157
+
1. At the **Command Prompt (Admin)**, run the following command to start a Microsoft Defender for Endpoint performance trace:
158
158
159
159
```console
160
160
@@ -165,20 +165,20 @@ To collect a WPR trace using the command-line tool wpr.exe:
165
165
> [!WARNING]
166
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.
167
167
168
-
5. Reproduce the issue.
168
+
1. Reproduce the issue.
169
169
170
170
> [!TIP]
171
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.
172
172
173
-
6. At the **Command Prompt (Admin)**, run the following command to start a Microsoft Defender for Endpoint performance trace:
173
+
1. At the **Command Prompt (Admin)**, run the following command to start a Microsoft Defender for Endpoint performance trace:
174
174
175
175
```console
176
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"
177
177
```
178
178
179
-
7. Wait until the trace is merged.
179
+
1. Wait until the trace is merged.
180
180
181
-
8. Include both the file and the folder in your submission to Microsoft Support.
181
+
1. Include both the file and the folder in your submission to Microsoft Support.
0 commit comments