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/health-status.md
+44-38Lines changed: 44 additions & 38 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ ms.collection:
13
13
ms.topic: conceptual
14
14
ms.subservice: onboard
15
15
search.appverid: met150
16
-
ms.date: 05/06/2021
16
+
ms.date: 11/04/2024
17
17
---
18
18
19
19
# Investigate agent health issues
@@ -24,53 +24,59 @@ ms.date: 05/06/2021
24
24
-[Microsoft Defender for Endpoint Plan 2](microsoft-defender-endpoint.md)
25
25
-[Microsoft Defender XDR](/defender-xdr)
26
26
27
-
The following table provides information on the values returned when you run the `mdatp health` command and their corresponding descriptions.
27
+
The following table provides information about the values that are returned when you run the `mdatp health` command and their corresponding descriptions.
28
28
29
-
|Value|Description|
29
+
|Value|Description|
30
30
|---|---|
31
-
|automatic_definition_update_enabled|True if automatic antivirus definition updates are enabled, false otherwise.|
32
-
|cloud_automatic_sample_submission_consent|Current sample submission level. Can be one of the following values: <ul><li>**None**: No suspicious samples are submitted to Microsoft.</li><li>**Safe**: Only suspicious samples that don't contain personally identifiable information (PII) are submitted automatically. This is the default value for this setting.</li><li>**All**: All suspicious samples are submitted to Microsoft.</li></ul>|
33
-
|cloud_diagnostic_enabled|True if optional diagnostic data collection is enabled, false otherwise. For more information related to Defender for Endpoint and other products and services like Microsoft Defender Antivirus and Windows, see [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?linkid=827576).|
34
-
|cloud_enabled|True if cloud-delivered protection is enabled, false otherwise.|
35
-
|conflicting_applications|List of applications that are possibly conflicting with Microsoft Defender for Endpoint. This list includes, but isn't limited to, other security products and other applications known to cause compatibility issues.|
36
-
|definitions_status|Status of antivirus definitions.|
37
-
|definitions_updated|Date and time of last antivirus definition update.|
38
-
|definitions_updated_minutes_ago|Number of minutes since last antivirus definition update.|
|edr_device_tags|List of tags associated with the device.|
43
-
|edr_group_ids|Group ID that the device is associated with.|
44
-
|edr_machine_id|Device identifier used in Microsoft Defender XDR.|
45
-
|engine_version|Version of the antivirus engine.|
46
-
|healthy|True if the product is healthy, false otherwise.|
47
-
|licensed|True if the device is onboarded to a tenant, false otherwise.|
48
-
|log_level|Current log level for the product.|
49
-
|machine_guid|Unique machine identifier used by the antivirus component.|
50
-
|network_protection_status|Status of the network protection component (macOS only). Can be one of the following values: <ul><li>**starting** - Network protection is starting</li><li>**failed_to_start** - Network protection couldn't be started due to an error</li><li>**started** - Network protection is currently running on the device</li><li>**restarting** - Network protection is currently restarting</li><li>**stopping** - Network protection is stopping</li><li>**stopped** - Network protection isn't running</li></ul>|
51
-
|org_id|Organization that the device is onboarded to. If the device isn't yet onboarded to any organization, this prints unavailable. For more information on onboarding, see [Onboard to Microsoft Defender for Endpoint](onboarding.md).|
52
-
|passive_mode_enabled|True if the antivirus component is set to run in passive mode, false otherwise.|
53
-
|product_expiration|Date and time when the current product version reaches end of support.|
54
-
|real_time_protection_available|True if the real-time protection component is healthy, false otherwise.|
55
-
|real_time_protection_enabled|True if real-time antivirus protection is enabled, false otherwise.|
56
-
|real_time_protection_subsystem|Subsystem used to serve real-time protection. If real-time protection isn't operating as expected, this prints unavailable.|
57
-
|release_ring|Release ring. For more information, see [Deployment rings](onboarding.md).|
31
+
|`app_version`| Displays Microsoft Defender application version.|
32
+
|`automatic_definition_update_enabled`|`True` if automatic antivirus definition updates are enabled; otherwise, `false`.|
33
+
|`behavior_monitoring`|Feature to detect real time threats and prevention by monitoring the behavior of applications, services, and files.<br/><br/>Can have one of the following values: <br/>- **disabled** - default <br/>- **enabled**|
34
+
|`cloud_automatic_sample_submission_consent`|Current sample submission level. <br/><br/>Can have one of the following values: <br/>- **None**: No suspicious samples are submitted to Microsoft.<br/>- **safe**: Only suspicious samples that don't contain personal data are submitted automatically. This value is the default value for this setting.<br/>- **All**: All suspicious samples are submitted to Microsoft.|
35
+
|`cloud_diagnostic_enabled`|`True` if optional diagnostic data collection is enabled; otherwise, `false`. <br/><br/>For more information related to Defender for Endpoint and other products and services like Microsoft Defender Antivirus and Windows, see [Microsoft Privacy Statement](https://go.microsoft.com/fwlink/?linkid=827576).|
36
+
|`cloud_enabled`|`True` if cloud-delivered protection is enabled; otherwise, `false`.|
37
+
|`conflicting_applications`|List of applications that are possibly conflicting with Microsoft Defender for Endpoint. This list includes, but isn't limited to, other security products and other applications known to cause compatibility issues.|
38
+
|`definitions_status`|Status of antivirus definitions. Can have one of the following values: <br/>- **up_to_date**<br/>- **updating**<br/>- **unavailable**|
39
+
|`definitions_updated`|Date and time of last antivirus definition update.|
40
+
|`definitions_updated_minutes_ago`|Number of minutes since last antivirus definition update.|
|`edr_device_tags`|List of tags associated with the device.|
45
+
|`edr_early_preview_enabled`|Setting of edr early preview. Can have one of the following values: <br/>- **disabled** <br/>- **enabled**|
46
+
|`edr_group_ids`|Group ID that the device is associated with.|
47
+
|`edr_machine_id`|Device identifier used in the Microsoft Defender portal.|
48
+
|`engine_load_status`|Status of antivirus engine to determine whether it's running. <br/><br/>Can have one of the following values: <br/>- **Engine not loaded** - antivirus engine process is down<br/>- **Engine load succeeded** - antivirus engine process is up and running|
49
+
|`engine_version`|Version of the antivirus engine.|
50
+
|`healthy`|`True` if the product is healthy; otherwise, `false`.|
51
+
|`health_issues`|Lists health issues if any.|
52
+
|`licensed`|`True` if the device is onboarded to a tenant; otherwise, `false`.|
53
+
|`log_level`|Current log level for the product. <br/><br/>Can have one of the following values: <br/>- **info** <br/>- **debug**|
54
+
|`machine_guid`|Unique machine identifier used by the antivirus component.|
55
+
|`network_protection_enforcement_level`|Mode of network protection. <br/><br/>Can have one of the following: <br/>- **disabled** - all components associated with network protection are disabled<br/>- **block** - network protection prevents connection to malicious websites<br/>- **audit** - Check how blocks occur|
56
+
|`network_protection_status`|Status of the network protection component (macOS only).<br/><br/> Can have one of the following values: <br/>- **starting** - Network protection is starting<br/>- **failed_to_start** - Network protection couldn't be started due to an error<br/>- **started** - Network protection is running on the device<br/>- **restarting** - Network protection is restarting<br/>- **stopping** - Network protection is stopping<br/>- **stopped** - Network protection isn't running|
57
+
|`org_id`|Organization that the device is onboarded to. If the device isn't yet onboarded to any organization, it shows as `unavailable`. For more information on onboarding, see [Onboard to Microsoft Defender for Endpoint](onboarding.md).|
58
+
|`passive_mode_enabled`|`True` if the antivirus component is set to run in passive mode; otherwise, `false`.|
59
+
|`product_expiration`|Date and time when the current product version reaches end of support.|
60
+
|`real_time_protection_available`|`True` if the real-time protection component is healthy; otherwise, `false`.|
61
+
|`real_time_protection_enabled`|`True` if real-time antivirus protection is enabled; otherwise, `false`.|
62
+
|`real_time_protection_subsystem`|Subsystem used to serve real-time protection. If real-time protection isn't operating as expected, it shows as `unavailable`.|
63
+
|`release_ring`|Release ring. For more information, see [Deployment rings](onboarding.md).|
64
+
|`supplementary_events_subsystem`|Subsystem that provides supplementary event data. Can have one of the following values: <br/>- **ebpf** - Default from app version: `101.2408.0000`<br/>- **auditd**|
58
65
59
66
## Component specific health
60
67
61
68
You can get more detailed health information for different Defender's features with `mdatp health --details <feature>`. For example:
0 commit comments