Skip to content

Commit a191858

Browse files
authored
Merge pull request #3400 from MicrosoftDocs/maccruz-analytics
Note about custom detections
2 parents 56f8610 + 4555356 commit a191858

File tree

1 file changed

+14
-3
lines changed

1 file changed

+14
-3
lines changed

defender-xdr/advanced-hunting-defender-use-custom-rules.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -108,17 +108,28 @@ For editable queries, more options are available:
108108

109109
## Create custom analytics and detection rules
110110

111-
To help discover threats and anomalous behaviors in your environment, you can create customized detection rules.
111+
To help discover threats and anomalous behaviors in your environment, you can create customized detection rules. There are two kinds:
112+
- Analytics rules - to generate detections from rules that query data that is ingested through Microsoft Sentinel
113+
- Custom detection rules - to generate detections from rules that query data from Defender XDR or from both Microsoft Sentinel and Defender XDR
114+
115+
116+
##### Analytics rules
112117

113118
For analytics rules that apply to data ingested through the connected Microsoft Sentinel workspace, select **Manage rules > Create analytics rule**.
114119

115120
:::image type="content" source="/defender/media/advanced-hunting-unified-rules.png" alt-text="Screenshot of the options to create custom analytics or detections in the Microsoft Defender portal" lightbox="/defender/media/advanced-hunting-unified-rules.png":::
116121

117122
The **Analytics rule wizard** appears. Fill up the required details as described in [Analytics rule wizard—General tab](/azure/sentinel/detect-threats-custom#analytics-rule-wizardgeneral-tab).
118123

119-
You can also create custom detection rules that query data from both Microsoft Sentinel and Defender XDR tables. Select **Manage rules > Create custom detection**. Read [Create and manage custom detection rules](custom-detection-rules.md) for more information.
120124

121-
In custom detection rule creation, you can only query data ingested as analytics logs (that is, not as basic logs or auxiliary logs, see [log management plans](/azure/sentinel/log-plans#log-management-plans) to check the different tiers) otherwise the rule creation won't proceed.
125+
##### Custom detection rules
126+
You can create custom detection rules that query data from both Microsoft Sentinel and Defender XDR tables. Select **Manage rules > Create custom detection**. Read [Create and manage custom detection rules](custom-detection-rules.md) for more information.
127+
128+
129+
In both custom detection and analytics rule creation, you can only query data ingested as analytics logs (that is, not as basic logs or auxiliary logs. See [log management plans](/azure/sentinel/log-plans#log-management-plans) to check the different tiers) otherwise the rule creation won't proceed.
122130

123131
If your Defender XDR data is ingested into Microsoft Sentinel, you have the option to choose between **Create custom detection** and **Create analytics rule**.
124132

133+
134+
> [!NOTE]
135+
> If a Defender XDR table is not set up to stream to log analytics in Microsoft Sentinel but is recognized as a standard table in Microsoft Sentinel, an analytics rule can be created successfully but the rule won't run correctly since no data is actually available in Microsoft Sentinel. For these cases, use the custom detection rule wizard instead.

0 commit comments

Comments
 (0)