This article has not been completed yet. However, it may already contain helpful Information and therefore it has been published at this stage.

KQL OPERATOR: TAKE

Description:

The take operator in Kusto Query Language (KQL) is used to extract a specific number of rows from a dataset.

For a security analyst working with Microsoft Defender for Endpoint (MDE), this operator is particularly useful for quickly previewing suspicious or relevant network events.

Use-Cases (leveraging the DeviceNetworkEvents Table):

#1 Basic usage:

This command displays the first 5 network events from the
DeviceNetworkEvents table. This gives the analyst a quick overview
overview of the latest network activities.

DeviceNetworkEvents 
| sort by Timestamp 
| take 5

#2 Search for specific action types:

This gives the analyst the first 5 network events for which the action was
was 'HttpConnectionInspected'. This can be useful to quickly analyse
the latest web activities.

DeviceNetworkEvents 
| sort by Timestamp
| where ActionType == 'HttpConnectionInspected'
| take 5

#3 Combined with IP filter:

With this query, the Analyst can display the first 5 network events that
occurred from or to a specific IP address (in this case 192.168.1.1).
have taken place.

DeviceNetworkEvents
| sort by Timestamp 
| where RemoteIP == '23.202.169.49' 
| take 5

WHEN TO USE IT:

  • to get a quick preview of the latest or most relevant network events.
  • in combination with filters to identify a limited number of relevant events.

THINGS TO KEEP IN MIND

  • The take operator returns the rows in the order in which they appear in the data set. If a specific order is required, you should use the sort operator first.
  • When using take in combination with other operators the order is important. The take operator should always be placed after the filter and sort operators.

References:

top operator - Kusto
Learn how to use the top operator to return the first specified number of records sorted by the specified column.
DeviceNetworkEvents table in the advanced hunting schema - Microsoft Defender XDR
Learn about network connection events you can query from the DeviceNetworkEvents table of the advanced hunting schema