A string in the format of a valid array followed by []. A valid array can either be an identifier, a valid array followed by . and an identifier, or a valid array followed by an array index surrounded by square brackets. For example, for events with fields incidents[0], incidents[1], ... this would be incidents[] .
Deduplicating fields of information where there are multiple
occurences of a value in a single field, maybe separated by a
single character can be achieved in a variety of ways. This
solution uses array:union() and
split create a unique array and then split
the content out to a unique list.
For example, when examining the humio and looking
for the browsers or user agents that have used your instance,
the UserAgent data will
contain the browser and toolkits used to support them, for
example:
Raw Events
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36
The actual names are the
Name/Version pairs showing
compatibility with different browser standards. Resolving this
into a simplified list requires splitting up the list,
simplifying (to remove duplicates), filtering, and then
summarizing the final list.
Step-by-Step
Starting with the source repository events.
logscale
splitString(field=userAgent,by=" ",as=agents)
First we split up the
userAgent field using
a call to splitString() and place the
output into the array field
agents
This will create individual array entries into the
agents array for each
event:
Using array:union() we aggregate the list
of user agents across all the events to create a list of
unique entries. This will eliminate duplicates where the value
of the user agent is the same value.
The event data now looks like this:
browsers[0]
browsers[1]
browsers[2]
Gecko/20100101
Safari/537.36
AppleWebKit/605.1.15
An array of the individual values.
logscale
|split(browsers)
Using the split() will split the array
into individual events, turning:
browsers[0]
browsers[1]
browsers[2]
Gecko/20100101
Safari/537.36
AppleWebKit/605.1.15
into:
_index
row[1]
0
Gecko/20100101
1
Safari/537.36
2
AppleWebKit/605.1.15
Event Result set.
Summary and Results
The resulting output from the query is a list of events with
each event containing a matching _index and
browser. This can be useful if you want to perform further
processing on a list of events rather than an array of values.
Filter an Array on a Given Condition
Filter the elements of a flat array on a given condition using the array filter function array:filter()
It is possible to filter an array on a given condition using the
array filter function array:filter(). The
array:filter() creates a new array with
elements matching the specified conditions and does not change the
original array. The new array will retain the original order.
Filters the mailto[]
array to include only elements that contain the value
ba*@example.com, this is
achieved by testing the value of each element of the array, set
by the var
parameter as addr, returning a new array that
only contains elements that meet the specified condition. The
expression in the
function
argument should contain the field declared in the
addr
parameter.
Event Result set.
Summary and Results
The query is used to filter values from the input array using
the function provided in the array and return a new array with
the results meeting the specified condition.