Learn how to create Wavefront Query Language expressions using Query Builder.
The Wavefront Query Builder is an easy-to-use interface that makes Wavefront accessible to all users in your organization. You can construct queries using query builder or query editor. Both query quilder and query editor support autocomplete.
  • Query builder allows you to construct queries from building blocks. Query Builder supports most elements of the Wavefront Query Language. A few of the more advanced functions are only available in the Query Editor, so you can switch from Query Builder to Query Editor to use those functions. You cannot switch from Query Editor to Query Builder.
  • Query Editor expect that you type the query using the elements of the query language.
click here for the chart builder doc

See Wavefront Query Language Reference for a complete reference - each function links to a reference page.

Constructing Queries

You use query builder to construct a query from its building blocks:

  • A metric, constant, or other query.
  • Zero or more filters (i.e. sources, source tags, and point tags). The metric determines which filters make sense.
  • Zero or more functions for manipulating the output.

Query builder

As you construct a query, it displays below the query builder. The chart associated with the query updates as you add filters and use functions to manipulate the output.

Query builder with chart

You can preview the result of each step in real time before you make the change:

  • For filters, click the bar chart icon at the end of each field (shown below).
  • For functions, hover over the function to get documentation and a preview of the changed chart.

Display query

Filters and Functions

Query Builder helps you construct your queries like this:

  • You can AND and OR multiple elements together. Unlike manually constructed ts() queries, which allow mixed ANDs and ORs, the Query Builder applies either AND or OR.
  • The order of evaluation is left to right – metrics, then filters, then functions.
  • Wildcard matching is supported for metrics, sources, and tags.
  • To remove any query element, click the X icon to the right of that element. The rest of your query remains intact.

filter and