Uredi

Refine your query in guided mode

Important

Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

This article explains how to refine your advanced hunting queries in guided mode in Microsoft Defender XDR. Learn how to use supported data types, subgroups, smart auto-complete, event type filters, sample sizes, and how to switch from guided mode to advanced (KQL) mode.

Use different data types

Advanced hunting in guided mode supports several data types that you can use to fine-tune your query.

  • Numbers
    Screenshot of the query builder with a numeric field added as a condition

  • Strings
    Screenshot of the query builder with a string field configured as a condition

    In the free text box, type the value and press Enter to add it. Note that the delimiter between values is Enter.

    Screenshot of the query builder showing multiple string values entered as filter conditions

  • Boolean
    Screenshot of the query builder with a Boolean field used as a condition

  • Datetime
    Screenshot of the query builder with a datetime field configured as a condition

  • Closed list - You don't need to remember the exact value you're looking for. You can easily choose from a suggested closed list that supports multi-selection.
    Screenshot of the query builder with a predefined list of values available for multi-selection as a condition

Use subgroups

You can create groups of conditions by clicking Add subgroup:

Screenshot highlighting Add subgroup button

Screenshot showing use of subgroups in query builder conditions

Smart auto-complete for searching devices and user accounts is supported. You don't need to remember the device ID, full device name, or user account name. You can start typing the first few characters of the device or user you're looking for and a suggested list appears from which you can choose what you need:

Screenshot showing smart auto-complete support

Use EventType

You can even look for specific event types like all failed logons, file modification events, or successful network connections by using the EventType filter in any section where the EventType filter is available.

For instance, if you want to add a condition that looks for registry value deletions, you can go to the Registry Events section and select EventType.

Screenshot of the Registry Events EventType list showing available registry event values

Selecting EventType under Registry Events allows you to choose from different registry events, including the one you're hunting for, RegistryValueDeleted.

Screenshot of the Registry Events filter with EventType set to RegistryValueDeleted

Note

EventType is the equivalent of ActionType in the data schema, which users of advanced mode might be more familiar with.

Test your query with a smaller sample size

If you're still working on your query and would like to see its performance and some sample results quickly, adjust the number of records to return by picking a smaller set through the Sample size dropdown menu.

Screenshot of the Sample size dropdown used to limit returned records while testing a query

The sample size is set to 10,000 results by default, which is the maximum number of records that can be returned in hunting. However, we highly recommend lowering the sample size to 10 or 100 to quickly test your query, as doing so consumes less resources while you're still working on improving the query.

Then, once you finalize your query and are ready to use it to get all the relevant results for your hunting activity, make sure that the sample size is set to 10k, the maximum.

Switch to advanced mode after building a query

You can click on Edit in KQL to view the KQL query generated by your selected conditions. Editing in KQL opens a new tab in advanced mode, with the corresponding KQL query:

Screenshot of guided mode showing the Edit in KQL control used to open the generated query in advanced mode

Screenshot of the generated KQL query in advanced mode for a guided query searching file name and SHA256 across all relevant tables

In the file-name and SHA256 query example shown in the previous screenshot, the selected view is All, so the KQL query searches all tables that have file properties of name and SHA256, and in all the relevant columns covering these properties.

If you change the view to Emails & collaboration, the KQL query generated for the file-name and SHA256 example is narrowed down to:

Screenshot of the generated KQL query in advanced mode narrowed to Emails & collaboration tables for the file-name and SHA256 example

Tip

Do you want to learn more? Engage with the Microsoft Security community in our Tech Community: Microsoft Defender XDR Tech Community.