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:
- Select Dashboards > Create Chart.
- 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.
Wavefront supports several methods for constructing query language queries:
- Query Builder
- Query Wizard
- Manual construction.
Using Query Builder to Construct a Query
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")).
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 can name each query field. Cloning 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
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.