Chart types and configuration options for each chart type.

Charts allow you to view and examine your metrics. You can interact directly with charts–zoom in, zoom out, change the time window, and so on. You don’t receive a static image of your data but you can work with your charts in real time, asking questions and receiving answers.
click here for the v2 doc

Wavefront supports a rich set of chart types and chart configuration options.

  • You add Wavefront Query Language queries to the chart to view and perform operations on metrics.
  • You configure chart options to show what’s important to you.

Common Options

Common Options are available for all chart types. They include Query, General, Axis, Unit, Style, Description, and Legend.


For each query displayed in a chart you can set the axis and color:

  • Axis - whether the axis displays on the left or right
  • Color - the color of the query points

To display the options, hover over the query line.

chart query

The image above shows the query line with Query Builder disabled. The options are the same with Query Builder enabled.


Options that support general customization.

Name Name of the chart. When you enter a chart name, it displays in the top right of the chart. There's no restriction on what you can enter as a chart name.
Point Tag Display Options The point tags to display in the chart legend or a Tabular View chart.
  • Show all - Show all point tags
  • Top - Show top N most frequent point tags
  • Custom - Show point tags of specific point tag keys
Summarize By Summarization method for grouping raw, reported data points, and mapping them to displayable values. When displaying metrics, Wavefront determines the chart resolution and establishes an appropriate time interval as the chart's bucket size. We then aggregate (combine) the raw data values that are reported within each such time interval, to produce a single value to display for each bucket. The chosen summarization method determines how the aggregation is performed, which is indicated in the chart's time bar.
  • Average - Display the average (mean) of the raw data values in each bucket.
  • Median - Display the median of the raw data values in each bucket.
  • Min - Display the minimum raw data value in each bucket.
  • Max - Display the maximum raw data value in each bucket.
  • Count - Display the number of raw data values in each bucket.
  • Sum - Display the sum of the raw data values in each bucket.
  • First - Display the first raw data value to be reported in each bucket.
  • Last - Display the last raw data value to be reported in each bucket.
Suppose the horizontal scale for your chart is "240 point buckets across, 1 bucket – 30 sec (est)". Choosing Median causes us to aggregate the raw data values reported in each 30 second interval, and display the median value as the bucket point.
Display Source Events Whether to display events generated by a firing alert associated with a source displayed on the chart. You can also use events() queries to Display events in charts.
Interpolate Points Whether to interpolate points that exist only in the past or future into the current time window.
Include Obsolete Metrics Whether to display metrics that have not reported data values in the last 4 weeks. Selecting this option is useful if you are looking at data from 4 or more weeks ago, however, performance is slower when this option is turned on.


Options that control the chart axis or axes.

Y-Axis The scale of the Y-axis: linear or logarithmic. Default is linear. In most cases, linear is sufficient as long as there is not a large difference in measurement between the reported data points. If there's a large difference in measurement scale, use the logarithmic scale. By default, the logarithmic scale is set to the power of 10. You can configure the scale in the adjacent text field.
Min/Max The minimum and maximum value on the Y-axis. If you are using a double Y-axis, you can specify min/max values for each Y-axis (By default, set to auto).
Unit The unit of measurement to assign to the reported chart values label that appears along the Y-axis of the chart. The supported units are:
  • Time - Ranges from yoctoseconds (ys) to years (yr)
  • IEC/Binary - data size in IEC/Binary units. Ranges from B (bytes) to YiB
  • SI - data rate in SI units. Ranges from bps (bits/s) to Ybps
For example, if the data for
is in milliseconds, you can either enter ms in the text field or click the Unit down-arrow and select Time > ms. The specified unit is merely a label and does not change the unit of measurement for the given expression. If you are using a double Y-axis, you can specify a unit for each Y-axis.

For information on unit prefixes and dynamic units, see Units in Chart Axes and Legends.


Options that control the style of the chart.

Gap Threshold Controls when data is considered missing when there are gaps in the reporting of the data. The gap threshold is expressed in seconds and defaults to 60 seconds. Data considered missing based on the threshold are shown as dotted lines.
Interpolation The function used to join points between each point bucket:
  • Linear - a straight line.
  • Step Before - a step value at the beginning of the bucket.
  • Step After - a step value at the end of the bucket.
  • Basis - a B-spline.
  • Cardinal - a Cardinal spline.
  • Monotone - a cubic interpolation that preserves monotonicity.


A description of the chart.


Controls the legend displayed for the chart.

Fixed Legend Whether to display a fixed legend.
Non-summarized Stats Whether to report summarized or raw values for all metric values and statistics. When this setting is disabled, the legend reports summarized values according to the Summarize By setting.
Disable Legend on Hover Whether to display the legend when hovering over the chart.
Position Position of the fixed legend on screen.
Display The values and statistics to display in the legend: current, mean, median, sum, min, max, and count.
Filter The value and number of metrics displayed in the legend. Specify:
  • Top or Bottom
  • Number of metrics
  • Value or statistic

Line Plot

line plot

A line plot chart represents interpolated point buckets. The X axis represents the amount of time in your time window and the Y axis represents the value associated with the data based on that time.

In a line chart, missing data is represented by a dashed line. The dashed line only gives a visual representation of the data stream; it does not represent values of the missing data. If you hover over the chart, you won’t see values where the gap threshold has been applied. Use the Gap Threshold property to set the amount of time before gaps of missing data display as dashed lines.

Point Plot

point plot

A point plot chart displays point buckets without any interpolation. Like a line chart, the X-axis represents the amount of time in your time window, and the Y-axis represents the value associated with the data during that time window.

Stacked Area

stacked area

A stacked area chart is based on the line chart and behaves similarly except that:

The magnitude of each line is filled in as a solid block with blocks stacked one on top of each other. With the default Stack Type of zero, the peak of the chart at any time is the sum of the magnitudes of all sources at that time.

The stacked area chart is a great way to visualize data when you want to determine at a glance which queries have the largest magnitude at any point in time. It is most commonly used to visually compare two or more quantities.

The Stack Type option controls the style of a Stacked Area chart.

Stack Type The following stack types are supported.
  • Zero - Displays the chart as from 0 up to the sum of all points at that time interval. Default.
  • Normalize to 0-1 - Results in a similar shape to Zero except that the values are normalized so that they fill the range between 0 and 1 with the peak of the chart always a solid line drawn at magnitude 1.
  • Minimize Weighted Change - Plots the area while attempting to minimize the weighted change in the slope of the lines. Both this and the Center the Stream option tend to result in similar shapes in which the chart does not show a solid area beginning at 0.
  • Center the Stream - Represents the collective magnitude of the queries displayed on the chart with the band narrowing or widening as the metrics fluctuate over time.
  • Stacked Columns - Shows the result as a set of stacked columns, which resemble a bar chart.

Here’s an example of Center the Stream:

center stream

Here’s an example of Stacked Columns, which resembles a bar chart: stacked columns

Scatter Plot

scatter plot

A scatter plot differs from all other Wavefront charts in that it compares time series expressions against one another. All other Wavefront charts compare time series against time.

The scatter plot is useful for examining whether two (or more) data sets are positively, negatively, or not correlated. Each point on a scatter plot represents a summary of points over a specified amount of time. In Wavefront terminology, these summarized points are called buckets. You can view the extent of the summarization applied in the bottom left of each chart.

When you create a Wavefront scatter plot, you use two queries. One specifies the expression that is mapped to the X axis, the other the expression that is mapped to the Y axis.

Series matching for the scatter plot ensures that reporting sources are actively reporting metrics for all specified time series expressions.

  • If a unique series (metric + source + point tags) is actively reporting for only one time series expression, it is not displayed.
  • If no sources are reporting for all time series expressions, then NO DATA displays on the chart.
  • If multiple X and Y-axes are defined, ensure that each time series expression associated to an axes has at least one common source reporting. Otherwise NO DATA is shown on the chart.

Only unique series that are reporting for every defined time series expression display.

The following option controls the style of a Scatter Plot chart.

Use Time-based Coloring Modify the color of the data points so that darker colors represent more recent data, and lighter colors represent older data.

Tabular View

tabular view

A tabular view chart displays data per stream in a table format. A tabular view displays only one data point value per source. The value is a summary of all of available data points, as set in the Summarized By field, based on the configured time window.

The following options control the style of a Tabular View chart.

Columns Configure options for table columns.
Show Sources/Labels Whether to display the sources and labels in the chart. A label is the metric name associated with the data or the query expression resulting from an aggregation.
Show Raw Values Whether to display the raw metric values or values using scientific notation (SI).
Group by Sources Whether to group the column results by source. If you select Group by Source, the table lists the grouped sources in the first column and the values for each metric in separate columns.
Sort Values Descending Whether to sort the value column by descending value.

Single Stat View

single stat

A single stat chart plots a single series on a chart and displays a summarized value for that series in large font on the chart. The font size and placement of the displayed value can be unique for each chart. A common use case is displaying instantaneous values of critical metrics on an overhead display.

In addition to general options, a Single Stat chart supports Sparkline options and Single Stat options:

Sparkline Options

A sparkline is a small graph that summarizes the series displays. You can customize the sparkline with these options:

Sparkline Position of the sparkline. The options are:
  • Bottom which means below the single stat.
  • Background which places the sparkline in the background of the single stat
  • None for no sparkline on the chart.
Line Color The color of the sparkline.
Value/Color Mapping The color of the single stat based on its value. You add and remove color thresholds using the plus and minus buttons. Click each field to specify the colors and threshold values.
Color Applies To Whether the Value/Color Mapping applies to the color of the single stat text or the chart background.
Fill Color The fill color for the chart area below the sparkline.

Value/Color Mapping Example:

In the following example the single stat is green if its value is less than 150, yellow when the value is between 150 and 200, and orange when the value is greater than 200:


Single Stat Options

A Single Stat chart supports the following options:

Display Value The position of the sparkline. The options are
  • Bottom which means below the single stat
  • Background which places the sparkline in the background of the single stat
  • None for no sparkline on the chart
Horizontal Position The horizontal pisition of the single stat. The options are Left, Middle, or Right of the chart.
Text Font Size The font size of the single stat.
Text Color The text color of the single stat.
Prefix A string to prefix the single stat.
Value/Text Mapping Strings to display instead of the metric value based on the value. You add and remove value thresholds using the plus and minus buttons. Click each field to specify the strings and threshold values.
Decimal Precision Number of digits to display after the decimal point in the summarized value.
Postfix A string to append to the single stat.

Value/Text Mapping Example

In the following example:


the string lower displays when the metrics value is below 150, middle displays when the value is between 150 and 200, and upper displays when the value is above 200.



A Markdown chart allows you to provide in-depth text descriptions of a dashboard and individual charts. In addition to Markdown formatted text, you can use links, images hosted outside Wavefront, and dashboard variables. You can refer to the value of a dashboard variable with the query variable syntax ${var_name} and the label of the variable using %{var_name}. Using a label instead of the variable value could be useful for list variables that might show the dropdown labels such as: Any, 1 Year, 3 Years which could map to opaque values such as -1, 1, 3.

A Markdown chart only has General options and Markdown options.