Search Syntax
LogZilla documentation for Search Syntax
LogZilla provides standard boolean-type search syntax much like users would
expect when using Google. The only difference is the ability to append a
wildcard (*
).
- All searches are case insensitive
- All searches must contain at least 4 characters at a minimum unless otherwise configured by the administrator.
- Wildcard characters (
*
) count toward the minimum character requirement.
Correct Search Syntax
Example 1:
texthello*
Example 2 (prefix/infix wildcard):
text*hel*
Incorrect Search Syntax
Too few characters:
texthel
The 4 character minimum is set in the Sphinx configuration which administrators can adjust. The minimum word length, prefix length, and infix length settings control search indexing behavior. Customers are welcome to contact LogZilla for guidance on modifying these settings.
Boolean Examples
Phrase Search
text"hello world"
Operator AND
The AND
is automatically implied when separating search words with a space
and should not be included in search criteria.
For example, searching on the text hello world
would return results for both
hello
and world
.
Operator NOT
The !
or -
operators may be used to find events NOT
containing the
specified text. For example:
texthello -world
Or
texthello !world
Operator OR
A |
(pipe) operator may be used to find events matching either of the
given terms. For example:
texthello | world
Would return all events matching "hello" or "world".
texthello | other | world
Would return all events matching "hello" or "other" or "world".
Boolean Mode Wildcard
Many Network and Systems logs will include names such as
GigabitEthernet1/0/0
, etc. The wildcard feature allows users to specify a
search term when they may not know the trailing characters.
For example:
textgigabitethernet1*
Would return results for GigabitEthernet1/0/0
, GigabitEthernet1/0/2
, or
even GigabitEthernet100
.
A prefix/infix wildcard may also be used:
text*bitethernet1/*/2
Would return results for GigabitEthernet1/0/0
, GigabitEthernet1/1/2
but not
GigabitEthernet100
.
Grouping
Note that expression grouping can be used. This is surrounding a search expression with parentheses "(" ")" . This must be used in cases in a multi-term search expression is used with an OR operator "|", in order to clarify which terms are handled by the OR. For example, to indicate that you want to find messages that contain the expression "foo bar", OR messages that contain "baz" but not "boz", you would do the following:
text"foo bar" | (baz -boz)
Invalid Search Syntax
The following examples show some of the mixed-mode searches which are not supported at this time:
- Searches containing both
OR
andNOT
operator's combined:
texthello | -world
- Mixed "Phrase"
AND
orNOT
text"hello world" !world2
text"hello world" world
- Negative searching without a preceding positive search
text!hello
This would be analogous to searching Google for every word on the internet that does
NOT
contain the word hello. Which, of course, would not be very useful.