Learn how to create a Wavefront chart and save it to a dashboard.

One of the first tasks a new Wavefront user wants to perform is data visualization. Wavefront makes chart creation an easy process. You can access the chart creation feature from several parts of the application. This topic focuses on most straightforward method.

Creating a Chart

To create a chart, select Dashboards > Create Chart.

To display metrics you add Wavefront Query Language queries to query fields in the Queries section of the chart. Every chart starts out with one query field named New Query.

Constructing Queries

Wavefront provides two methods for constructing query language queries: Query Builder and manual construction.

Using Query Builder to Construct a Query

Wavefront Query Builder is a great starting option for users new to Wavefront because it doesn’t require any knowledge of the query language syntax. Query Builder constructs a query based on a set of components (metric name, source, source tag, and point tag filters, advanced functions) that you specify.

In the image below, we specified the metric name ~sample.requests.total.num, point tag az=us-west-1, and a 10-minute moving average function in order to create the following query and chart: mavg(10m, ts(~sample.requests.total.num, az="us-west-1")).


Manually Constructing a Query

If you are familiar with Wavefront Query Language, you can enter the complete expression into the query field. For example: if((ts("requests.latency", tag="az-3" and not source="app-28") as test) > 160, $test, 0).

Adding Queries to a Chart

To associate more than one query with a chart, add a new query field by clicking the add icon to the right of a query field.


The remove icon removes a query field, and the clone icon clones a query into a new query field.

You also have the option of naming each query field, which is recommended when you are using a legend for a chart with several query fields. To rename a query field, click the name to the left of the query field and enter a name. The query field name can be up to 50 characters and there’s no restriction on characters you can use.


You can experiment with functions such as sum(), highpass(), mavg(), etc. See Wavefront Query Language Quick Reference for a complete list of functions.

Configuring the Chart

You also have the option to configure charts in several different ways. The chart configuration options are in the Chart section:


The configuration tabs (General, Axis, Style, etc.) and options depend on the chart type you choose.

The chart name appears in the top right corner of the chart:


The Wavefront UI uses SI and IEC/Binary notations to represent metric values on charts. For further information, see Units in Chart Axes and Legends. In the chart below, the values you see (5M , 10M, 15M) etc are mega (M) values (ex: 5 M = 5 * 1000^2 = 5000000).


Saving a Chart to a Dashboard

To save a chart, scroll down to the Save To section. You can save the chart to an existing dashboard by entering a dashboard name and clicking the Insert button or you can save the chart to a new dashboard by clicking the New Dashboard button.


Once the chart is in a dashboard, you can open the chart by clicking the chart name on the right hand upper corner of the chart.