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/linux-preferences.md
+57-15Lines changed: 57 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ ms.service: defender-endpoint
6
6
ms.author: deniseb
7
7
author: denisebmsft
8
8
ms.localizationpriority: medium
9
-
ms.date: 10/14/2024
9
+
ms.date: 01/13/2025
10
10
manager: deniseb
11
11
audience: ITPro
12
12
ms.collection:
@@ -79,7 +79,10 @@ Specifies the enforcement preference of antivirus engine. There are three values
79
79
> Available in Defender for Endpoint version `101.10.72` or later. Default is changed from `real_time` to `passive` in Defender for Endpoint version `101.23062.0001` or later.
80
80
> It is recommended to also use [scheduled scans](/defender-endpoint/linux-schedule-scan-mde) as per requirement.
81
81
82
-
#### Enable/disable behavior monitoring
82
+
#### Enable/disable behavior monitoring [only if RTP is enabled]
83
+
84
+
> [!IMPORTANT]
85
+
> This feature only works when the enforcement level is set to `real-time`.
83
86
84
87
Determines whether behavior monitoring and blocking capability is enabled on the device or not.
85
88
@@ -91,10 +94,13 @@ Determines whether behavior monitoring and blocking capability is enabled on the
91
94
92
95
> [!NOTE]
93
96
> Available in Defender for Endpoint version `101.45.00` or later.
94
-
> This feature is applicable only when real-time protection is enabled.
97
+
95
98
96
99
#### Run a scan after definitions are updated
97
100
101
+
> [!IMPORTANT]
102
+
> This feature only works when the enforcement level is set to `real-time`.
103
+
98
104
Specifies whether to start a process scan after new security intelligence updates are downloaded on the device. Enabling this setting triggers an antivirus scan on the running processes of the device.
99
105
100
106
|Description|JSON Value|Defender Portal Value|
@@ -105,7 +111,6 @@ Specifies whether to start a process scan after new security intelligence update
105
111
106
112
> [!NOTE]
107
113
> Available in Defender for Endpoint version `101.45.00` or later.
108
-
> This feature only works when the enforcement level is set to `real-time`.
@@ -266,7 +271,7 @@ To remove both NFS and Fuse from unmonitored list of filesystems, do the followi
266
271
> [!NOTE]
267
272
> Here's the default list of monitored filesystems for RTP: `btrfs`, `ecryptfs`, `ext2`, `ext3`, `ext4`, `fuseblk`, `jfs`, `overlay`, `ramfs`, `reiserfs`, `tmpfs`, `vfat`, `xfs`.
268
273
>
269
-
> If any monitored filesystem needs to be added to the list of unmonitored filesystems,then it needs to be evaluated and enabled by Microsoft via cloud config. Following which customers can update managed_mdatp.json to unmonitor that filesystem.
274
+
> If any monitored filesystem needs to be added to the list of unmonitored filesystems,then it needs to be evaluated and enabled by Microsoft via cloud config. Following which customers can update managed_mdatp.json to unmonitor that filesystem.
270
275
271
276
272
277
@@ -380,7 +385,7 @@ Specify the maximum number of entries to keep in the scan history. Entries inclu
380
385
381
386
### Exclusion setting preferences
382
387
383
-
**Exlusion setting preferences are currently in preview**.
388
+
**Exclusion setting preferences are currently in preview**.
384
389
385
390
> [!NOTE]
386
391
> Global exclusions are currently in public preview, and are available in Defender for Endpoint beginning with version `101.23092.0012` or later in the Insiders Slow and Production rings.
@@ -429,7 +434,7 @@ Specifies the type of content excluded from the scan.
429
434
430
435
##### Scopes of exclusion (optional)
431
436
432
-
Specifies the set of exlusion scopes of content excluded. Currently supported scopes are `epp` and `global`.
437
+
Specifies the set of exclusion scopes of content excluded. Currently supported scopes are `epp` and `global`.
433
438
434
439
If nothing is specified in for an exclusion under *exclusionSettings* in managed configuration, then `global` is considered as scope.
435
440
@@ -496,8 +501,8 @@ Specifies a process for which all file activity is excluded from scanning. The p
496
501
497
502
The following settings can be configured to enable certain advanced scanning features.
498
503
499
-
> [!NOTE]
500
-
> Enabling these features might impact device performance. As such, it is recommended to keep the defaults.
504
+
> [!IMPORTANT]
505
+
> Enabling these features might impact device performance. As such, it is recommended to keep the defaults unless recommended otherwise by Microsoft Support.
501
506
502
507
##### Configure scanning of file modify permissions events
503
508
@@ -632,8 +637,8 @@ Depending on the enforcement level, the automatic security intelligence updates
632
637
633
638
The following settings can be configured to enable certain advanced features.
634
639
635
-
>[!NOTE]
636
-
>Enabling these features might impact device performance. It is recommended to keep the defaults.
640
+
>[!IMPORTANT]
641
+
>Enabling these features might impact device performance. It is recommended to keep the defaults unless recommended otherwise by Microsoft Support.
##### Configure monitoring of file modify ownership events
683
688
684
-
Determines whether file modify ownership events (chown) are monitored.
689
+
Determines whether file modify ownership events (`chown`) are monitored.
685
690
686
691
> [!NOTE]
687
692
> When this feature is enabled, Defender for Endpoint will monitor changes to the ownership of files, but not scan these events. For more information, see [Advanced scanning features](linux-preferences.md#configure-scanning-of-file-modify-ownership-events) section for more details.
@@ -764,6 +769,42 @@ Determines whether module load events are monitored using eBPF and scanned.
|**Comments**|Available in Defender for Endpoint version `101.24072.0001` or later.|
807
+
767
808
#### Report AV Suspicious Events to EDR
768
809
769
810
Determines whether suspicious events from Antivirus are reported to EDR.
@@ -777,11 +818,12 @@ Determines whether suspicious events from Antivirus are reported to EDR.
777
818
778
819
### Network protection configurations
779
820
780
-
The following settings can be used to configure advanced Network Protection inspection features to control what traffic gets inspected by Network Protection.
781
-
782
821
> [!NOTE]
822
+
> This is a preview feature.
783
823
> For these to be effective, Network Protection has to be turned on. For more information, see [Turn on network protection for Linux](network-protection-linux.md).
784
824
825
+
The following settings can be used to configure advanced Network Protection inspection features to control what traffic gets inspected by Network Protection.
826
+
785
827
|Description|JSON Value|Defender Portal Value|
786
828
|---|---|---|
787
829
|**Key**|networkProtection|Network protection|
@@ -1023,7 +1065,7 @@ If the JSON is well-formed, the above command outputs it back to the Terminal an
1023
1065
1024
1066
## Verifying that the mdatp_managed.json file is working as expected
1025
1067
1026
-
To verify that your /etc/opt/microsoft/mdatp/managed/mdatp_managed.json is working properly, you should see "[managed]" next to these settings:
1068
+
To verify that your `/etc/opt/microsoft/mdatp/managed/mdatp_managed.json` is working properly, you should see "[managed]" next to these settings:
- Upgraded the Bond version to 13.0.1 to address security vulnerabilities in versions 12 or lower.
59
+
60
+
- Mdatp package no longer has a dependency on SELinux packages.
61
+
62
+
- User can now query the status of supplementary event provider eBPF using the threat hunting query in DeviceTvmInfoGathering. To learn more about this query check: [Use eBPF-based sensor for Microsoft Defender for Endpoint on Linux](/defender-endpoint/linux-support-ebpf). The result of this query can return the following two values as eBPF status:
63
+
- Enabled: When eBPF is enabled as working as expected.
64
+
- Disabled: When eBPF is disabled due to one of the following reasons:
65
+
- When MDE is using auditD as a supplementary sensor
66
+
- When eBPF is not present and we fallback to Netlink as supplementary event provider
67
+
- There is no supplementary sensor present.
68
+
69
+
- Starting from 2411, the MDATP package release to Production on packages.microsoft.com will follow a gradual rollout mechanism which spans over a week. The other release rings, insiderFast and insiderSlow, are unaffected by this change.
70
+
71
+
- Stability and performance improvements.
72
+
73
+
- Critical bugs fixes around definition update flow.
Copy file name to clipboardExpand all lines: defender-endpoint/troubleshoot-av-performance-issues-with-wprui.md
+67-23Lines changed: 67 additions & 23 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 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 doesn't 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
+
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,62 +35,88 @@ 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 the Windows Performance Recorder (WPRUI) trace:
39
+
40
+
1. Using the MDE Client Analyzer
41
+
42
+
1. 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, make sure the issue is reproducible. Additionally, close any applications that don't contribute to the reproduction of the issue.
52
+
53
+
54
+
1. Run the MDE Client Analyzer with the `-a` and `-v` switches.
> 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.
36
68
37
69
1. Download and install WPR.
38
70
39
71
1. Under *Windows Kits*, right-click **Windows Performance Recorder**.
40
72
41
73

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

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

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

60
-
92
+
61
93
> [!WARNING]
62
-
> 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 might consume a high amount of nonpaged pool memory or buffers, leading to system instability. To address this, explore**Resource Analysis** to choose profiles to add.
63
95
> This custom profile provides the necessary context for in-depth performance analysis.
64
96
65
97
1. To use the custom measurement Microsoft Defender for Endpoint verbose analysis profile in the WPR UI:
66
98
67
99
1. Ensure no profiles are selected under the *First-level triage*, *Resource Analysis* and *Scenario Analysis* groups.
68
100
69
-
2. Select **Custom measurements**.
101
+
1. Select **Custom measurements**.
70
102
71
-
3. Select **Microsoft Defender for Endpoint analysis**.
103
+
1. Select **Microsoft Defender for Endpoint analysis**.
72
104
73
-
4. Select **Verbose** under *Detail* level.
105
+
1. Select **Verbose** under *Detail* level.
74
106
75
-
5. Select **File** or **Memory** under Logging mode.
107
+
1. Select **File** or **Memory** under Logging mode.
76
108
77
109
> [!IMPORTANT]
78
-
> 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.
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 can't 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.
79
111
80
-
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
+
1. Now you're ready to collect data. Close all unnecessary applications. Select**Hide options** to keep the space occupied by the WPR window small.
81
113
82
114

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

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

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

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

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

110
-
111
-
Include both the file and the folder in your submission to Microsoft Support.
142
+
143
+
1. Include both the file and the folder in your submission to Microsoft Support.
112
144
113
145

114
-
146
+
115
147
### Capture performance logs using the WPR CLI
116
148
117
149
To collect a WPR trace using the command-line tool wpr.exe:
@@ -131,7 +163,7 @@ To collect a WPR trace using the command-line tool wpr.exe:
131
163
```
132
164
133
165
> [!WARNING]
134
-
> 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.
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 nonpaged pool memory or buffers, leading to system instability.
135
167
136
168
1. Reproduce the issue.
137
169
@@ -150,8 +182,20 @@ To collect a WPR trace using the command-line tool wpr.exe:
150
182
151
183
## See also
152
184
185
+
-[Run the client analyzer on Windows](/defender-endpoint/run-analyzer-windows)
186
+
153
187
-[Collect Microsoft Defender Antivirus diagnostic data](collect-diagnostic-data.md)
188
+
189
+
-[Troubleshoot Microsoft Defender Antivirus settings](/defender-endpoint/troubleshoot-settings)
190
+
154
191
-[Configure and validate exclusions for Microsoft Defender Antivirus scans](configure-exclusions-microsoft-defender-antivirus.md)
192
+
193
+
-[Troubleshoot performance issues related to Microsoft Defender Antivirus](/defender-endpoint/troubleshoot-performance-issues)
194
+
155
195
-[Performance analyzer for Microsoft Defender Antivirus](tune-performance-defender-antivirus.md)
156
196
157
-
[!INCLUDE [Microsoft Defender for Endpoint Tech Community](../includes/defender-mde-techcommunity.md)]
197
+
-[Troubleshoot Microsoft Defender Antivirus performance issues with Process Monitor](/defender-endpoint/troubleshoot-av-performance-issues-with-procmon)
198
+
199
+
-[Troubleshoot Microsoft Defender Antivirus performance issues with WPRUI](/defender-endpoint/troubleshoot-av-performance-issues-with-wprui)
200
+
201
+
[!INCLUDE [Microsoft Defender for Endpoint Tech Community](../includes/defender-mde-techcommunity.md)]
0 commit comments