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
+47-14Lines changed: 47 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,6 +21,12 @@ ms.custom:
21
21
22
22
# Troubleshoot Microsoft Defender Antivirus performance issues with WPRUI
23
23
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
+
24
30
## Capture performance logs using Windows Performance Recorder
25
31
26
32
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
29
35
30
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.
31
37
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
@@ -39,26 +72,26 @@ Alternatively, follow the steps in [Capture performance logs using the WPR UI](/
39
72
1. Under *Windows Kits*, right-click **Windows Performance Recorder**.
40
73
41
74

42
-
75
+
43
76
1. Select **More**. Select **Run as administrator**.
44
77
45
78
1. Right-click **Yes** when the User Account Control dialog box appears.
46
79
47
80

48
-
81
+
49
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`.
50
83
51
84
1. In the WPR dialog box, select **More options**.
52
85
53
86

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

60
-
61
-
> [!WARNING]
93
+
94
+
> [!WARNING]
62
95
> 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.
63
96
> This custom profile provides the necessary context for in-depth performance analysis.
64
97
@@ -80,11 +113,11 @@ Alternatively, follow the steps in [Capture performance logs using the WPR UI](/
80
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.
81
114
82
115

83
-
116
+
84
117
1. Select **Start**.
85
118
86
119

87
-
120
+
88
121
1. Reproduce the issue.
89
122
90
123
> [!TIP]
@@ -93,25 +126,25 @@ Alternatively, follow the steps in [Capture performance logs using the WPR UI](/
93
126
1. Select **Save**.
94
127
95
128

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

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

106
-
139
+
107
140
1. After the trace has been merged and saved, right-click **Open folder**.
108
141
109
142

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.
112
145
113
146

114
-
147
+
115
148
### Capture performance logs using the WPR CLI
116
149
117
150
To collect a WPR trace using the command-line tool wpr.exe:
0 commit comments