Skip to content

Commit 115d823

Browse files
committed
Learn Editor: Update troubleshoot-av-performance-issues-with-wprui.md
1 parent 425636b commit 115d823

File tree

1 file changed

+47
-14
lines changed

1 file changed

+47
-14
lines changed

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

Lines changed: 47 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,12 @@ ms.custom:
2121

2222
# Troubleshoot Microsoft Defender Antivirus performance issues with WPRUI
2323

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.
29+
2430
## Capture performance logs using Windows Performance Recorder
2531

2632
Windows Performance Recorder (WPR) is a powerful recording tool that creates Event Tracing for Windows recordings and allows you to include additional information in your submission to Microsoft support.
@@ -29,6 +35,33 @@ WPR is part of the Windows Assessment and Deployment Kit (Windows ADK) and can b
2935

3036
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.
3137

38+
There are two ways to capture a Windows Performance Recorder (WPRUI) trace:
39+
40+
Using the MDE Client Analyzer
41+
42+
Manually
43+
44+
## Using the MDE Client Analyzer
45+
46+
1. Download the [MDE Client Analyzer ](/defender-endpoint/download-client-analyzer).
47+
48+
1. Run the MDE Client Analyzer using [Live Response or locally](/defender-endpoint/run-analyzer-windows).
49+
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.
52+
53+
54+
55+
1. Run the MDE Client Analyzer with the -a and -v switches
56+
57+
PowerShellCopy
58+
59+
```
60+
C:\Work\tools\MDEClientAnalyzer\MDEClientAnalyzer.cmd
61+
```
62+
63+
## Manually:
64+
3265
### Capture performance logs using the WPR UI
3366

3467
> [!TIP]
@@ -39,26 +72,26 @@ Alternatively, follow the steps in [Capture performance logs using the WPR UI](/
3972
1. Under *Windows Kits*, right-click **Windows Performance Recorder**.
4073

4174
![Screenshot showing the Start menu](media/wpr-01.png)
42-
75+
4376
1. Select **More**. Select **Run as administrator**.
4477

4578
1. Right-click **Yes** when the User Account Control dialog box appears.
4679

4780
![Screenshot showing the UAC page.](media/wpt-yes.png)
48-
81+
4982
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`.
5083

5184
1. In the WPR dialog box, select **More options**.
5285

5386
![Screenshot showing the page where you can select more options](media/wpr-03.png)
54-
87+
5588
1. Select **Add Profiles...** and browse to the path of the `MDAV.wprp` file.
5689

5790
1. A new profile named Microsoft Defender for Endpoint analysis should appear under Custom measurements.
5891

5992
![Screenshot showing the in-file.](media/wpr-infile.png)
60-
61-
> [!WARNING]
93+
94+
> [!WARNING]
6295
> 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.
6396
> This custom profile provides the necessary context for in-depth performance analysis.
6497
@@ -80,11 +113,11 @@ Alternatively, follow the steps in [Capture performance logs using the WPR UI](/
80113
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.
81114

82115
![Screenshot showing the Hide options.](media/wpr-08.png)
83-
116+
84117
1. Select **Start**.
85118

86119
![Screenshot showing the Record system information page.](media/wpr-09.png)
87-
120+
88121
1. Reproduce the issue.
89122

90123
> [!TIP]
@@ -93,25 +126,25 @@ Alternatively, follow the steps in [Capture performance logs using the WPR UI](/
93126
1. Select **Save**.
94127

95128
![Screenshot showing the Save option.](media/wpr-10.png)
96-
129+
97130
1. Fill in **Type in a detailed description of the problem:** with information about the problem and how you reproduced the issue.
98131

99132
![Screenshot showing the pane in which you fill.](media/wpr-12.png)
100-
133+
101134
1. Select **File Name:** to determine where your trace file is saved. By default, it's saved to `%user%\Documents\WPR Files\`.
102135

103-
1. Select **Save**.
136+
1. Select **Save**.
104137

105138
![Screenshot showing the WPR gathering general trace.](media/wpr-13.png)
106-
139+
107140
1. After the trace has been merged and saved, right-click **Open folder**.
108141

109142
![Screenshot that displays the notification that WPR trace has been saved.](media/wpr-14.png)
110-
111-
Include both the file and the folder in your submission to Microsoft Support.
143+
144+
Include both the file and the folder in your submission to Microsoft Support.
112145

113146
![Screenshot showing the details of the file and the folder.](media/wpr-15.png)
114-
147+
115148
### Capture performance logs using the WPR CLI
116149

117150
To collect a WPR trace using the command-line tool wpr.exe:

0 commit comments

Comments
 (0)