Query your metrics with query language functions and variables.

Query Editor allows advanced users to extract exactly the metrics they need from the data flowing into Wavefront. If an existing chart uses functions that are not supported in Chart Builder, or if the chart has been opened in Query Editor before, we show Query editor when you open the chart for edit.

Query Editor expects that you type the query using the elements of the query language. See Wavefront Query Language Quick Reference for a complete reference - each function links to a reference page.

Note: Most functions allow you to query time series metrics. Some functions also support histograms, traces, or events.

Open Query Editor

You can set your preferences to use Chart Builder or Query Editor when you open a chart for edit.

To switch from Chart Builder to Query Editor, click the toggle.

Query builder new

Warning: If you switch to Query Editor and make changes to the query there, you cannot return to Chart Builder.

Construct Queries

You construct queries using Wavefront Query language.

  1. Start with the metric you want to monitor.
  2. Add filters, e.g. source=production.
  3. Add one or more query language functions. Execution order makes a difference.
  4. Use grouping if you’re interested in grouping your metrics. For example, you could use the sources parameter one line for each source in the chart.

Use Chart Variables

Wavefront supports variables in dashboards and charts.

  • You can use dashboard variables in your queries.
  • Chart variables are local to the chart.

Chart variables make it possible to use the result of one query in another query in the same chart using {$query_name} notation.