Skip to content

Commit 924643e

Browse files
committed
èdits
1 parent 6f03a64 commit 924643e

File tree

1 file changed

+39
-39
lines changed

1 file changed

+39
-39
lines changed

defender-endpoint/troubleshoot-av-performance-issues-with-wprui.md

Lines changed: 39 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -22,10 +22,10 @@ ms.custom:
2222
# Troubleshoot Microsoft Defender Antivirus performance issues with WPRUI
2323

2424
> [!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.
2929
3030
## Capture performance logs using Windows Performance Recorder
3131

@@ -35,23 +35,23 @@ WPR is part of the Windows Assessment and Deployment Kit (Windows ADK) and can b
3535

3636
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.
3737

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:
3939

40-
Using the MDE Client Analyzer
40+
1. Using the MDE Client Analyzer
4141

42-
Manually
42+
1. Manually
4343

4444
## Using the MDE Client Analyzer
4545

4646
1. Download the [MDE Client Analyzer ](/defender-endpoint/download-client-analyzer).
4747

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).
4949

5050
> [!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.
5252
5353

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
5555

5656
PowerShellCopy
5757

@@ -64,79 +64,79 @@ Manually
6464
### Capture performance logs using the WPR UI
6565

6666
> [!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.
6868
6969
1. Download and install WPR.
7070

71-
2. Under *Windows Kits*, right-click **Windows Performance Recorder**.
71+
1. Under *Windows Kits*, right-click **Windows Performance Recorder**.
7272

7373
![Screenshot showing the Start menu](media/wpr-01.png)
7474

75-
3. Select **More**. Select **Run as administrator**.
75+
1. Select **More**. Select **Run as administrator**.
7676

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.
7878

7979
![Screenshot showing the UAC page.](media/wpt-yes.png)
8080

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`.
8282

83-
6. In the WPR dialog box, select **More options**.
83+
1. In the WPR dialog box, select **More options**.
8484

8585
![Screenshot showing the page where you can select more options](media/wpr-03.png)
8686

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.
8888

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.
9090

9191
![Screenshot showing the in-file.](media/wpr-infile.png)
9292

9393
> [!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.
9595
> This custom profile provides the necessary context for in-depth performance analysis.
9696
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:
9898

9999
1. Ensure no profiles are selected under the *First-level triage*, *Resource Analysis* and *Scenario Analysis* groups.
100100

101-
2. Select **Custom measurements**.
101+
1. Select **Custom measurements**.
102102

103-
3. Select **Microsoft Defender for Endpoint analysis**.
103+
1. Select **Microsoft Defender for Endpoint analysis**.
104104

105-
4. Select **Verbose** under *Detail* level.
105+
1. Select **Verbose** under *Detail* level.
106106

107-
5. Select **File** or **Memory** under Logging mode.
107+
1. Select **File** or **Memory** under Logging mode.
108108

109109
> [!IMPORTANT]
110110
> 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.
111111
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.
113113

114114
![Screenshot showing the Hide options.](media/wpr-08.png)
115115

116-
11. Select **Start**.
116+
1. Select **Start**.
117117

118118
![Screenshot showing the Record system information page.](media/wpr-09.png)
119119

120-
12. Reproduce the issue.
120+
1. Reproduce the issue.
121121

122122
> [!TIP]
123123
> 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.
124124
125-
13. Select **Save**.
125+
1. Select **Save**.
126126

127127
![Screenshot showing the Save option.](media/wpr-10.png)
128128

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.
130130

131131
![Screenshot showing the pane in which you fill.](media/wpr-12.png)
132132

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\`.
134134

135-
16. Select **Save**.
135+
1. Select **Save**.
136136

137137
![Screenshot showing the WPR gathering general trace.](media/wpr-13.png)
138138

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**.
140140

141141
![Screenshot that displays the notification that WPR trace has been saved.](media/wpr-14.png)
142142

@@ -150,11 +150,11 @@ To collect a WPR trace using the command-line tool wpr.exe:
150150
151151
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`.
152152
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.
154154
155-
3. Select **Yes** in the User Account Control dialog box.
155+
1. Select **Yes** in the User Account Control dialog box.
156156
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:
158158
159159
```console
160160
@@ -165,20 +165,20 @@ To collect a WPR trace using the command-line tool wpr.exe:
165165
> [!WARNING]
166166
> 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.
167167
168-
5. Reproduce the issue.
168+
1. Reproduce the issue.
169169

170170
> [!TIP]
171171
> 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.
172172
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:
174174

175175
```console
176176
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"
177177
```
178178

179-
7. Wait until the trace is merged.
179+
1. Wait until the trace is merged.
180180

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.
182182

183183
## See also
184184

0 commit comments

Comments
 (0)