Skip to content

Commit 74923ec

Browse files
authored
[DOCS] EQL: Add lookup support to : operator (#65262) (#65435)
1 parent 65293df commit 74923ec

File tree

1 file changed

+18
-4
lines changed

1 file changed

+18
-4
lines changed

docs/reference/eql/syntax.asciidoc

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,8 @@ are not supported.
133133
`:` (equal, case-insensitive)::
134134
Returns `true` if strings to the left and right of the operator are equal.
135135
Otherwise returns `false`. Matching is case-insensitive and can only be used to
136-
compare strings. <<eql-syntax-wildcards,Wildcards>> are supported.
136+
compare strings. Supports <<eql-syntax-wildcards,wildcards>> and
137+
<<eql-syntax-lookup-operators,list lookups>>.
137138

138139
[IMPORTANT]
139140
====
@@ -222,6 +223,7 @@ Returns `true` if the condition to the right is `false`.
222223
----
223224
user.name in ("Administrator", "SYSTEM", "NETWORK SERVICE")
224225
user.name not in ("Administrator", "SYSTEM", "NETWORK SERVICE")
226+
user.name : ("administrator", "system", "network service")
225227
----
226228

227229
`in` (case-sensitive)::
@@ -232,6 +234,10 @@ matching is case-sensitive.
232234
Returns `true` if the value is not contained in the provided list. For strings,
233235
matching is case-sensitive.
234236

237+
`:` (case-insensitive)::
238+
Returns `true` if the value is contained in the provided list. Can only be used
239+
to compare strings.
240+
235241
[discrete]
236242
[[eql-syntax-math-operators]]
237243
===== Math operators
@@ -381,9 +387,17 @@ match specific patterns:
381387

382388
[source,eql]
383389
----
384-
field : "example*wildcard"
385-
field : "*example-wildcard"
386-
field : "example-wildcard*"
390+
field : "f*o"
391+
field : "*foo"
392+
field : "foo*"
393+
----
394+
395+
The `:` operator also supports wildcards in <<eql-syntax-lookup-operators,list
396+
lookups>>:
397+
398+
[source,eql]
399+
----
400+
field : ("f*o", "*bar", "baz*", "qux")
387401
----
388402

389403
[discrete]

0 commit comments

Comments
 (0)