Skip to content

Commit fb3fb33

Browse files
Merge pull request #536 from YongRhee-MSFT/docs-editor/mac-support-perf-1716589794
Update mac-support-perf.md
2 parents 45ee56e + 23bd9a3 commit fb3fb33

File tree

1 file changed

+26
-26
lines changed

1 file changed

+26
-26
lines changed

defender-endpoint/mac-support-perf.md

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.collection:
1414
ms.topic: conceptual
1515
ms.subservice: macos
1616
search.appverid: met150
17-
ms.date: 03/20/2024
17+
ms.date: 05/29/2024
1818
---
1919

2020
# Troubleshoot performance issues for Microsoft Defender for Endpoint on macOS
@@ -27,7 +27,6 @@ ms.date: 03/20/2024
2727
- [Microsoft Defender for Endpoint Plan 1 and Plan 2](microsoft-defender-endpoint.md)
2828
- [Microsoft Defender for Individuals](https://www.microsoft.com/microsoft-365/microsoft-defender-for-individuals)
2929

30-
3130
> 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)
3231
3332
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
4140

4241
**Applies to:**
4342

44-
- Only performance issues related to Microsoft Defender Antivirus (`wdavdaemon_unpriviliged`).
43+
- Only performance issues related to Microsoft Defender Antivirus (`wdavdaemon_unprivileged`).
4544

4645
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.
4746

@@ -50,7 +49,10 @@ Prerequisites:
5049
- Microsoft Defender for Endpoint version (Platform Update) 100.90.70 or newer
5150
- 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.
5251

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

5557
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.
5658

@@ -59,51 +61,53 @@ To troubleshoot and mitigate such issues, follow these steps:
5961
| Device isn't managed by organization | **User interface**: Open Microsoft Defender for Endpoint on macOS and navigate to **Manage settings**. |
6062
| Device isn't managed by organization | **Terminal**: In Terminal, run the following command: `mdatp config real-time-protection --value disabled` |
6163
| Device is managed by organization | See [Set preferences for Microsoft Defender for Endpoint on macOS](mac-preferences.md). |
62-
64+
6365
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+
6567
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.
6668

6769
3. This feature requires real-time protection to be enabled. To check the status of real-time protection, run the following command:
6870

6971
```bash
7072
mdatp health --field real_time_protection_enabled
7173
```
72-
74+
7375
Verify that the **real_time_protection_enabled** entry is *true*. Otherwise, run the following command to enable it:
74-
76+
7577
```bash
7678
mdatp config real-time-protection --value enabled
7779
```
78-
80+
7981
```output
8082
Configuration property updated
8183
```
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:
8486

8587
```bash
8688
mdatp config real-time-protection-statistics --value enabled.
8789
```
90+
91+
> [!TIP]
92+
> 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`.
8893
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:
9095

9196
```bash
9297
mdatp diagnostic real-time-protection-statistics --output json > real_time_protection.json
9398
```
94-
99+
95100
> [!NOTE]
96101
> 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:
97103

98-
5. On your Mac system, download the sample Python parser `high_cpu_parser.py` using the command:
99-
100-
```bash
104+
```bash
101105
curl -O https://raw.githubusercontent.com/microsoft/mdatp-xplat/master/linux/diagnostic/high_cpu_parser.py
102106
```
103107

104-
The output of this command should be similar to the following:
108+
The output of this command should be similar to the following:
105109

106-
```Output
110+
```Output
107111
--2020-11-14 11:27:27-- https://raw.githubusercontent.com/microsoft.
108112
mdatp-xplat/master/linus/diagnostic/high_cpu_parser.py
109113
Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 151.101.xxx.xxx
@@ -115,7 +119,7 @@ To troubleshoot and mitigate such issues, follow these steps:
115119
0s
116120
```
117121

118-
6. Type the following commands:
122+
7. Type the following commands:
119123

120124
```bash
121125
chmod +x high_cpu_parser.py
@@ -141,12 +145,12 @@ To troubleshoot and mitigate such issues, follow these steps:
141145
125 CrashPlanService 164
142146
```
143147

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

146150
> [!NOTE]
147151
> 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.
148152
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.
150154

151155
See [Configure and validate exclusions for Microsoft Defender for Endpoint on macOS](mac-exclusions.md).
152156

@@ -157,8 +161,4 @@ The Microsoft Defender for Endpoint Client Analyzer (MDECA) can collect traces,
157161
To run the client analyzer for troubleshooting performance issues, see [Run the client analyzer on macOS and Linux](run-analyzer-macos-linux.md).
158162

159163
> [!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

Comments
 (0)