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 open AI Genie for forecasting or anomaly detection.
click here for the classic doc

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.
  • A chart that you open for edit wasn’t open in Query Editor before.

A few more advanced functions, such as chart variables, are 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 Metrics

You have these options:
  • Start typing the metric name in the search box.
  • Select Integrations, pick an integration, and then select a metric.
  • Select Browse and select from all metrics in your environment.
add a metric

Specify Filters

Optionally specify filters to narrow down what the chart displays.
  • Add filters using the + button.
  • Remove any 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 sum 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 resuls of selected queries in the chart.
  • Add and remove filters.
  • Add or remove functions, or change function order.

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 linke is still visible in chart builder. show/hide button

Add or Remove Filters

To add a filter, click the + next to the filter. To remove a filter, click the x on 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

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