EQL pipe reference

edit

This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.

Elasticsearch supports the following EQL pipes.

head

edit

Returns up to a specified number of events or sequences, starting with the earliest matches. Works similarly to the Unix head command.

Example

The following EQL query returns up to three of the earliest powershell commands.

process where process.name == "powershell.exe"
| head 3

Syntax

head <max>

Parameters

<max>
(Required, integer) Maximum number of matching events or sequences to return.

tail

edit

Returns up to a specified number of events or sequences, starting with the most recent matches. Works similarly to the Unix tail command.

Example

The following EQL query returns up to five of the most recent svchost.exe processes.

process where process.name == "svchost.exe"
| tail 5

Syntax

tail <max>

Parameters

<max>
(Required, integer) Maximum number of matching events or sequences to return.