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/mac-support-perf.md
+26-26Lines changed: 26 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ ms.collection:
14
14
ms.topic: conceptual
15
15
ms.subservice: macos
16
16
search.appverid: met150
17
-
ms.date: 03/20/2024
17
+
ms.date: 05/29/2024
18
18
---
19
19
20
20
# Troubleshoot performance issues for Microsoft Defender for Endpoint on macOS
@@ -27,7 +27,6 @@ ms.date: 03/20/2024
27
27
-[Microsoft Defender for Endpoint Plan 1 and Plan 2](microsoft-defender-endpoint.md)
28
28
-[Microsoft Defender for Individuals](https://www.microsoft.com/microsoft-365/microsoft-defender-for-individuals)
29
29
30
-
31
30
> Want to experience Microsoft Defender for Endpoint? [Sign up for a free trial.](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink)
32
31
33
32
This article provides some general steps that can be used to narrow down performance issues related to Defender for Endpoint on macOS.
@@ -41,7 +40,7 @@ Depending on the applications that you're running and your device characteristic
41
40
42
41
**Applies to:**
43
42
44
-
- Only performance issues related to Microsoft Defender Antivirus (`wdavdaemon_unpriviliged`).
43
+
- Only performance issues related to Microsoft Defender Antivirus (`wdavdaemon_unprivileged`).
45
44
46
45
Real-time protection (RTP) is a feature of Defender for Endpoint on macOS that continuously monitors and protects your device against threats. It consists of file and process monitoring and other heuristics.
47
46
@@ -50,7 +49,10 @@ Prerequisites:
50
49
- Microsoft Defender for Endpoint version (Platform Update) 100.90.70 or newer
51
50
- If you have [Tamper protection](tamperprotection-macos.md) turned on in block mode, use [Troubleshooting mode](mac-troubleshoot-mode.md) to capture real-time-protection-statistics. Otherwise, you will get null results.
52
51
53
-
To troubleshoot and mitigate such issues, follow these steps:
52
+
> [!TIP]
53
+
> As a general best practice, it is recommended to update the [Microsoft Defender for Endpoint agent to latest available version](linux-whatsnew.md) and confirming that the issue still persists before investigating further.
54
+
55
+
To troubleshoot and mitigate performance issues, follow these steps:
54
56
55
57
1. Disable real-time protection by using one of the methods in the following table, and then observe whether performance improves. This approach helps narrow down whether Microsoft Defender for Endpoint on macOS is contributing to the performance issues.
56
58
@@ -59,51 +61,53 @@ To troubleshoot and mitigate such issues, follow these steps:
59
61
| Device isn't managed by organization |**User interface**: Open Microsoft Defender for Endpoint on macOS and navigate to **Manage settings**. |
60
62
| Device isn't managed by organization |**Terminal**: In Terminal, run the following command: `mdatp config real-time-protection --value disabled`|
61
63
| Device is managed by organization | See [Set preferences for Microsoft Defender for Endpoint on macOS](mac-preferences.md). |
62
-
64
+
63
65
If the performance problem persists while real-time protection is off, the origin of the problem could be the endpoint detection and response component. In this case, contact customer support for further instructions and mitigation.
64
-
66
+
65
67
2. Open Finder and navigate to **Applications** > **Utilities**. Open **Activity Monitor** and analyze which applications are using the resources on your system. Typical examples include software updaters and compilers.
66
68
67
69
3. This feature requires real-time protection to be enabled. To check the status of real-time protection, run the following command:
68
70
69
71
```bash
70
72
mdatp health --field real_time_protection_enabled
71
73
```
72
-
74
+
73
75
Verify that the **real_time_protection_enabled** entry is *true*. Otherwise, run the following command to enable it:
74
-
76
+
75
77
```bash
76
78
mdatp config real-time-protection --value enabled
77
79
```
78
-
80
+
79
81
```output
80
82
Configuration property updated
81
83
```
82
-
83
-
4. To find the applications that are triggering the most scans, you can use real-time statistics gathered by Defender for Endpoint on macOS. Run the following command:
84
+
85
+
4. To find the applications that are triggering the most scans, you can use real-time statistics gathered by Defender for Endpoint on macOS. Run the following command to enable it:
> Before proceeding to capture the data, make sure that the high cpu utilization is occurring in the wdavdaemon_unprivileged by either running top or opening `activity monitor`.
88
93
89
-
This feature requires real-time protection to be enabled. To check the status of real-time protection, run the following command:
94
+
5. To output to a json file, run the following command:
> Using `--output json` (note the double dash) ensures that the output format is ready for parsing. The output of this command will show all processes and their associated scan activity.
102
+
6. On your Mac system, download the sample Python parser `high_cpu_parser.py` using the command:
97
103
98
-
5. On your Mac system, download the sample Python parser `high_cpu_parser.py` using the command:
@@ -115,7 +119,7 @@ To troubleshoot and mitigate such issues, follow these steps:
115
119
0s
116
120
```
117
121
118
-
6. Type the following commands:
122
+
7. Type the following commands:
119
123
120
124
```bash
121
125
chmod +x high_cpu_parser.py
@@ -141,12 +145,12 @@ To troubleshoot and mitigate such issues, follow these steps:
141
145
125 CrashPlanService 164
142
146
```
143
147
144
-
7. To improve the performance of Defender for Endpoint on Mac, locate the one with the highest number under the **Total files scanned** row, and then add an exclusion for it. For more information, see [Configure and validate exclusions for Defender for Endpoint on macOS](mac-exclusions.md).
148
+
8. To improve the performance of Defender for Endpoint on Mac, locate the one with the highest number under the **Total files scanned** row, and then add an exclusion for it. For more information, see [Configure and validate exclusions for Defender for Endpoint on macOS](mac-exclusions.md).
145
149
146
150
> [!NOTE]
147
151
> The application stores statistics in memory and only keeps track of file activity since it was started and real-time protection was enabled. Processes that were launched before or during periods when real time protection was off are not counted. Additionally, only events which triggered scans are counted.
148
152
149
-
7. Configure Microsoft Defender for Endpoint on macOS with exclusions for the processes or disk locations that contribute to the performance issues and re-enable real-time protection.
153
+
9. Configure Microsoft Defender for Endpoint on macOS with exclusions for the processes or disk locations that contribute to the performance issues and re-enable real-time protection.
150
154
151
155
See [Configure and validate exclusions for Microsoft Defender for Endpoint on macOS](mac-exclusions.md).
152
156
@@ -157,8 +161,4 @@ The Microsoft Defender for Endpoint Client Analyzer (MDECA) can collect traces,
157
161
To run the client analyzer for troubleshooting performance issues, see [Run the client analyzer on macOS and Linux](run-analyzer-macos-linux.md).
158
162
159
163
> [!NOTE]
160
-
>
161
-
> - The Microsoft Defender for Endpoint Client Analyzer tool is regularly used by Microsoft Customer Support Services (CSS) to collect information such as (but not limited to) IP addresses, PC names that will help troubleshoot issues you may be experiencing with Microsoft Defender for Endpoint. For more information about our privacy statement, see [Microsoft Privacy Statement](https://privacy.microsoft.com/privacystatement).
162
-
> - As a general best practice, it is recommended to update the [Microsoft Defender for Endpoint agent to latest available version](linux-whatsnew.md) and confirming that the issue still persists before investigating further.
163
-
164
-
164
+
> The Microsoft Defender for Endpoint Client Analyzer tool is regularly used by Microsoft Customer Support Services (CSS) to collect information such as (but not limited to) IP addresses, PC names that will help troubleshoot issues you may be experiencing with Microsoft Defender for Endpoint. For more information about our privacy statement, see [Microsoft Privacy Statement](https://privacy.microsoft.com/privacystatement).
0 commit comments