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 create charts from several places in the application. This topic explains how to create a chart using Dashboards > Create Chart.

Creating a Chart

To create a chart:

  1. Select Dashboards > Create Chart.
  2. Add one or more Wavefront Query Language queries in the Queries section of the chart.

Every chart starts out with one query field named New Query.

Watch this video for details:

Constructing Queries

Wavefront supports several methods for constructing query language queries:

  • Query Builder
  • Query Editor
  • Query Wizard

Query Builder

Wavefront Query Builder is a great option for users new to Wavefront because you don’t have to know 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")).


Query Editor

Instead of using Query Builder, you can click the Query Builder toggle and explicitly enter a Wavefront Query Language, expression into the query field. For example:

ts("requests.latency", tag="az-3" and not source="app-28")

Managing a Chart’s Queries

You can use the icon’s in the Query section to change which queries are associated with a chart.

  • Click the add icon (+) to the right of the query field to add a new query field and an additional query with a chart.
  • Click the clone icon to clone an existing query into a new query field. Cloning is recommended when you are using a legend for a chart with several query fields.
  • Click the remove icon (-) to remove a query field.
  • To rename a query field, click the current name to the left of the query field (New Query is the initial default) and enter a name. The query field name can be up to 50 characters and there’s no restriction on characters you can use.


As you construct your new query, can use functions such as sum(), highpass(), mavg(), etc. See Wavefront Query Language Quick Reference for a complete list of functions.

Configuring the Chart

You can customize your charts to suit your needs precisely. 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. 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.

  • To the chart to an existing dashboard, enter a dashboard name and click the Insert button.
  • To save the chart to a new dashboard, click the New Dashboard button.


When the chart is in a dashboard, you can open the chart by clicking the chart name in the upper right of the chart.