Use Chart Builder to display the data you're interested in.
Chart Builder has the tools for creating charts and customizing which metrics you see.
  • Construct queries from building blocks
  • Show or hide individual queries
  • Clone or delete a line
  • Create alerts or turn **Anomaly Detection** on for forecasting or anomaly detection on Line Plot charts.
click here for the classic doc


Here’s a 90 second overview of some of the main features.

Get Started

When you create a new chart or edit an existing chart, we open Chart Builder:

  • Select Dashboards > Create Chart to create a new chart.
  • Click the chart name of a chart you want to edit.

query builder tasks

We open Chart Builder only if:

  • Chart Builder is the default in your user preferences.
  • The chart that you open for edit wasn’t open in Query Editor before.

Advanced functionality, such as chart variables, is available only in the Query Editor. Query Editor expects that you type the query using the elements of the query language.

  • Switch from Chart Builder to Query Editor to use those advanced functions.
  • You cannot switch from Query Editor to Chart Builder.

Select Metrics and Refine Your Chart

You always start by selecting a metric, and can then refine what’s visible in the chart with filters and functions.

Select Data

You have these options:
  • Start typing a name in the search box.
  • Select a metric type, that is, Metrics, Delta Counters, or Histograms and select from the menu.
  • Select Integrations, pick an integration, and then select a metric.
add a metric

Specify Filters

Optionally, specify filters to narrow down what the chart displays.
  • Add filters using the + icon.
  • Remove a filter using the X inside the filter bubble.
This example filters a metric that supports specifying the value of two point tags (az and env), the source, and a source tag. See Organizing with Tags.
add a filter

Add Functions

Functions allow you to perform aggregation, scaling, or rounding, use moving time windows, and more.
  • When you select a function, help text explains how it works and a link sends you to more info.
  • For many functions, e.g., sum() and rawsum(), we support a raw version that does not perform interpolation.
This example filters a metric that supports specifying the value of two point tags (az and env), the source, and a source tag. See Organizing with Tags.
add a filter

Group Results of a Function

For certain functions, the Group By field allows you to organize your chart. For example, you can show results for each of two env tags separately.
In the example on the right, we're in the process of selecting the count function.
use group by

Example: Metric, Summed Metric, Grouped Sum

The following picture shows first the original metric, then the sum, and then the sum grouped by the env point tag.

query builder results

Combine Chart Builder Elements

Chart Builder lets you:

  • Replace metrics.
  • Add query lines.
  • Hide or show the results of selected queries in the chart.
  • Add and remove filters.
  • Add or remove functions, or change the order of the functions.

Add Query Lines

To add a query line, click Add below the last line. add a query line
To hide or show the results of a query, click the Hide/Show button. The chart no longer shows the result of that query though the query line is still visible in Chart Builder. show/hide button

Add or Remove Filters

To add a filter, click the + icon next to the filter. To remove a filter, click X in the filter bubble. show/hide button

Add, Remove, or Reorder Functions

You can add, remove, or reorder functions. Reordering might become necessary because, for example, first applying sum() and then deriv() yields a different result than first applying deriv() and then applying sum().

To add a function, click the + next to the function. To remove a function, click the x on the function bubble. add a chart line
To reorder functions, hover the cursor over the drag icon until the mouse changes shape, and then drag the function to the place you want it. reorder functions

More Info

Advanced users can use Query Editor to take advantage of the complete set of query language functions.

See Wavefront Query Language Quick Reference for a complete reference. Each function links to a reference page.