Lucene Query Support
Circonus supports the use of Lucene Queries across dashboards and within the Logs Explorer.
Lucene Query Syntax
Using Lucene Query Syntax is recommended for advanced users who already have experience writing queries in Lucene. For all other users, it’s recommended that you use Dashboards Query Language.
The following are some tips that can help get you started with Lucene query syntax.
-
To perform a free text search, simply enter a text string. For example, if you’re searching web server logs for all users of the Safari browser, you could enter safari to search all fields for mentions of safari.
-
To search for a value in a specific field, prefix the value with the name of the field. For example, you could enter
status:200
to find all of the entries that contain the value200
in the status field. -
To search for a range of values, you can use the bracketed range syntax,
[START_VALUE TO END_VALUE]
. For example, to find entries that have 4xx status codes, you could enterstatus:[400 TO 499]
. -
To specify more complex search criteria, you can use the Boolean operators
AND
,OR
, andNOT
. For example, to find entries that have 4xx status codes and have an extension ofphp
orhtml
, you could enterstatus:[400 TO 499] AND (extension:php OR extension:html)
.