Chart Reference

Charts allow you to view and examine your metrics. You can interact directly with charts in real time--zoom in, zoom out, change the time window, and so on. Users with dashboard permission can customize many aspects of the chart and save their changes. This page is a detailed reference to the tabs in the different chart types. We repeat tab reference for each chart type.

Data Tab (All Charts)

For each chart (with the exception of a Markdown chart) you specify one or more queries.

When you select Data, you can:

• View queries for the chart and add lines.
• Use Chart Builder or Query Editor.
• Clone, delete, or hide one or more lines.
• Create an alert based on a chart.
• Bring up AI Genie for anomaly detection and forecasting.

Line Plot Chart

Line plots are well suited both for single time series and multiple time series. You can customize many aspects of your line plots.

A line plot 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.

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 Format > Gap Threshold property to set the amount of time before gaps of missing data display as dashed lines.

Format Tab

Option	Description
Summarization	Summarization method for grouping raw, reported data points, and for mapping them to displayable values. 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	If checked, displays events that were generated by alerts associated with any source displayed on the chart. You can also use events() queries to Display events in charts.
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.

Axis Tab

The Axis tab lets you customize the Y axis. The customization is the same for both Line Plot and Point Plot. See Use a Logarithmic Y Axis for Skewed Data and Use IEC/Binary Prefixes in Y Axes and Legends for instructions.

Option	Description
Y-Axis	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	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	Unit of measurement to assign to the label that appears along the Y-axis. This unit does not change the unit of measurement. If you are using a double Y-axis, you can specify a unit for each Y-axis. 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 details on SI units, see Wikipedia or a similar source. If you select IEC/Binary Unit Prefixes, then Wavefront uses 1024 instead of 1000 as the step to the next unit prefix. For details on unit prefixes and dynamic units, see Units in Chart Axes and Legends.

Legend Tab

Controls the legend displayed for the chart by default. The options are the same for line plot and point plot charts.

When you look at the chart, you can also control the legend with these keyboard shortcuts:

• Shift-P – Pin the legend.
• Shift – Show detailed units in the legend.

Option	Description
Options	You can select all or none of the Legend options. Fixed Legend -- Even if you don't select this option, you can use Shift-P with the mouse cursor in the chart to add 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 Summarization setting. Disable Legend on Hover -- Select to disable the legend on hover.
Position	Position of the fixed legend.
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
Point Tag Display Options	Offers these options: Show All Top X : Shows the top X (e.g. top 5) point tags. Custom: Allows you to specify selected point tags.

Drilldown Link Tab

Allows you to specify a target dashboard that displays when a user clicks on the chart. You can optionally pass in a dashboard variable or a constant. For example, you can specify a constant us-west-2 to be used as a variable in the target dashboard. See How Do Drilldown Links Work for details.

Description Tab

Chart description which shows up as hover text when users move the mouse over the chart name.

Advanced Tab

Option	Description
Include Obsolete Metrics	Select this check box 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.

Point Plot Chart

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.

Format Tab

Option	Description
Summarization	Summarization method for grouping raw, reported data points, and for mapping them to displayable values. 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	If checked, displays events that were generated by alerts associated with any source displayed on the chart. You can also use events() queries to Display events in charts.

Axis Tab

The Axis tab lets you customize the Y axis. The customization is the same for both Line Plot and Point Plot. See Use a Logarithmic Y Axis for Skewed Data and Use IEC/Binary Prefixes in Y Axes and Legends for instructions.

Option	Description
Y-Axis	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	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	Unit of measurement to assign to the label that appears along the Y-axis. This unit does not change the unit of measurement. If you are using a double Y-axis, you can specify a unit for each Y-axis. 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 details on SI units, see Wikipedia or a similar source. If you select IEC/Binary Unit Prefixes, then Wavefront uses 1024 instead of 1000 as the step to the next unit prefix. For details on unit prefixes and dynamic units, see Units in Chart Axes and Legends.

Legend Tab

Controls the legend displayed for the chart by default. The options are the same for line plot and point plot charts.

When you look at the chart, you can also control the legend with these keyboard shortcuts:

• Shift-P – Pin the legend.
• Shift – Show detailed units in the legend.

Option	Description
Options	Supports these options: Fixed Legend -- Displays a fixed legend. Even if you don't select this option, you can use Shift-P with the mouse cursor in the chart to add 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 Summarization setting. Disable Legend on Hover -- Select to disable the legend on hover.
Position	Position of the fixed legend.
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
Point Tag Display Options	Offers these options: Show All Top X : Shows the top X (e.g. top 5) point tags. Custom: Allows you to specify selected point tags.

Drilldown Link Tab

Allows you to specify a target dashboard that displays when a user clicks on the chart. You can optionally pass in a dashboard variable or a constant. For example, you can specify a constant us-west-2 to be used as a variable in the target dashboard. See How Do Drilldown Links Work for details.

Description Tab

Chart description which shows up as hover text when users move the mouse over the chart name.

Advanced Tab

Option	Description
Include Obsolete Metrics	Select this check box 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.

Stacked Area Chart

A stacked area chart is similar to a line chart, but each line is filled in as a solid block with blocks stacked on top of each other.

The stacked area chart can help you 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.

Format Tab

Option	Description
Summarization	Summarization method for grouping raw, reported data points, and for mapping them to displayable values. 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	If checked, displays events that were generated by alerts associated with any source displayed on the chart. You can also use events() queries to Display events in charts.
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.
Stack Type	The following stack types are supported. Zero - Displays the chart 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.

Axis Tab

The Axis tab lets you customize the Y axis. The customization is the same for both Line Plot and Point Plot. See Use a Logarithmic Y Axis for Skewed Data and Use IEC/Binary Prefixes in Y Axes and Legends for instructions.

Option	Description
Y-Axis	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	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	Unit of measurement to assign to the label that appears along the Y-axis. This unit does not change the unit of measurement. If you are using a double Y-axis, you can specify a unit for each Y-axis. 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 details on SI units, see Wikipedia or a similar source. If you select IEC/Binary Unit Prefixes, then Wavefront uses 1024 instead of 1000 as the step to the next unit prefix. For details on unit prefixes and dynamic units, see Units in Chart Axes and Legends.

Legend Tab

Controls the legend displayed for the chart by default. The options are the same for line plot and point plot charts.

When you look at the chart, you can also control the legend with these keyboard shortcuts:

• Shift-P – Pin the legend.
• Shift – Show detailed units in the legend.

Option	Description
Options	Supports these options: Fixed Legend -- Displays a fixed legend. Even if you don't select this option, you can use Shift-P with the mouse cursor in the chart to add 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 Summarization setting. Disable Legend on Hover -- Select to disable the legend on hover.
Position	Position of the fixed legend.
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
Point Tag Display Options	Offers these options: Show All Top X : Shows the top X (e.g. top 5) point tags. Custom: Allows you to specify selected point tags.

Drilldown Link Tab

Allows you to specify a target dashboard that displays when a user clicks on the chart. You can optionally pass in a dashboard variable or a constant. For example, you can specify a constant us-west-2 to be used as a variable in the target dashboard. See How Do Drilldown Links Work for details.

Description Tab

Chart description which shows up as hover text when users move the mouse over the chart name.

Advanced Tab

Option	Description
Include Obsolete Metrics	Select this check box 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.

Stacked Column Chart

A stacked column chart resembles a bar chart and lets you view your data in columns.

This chart supports the same tabs and options as the Stacked Area Chart discussed above but does not allow you to specify a Stack Type in the Format tab.

Format Tab

Option	Description
Summarization	Summarization method for grouping raw, reported data points, and for mapping them to displayable values. 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	If checked, displays events that were generated by alerts associated with any source displayed on the chart. You can also use events() queries to Display events in charts.
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.

Axis Tab

The Axis tab lets you customize the Y axis. The customization is the same for both Line Plot and Point Plot. See Use a Logarithmic Y Axis for Skewed Data and Use IEC/Binary Prefixes in Y Axes and Legends for instructions.

Option	Description
Y-Axis	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	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	Unit of measurement to assign to the label that appears along the Y-axis. This unit does not change the unit of measurement. If you are using a double Y-axis, you can specify a unit for each Y-axis. 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 details on SI units, see Wikipedia or a similar source. If you select IEC/Binary Unit Prefixes, then Wavefront uses 1024 instead of 1000 as the step to the next unit prefix. For details on unit prefixes and dynamic units, see Units in Chart Axes and Legends.

Legend Tab

Controls the legend displayed for the chart by default. The options are the same for line plot and point plot charts.

When you look at the chart, you can also control the legend with these keyboard shortcuts:

• Shift-P – Pin the legend.
• Shift – Show detailed units in the legend.

Option	Description
Options	Supports these options: Fixed Legend -- Displays a fixed legend. Even if you don't select this option, you can use Shift-P with the mouse cursor in the chart to add 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 Summarization setting. Disable Legend on Hover -- Select to disable the legend on hover.
Position	Position of the fixed legend.
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 and then select the number (e.g. 5 to show the top 5 time series) and, optionally, an evaluation filter.
Point Tag Display Options	Offers these options: Show All Top X : Shows the top X (e.g. top 5) point tags. Custom: Allows you to specify selected point tags.

Drilldown Link Tab

Allows you to specify a target dashboard that displays when a user clicks on the chart. You can optionally pass in a dashboard variable or a constant. For example, you can specify a constant us-west-2 to be used as a variable in the target dashboard. See How Do Drilldown Links Work for details.

Description Tab

Chart description which shows up as hover text when users move the mouse over the chart name.

Advanced Tab

Option	Description
Include Obsolete Metrics	Select this check box 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.

Table Chart

A table chart allows fine-grained customization in the Format tab but doesn’t support changes to the legend.

Format Tab

Option	Description
Summarization	Each line in a table is a summary of all of available data points, as set in the Summarized By field, based on the configured time window.
Point Tag Columns to Display	Allows you to show all point tags, only a selected number, or only metrics with a certain tag key.
Show Sources	Select to display the sources in the table.
Show Labels	Select to display labels in the table. A label is the metric name associated with the data or the query expression resulting from an aggregation.
Show Raw Values	Check to display the raw metric values (e.g. 212.00 milliseconds) or values using scientific notation (SI), e.g. 212 milliseconds.
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	Check to sort values descending (largest to smallest) or ascending (smallest to largest).

Axis Tab

The Axis tab of a table chart allows you to limit which values show up in the chart. Consider this example table, which users have to scroll:

You can specify a minimum of 200 milliseconds to show only values of interest:

Option	Description
Min/Max	The minimum and maximum value.
Unit	The unit of measurement to assign to the reported chart values label that appears along the Y-axis of the chart. This unit is merely a label and does not change the unit of measurement. 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 details on SI units, see Wikipedia or a similar source. If you select IEC/Binary Unit Prefixes, then Wavefront uses 1024 instead of 1000 as the step to the next unit prefix. For details on unit prefixes and dynamic units, see Units in Chart Axes and Legends.

Drilldown Link Tab

Allows you to specify a target dashboard that displays when a user clicks on the chart. You can optionally pass in a dashboard variable or a constant. For example, you can specify a constant us-west-2 to be used as a variable in the target dashboard. See How Do Drilldown Links Work for details.

Description Tab

Chart description which shows up as hover text when users move the mouse over the chart name.

Advanced Tab

Option	Description
Include Obsolete Metrics	Select this check box 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.

Markdown Chart

A Markdown chart allows you to provide in-depth text descriptions of a dashboard and individual charts using Markdown. We support CommonMark

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.

Single Stat Chart

By default, 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.

Format Tab

Option	Description
Summarization	Summarization method for grouping raw, reported data points, and for mapping them to displayable values. 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 Value	Allows you to show the value or the query label. Initially, labels are consecutive starting at A.
Display Subtitle	Optional subtitle below the value (or label).
Decimal Precision	How many values to show after the decimal point. Defaults to 3.
Horizontal Position	Allows you to set the alignment to Left, Middle, or Right
Font Size	Relative font size from 75% to 200%.
Text Color	Color of the value or label text displayed in the chart.
Prefix	Allows you to prefix the value (or label) with a text string. For example, you could show the source or environment.
Postfix	Allows you to append text to the value (or label). For example, you could show the source or environment.
Value/Text Mapping	Allows you show the text lower, middle, or upper instead of the value itself.
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.
Display Raw Value	Check this checkbox if you've selected a unit and you want to display, for example, `10k` instead of `10000`. Checked by default.

Sparkline Tab

The sparkline on a single stat chart summarizes the series display. You can customize the sparkline with these options:

Option	Description
Show Sparkline	Whether and where to show the sparkline. Options are: Bottom shows the sparkline below the single stat. Background shows the sparkline in the background of the single stat None doesn't show a sparkline on the chart but shows the value or label.
Sparkline Color	Color of the sparkline. Click the X to return the color to the default (blue).
Fill Color	Fill color for the sparkline background or text.
Color to Value Mapping	Allows you to specify a set of values and map them to colors. For example, this mapping shows yellow for values under 10, green for values between 10 and 20, etc. Click any color to customize it.
Axis	Allows you to select a linear or logarithmic axis for the sparkline. See Use a Logarithmic Y Axis for Skewed Data.
Min/Max	Minimum and maximum value on the Y-axis of the sparkline.

Description Tab

Chart description which shows up as hover text when users move the mouse over the chart name.

Drilldown Link Tab

The Drilldown Link tab allows you to specify a target dashboard that displays when a user clicks on the single stat chart. You can optionally customize the target dashboard. For example, you can specify a constant us-west-2 to be used as a variable.

Topk Chart

A topk chart shows the most critical time series (8 by default) as horizontal bars. You can

• Add a color mapping to highlight values
• Specify the number of bars and other details such as the bar label, bar header, etc.
• Specify a drilldown link that directs users to a different dashboard when they click on a bar.

Color Mapping Tab

The color mapping tab lets you define which set of values maps to which colors. In the example above, values under 0.5 are mapped to orange, values 0.5 - 1.0 are mapped to blue. See How Do I Set Up Color Mapping for details.

Format Tab

Option	Description
Summarization	Summarization method for grouping raw, reported data points, and for mapping them to displayable values. 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.
Number of Bars	Sets the number of bars for this topk chart. Default is 8.
Group By	Groups the bars. Source is included by default and cannot be removed.
Bar Label	Label shown on the very left of each bar. Default is source. In the example above, sources include app-3, db-1, etc.
Bar Header	Header for all bars, show in the top left. In the example above, source.
Value Header	Header for the value column, shown in the top right. In the example above, value.
Decimal Precision	Decimal precision of the value. Default is 3.
Min and Max	Allows you to specify the minimum and maximum and the units.
Sort Values Descending	If checked, the highest values are at the top. If unchecked, the lowest values are at the top.

Description Tab

Chart description which shows up as hover text when users move the mouse over the chart name.

Drilldown Link Tab

Allows you to direct end users to a target dashboard if they click this chart. See How Do Drilldown Links Work for details.

Node Map Chart

A node map chart shows colored 3-D cubes ordered from highest to lowest. Node maps show data based on source values.

• By default, the node map uses displays the highest value on the top left to catch the user’s eye.
• When a user clicks a node, a small popup of the corresponding metric for that source results.
• Use color mapping to determine colors for higher values. The node map uses shading to show transitions. In the example above, values below 0.3 are shown as green, values lower than 0.8 are shown as a shade of yellow.
• Users can group and can set the metric to display in the top right.
• Specify a drilldown link to direct users to a different dashboard if they click on the dashboard.

When you refresh a node map page, a short animation folds out the chart content.

Color Mapping Tab

The color mapping tab lets you define which set of values maps to which colors. In the example above, values less than 0.3 are green, values less than 0.8 are yellow. All other values are red. See How Do I Set Up Color Mapping for details.

Node Map Defaults Tab

Option	Description
Default Group by	Specifies grouping.
Default Metric	Metric you're interested in. Each cube in the node map displays one node and you can, for example, create a set of queries to monitor for CPU, memory, and bandwidth issues.
Node Title Tag	Lets you set the title of the popup line chart to the source (default) or one of the point tags.
Default Node Color	Lets you pick the color of nodes with values that are below any of the thresholds.

Description Tab

Chart description which shows up as hover text when users move the mouse over the chart name.

Drilldown Link Tab

If you [specify a drilldown link], end users are directed to a target dashboard when they click this chart. You can optionally pass a point tag, variable, or other value into the target dashboard to customize it for the user ahead of time. See How Do Drilldown Links Work for details.

Histogram Chart

Histogram charts have two main uses:

• Visualize Wavefront Histograms. Wavefront histograms let you compute, store, and use distributions of metrics rather than single metrics. Histograms are useful for high-velocity metrics about your applications and infrastructure – particularly those gathered across many distributed sources.
• Display a histogram visualization of a time series. That makes it possible, for example, to easily see query results above a certain percentile.

The histogram chart shows the aggregate view of the entire window. For both histogram data and time series data, you can visualize the amount of data in a certain percentile, specify color gradient and axis information, and, most importantly, get details about your histogram data by looking at hover text on each bar.

From the chart’s edit menu, you can go to the corresponding trace (if any).

Data Tab

In contrast to other chart types, you must use the query editor to enter histogram information.

One easy way to show a histogram is from the Histogram browser.

1. Select Browse > Histograms
2. Drill down to the metric you’re interested in and double-click it to open it in a chart.

You must make sure you’re looking at a metric – it doesn’t make sense to select a folder.

Format Tab

Option	Description
Color Gradient	Lets you select a start and end color for the histogram gradient.
Percentile Markers	Display predefined percentile makers as numbers on the chart. You can also
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.

Axis Tab

The Axis tab lets you change the Y axis, and both the X axis dimensions and units.

Option	Description
Y-Axis	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	Y axis minimum and maximum value. Use these two options to change the height of your histogram bars.
X-Axis Min / X-Axis Max	Allows you to specify the minimum and maximum on the X axis, in effect, filtering out some of the left-most and right-most bars that the chart displays.
Unit	Unit of measurement to assign to the label that appears along the X-axis. This unit does not change the unit of measurement. This unit also does not affect the Y axis. 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 details on SI units, see Wikipedia or a similar source. If you select IEC/Binary Unit Prefixes, then Wavefront uses 1024 instead of 1000 as the step to the next unit prefix. For details on unit prefixes and dynamic units, see Units in Chart Axes and Legends.

Advanced Tab

Option	Description
Include Obsolete Metrics	Select this check box 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.

Heat Map Chart

Heat map charts add another dimension to the information about histograms that you see in a histogram chart.

• The X axis shows time (same as a line plot)
• The Y axis shows distribution values (just like the X axis in histogram charts). This is what you’re recording, for example, latency.
• The color saturation shows the amount of data for the selected time frame.

Data Tab

In most cases, it makes sense to do an hs() query in the Query Editor.

One easy way to show which histograms are on your cluster is from the Histogram browser.

1. Select Browse > Histograms
2. Drill down to the metric you’re interested in and double-click it to open it in a chart. You must make sure you’re looking at a metric – it doesn’t make sense to select a folder.

Format Tab

Option	Description
Display Source Events	When checked, shows events associated with any source related to the data in the X axis.
Color	Base color for the heat map. The saturation of the color indicates the count for the selected field. Hover over any field to see a vertical histogram as a legend that you can pin with Shift-P. The histogram highlights the vertical line that corresponds to the grid cell you've selected.

Axis Tab

The Axis tab lets you change the Y axis, and both the X axis and Y axis dimensions and units.

Option	Description
Y-Axis Min/Max	Y axis minimum and maximum value.
Y Axis Unit	Unit of measurement to assign to the label that appears along the Y-axis. For example, select Dynamic Units and then change to microseconds. This option does not change the unit of measurement. 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 details on SI units, see Wikipedia or a similar source. If you select IEC/Binary Unit Prefixes, then Wavefront uses 1024 instead of 1000 as the step to the next unit prefix. For details on unit prefixes and dynamic units, see Units in Chart Axes and Legends.
Y-Axis Bucket Count/X Axis Bucket Count	The size of each bucket. For the X axis, the bucket count is also shown right below the chart itself.

Advanced Tab

Option	Description
Include Obsolete Metrics	Select this check box 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.

Gauge Chart

A gauge chart displays a single value, in a default color. You can optionally add color mapping. If you do, the which displays in an outer ring. By default, color mapping uses 0-100, but you can define a minimum and maximum.

Format Tab

Option	Description
Summarization	Summarization method for grouping raw, reported data points, and for mapping them to displayable values. 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.
Decimal Precision	How many digits to show after the decimal point. Defaults to 3.
Prefix	Allows you to prefix the value (or label) with a text string. For example, you could show the source or environment. The font of the prefix is smaller than the display font.
Postfix	Allows you to append text to the value (or label). For example, you could add the unit of measurement.
Default Color	Color that's used for the value and the gauge ring when no color mapping is defined. Default is blue. See the chart on the left in the image above.
Color Mapping	Adds an outer ring and splits that outer ring into color zones that show possible values of the gauge. See the chart on the right in the image above. By default, the gauge displays color information for 0-100 even if you define a mapping for a different range. Specify Min and Max to change what the outer ring shows. See Why Doesn't the Outer Ring of My Gauge Change?
Min	Minimum value to use for the outer ring of the gauge. If no color mapping is defined, the gauge ranges from Min to Max. With color mapping defined, the outer ring is also affected.
Max	Maximum value to use for the outer ring of the gauge. If no color mapping is defined, the gauge ranges from Min to Max. With color mapping defined, the outer ring is also affected.
Display Raw Value	Check this checkbox if you've selected a unit and you want to display, for example, `10k` instead of `10000`

Drilldown Link Tab

The Drilldown Link tab allows you to specify a target dashboard that displays when a user clicks on the gauge chart. You can optionally customize the target dashboard. For example, you can specify a constant us-west-2 to be used as a variable.

Description Tab

Chart description which shows up as hover text when users move the mouse over the chart name.

Advanced Tab

Option	Description
Include Obsolete Metrics	Select this check box 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.

Pie and Donut Chart

A pie chart shows the relative size of your data as pie slices. You can show either a pie chart or a donut chart. You can customize the width of the donut ring (by percentage) and, the percentile shown for the number, and more.

The collage above shows both a pie chart and a donut chart for the same data.

Format Tab

Option	Description
Type	Select a pie chart or donut chart. If you pick a donut chart, you can set a ratio to make the ring thicker or thinner.
Summarization	Summarization method for grouping raw, reported data points, and for mapping them to displayable values. 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.
Show Percentage	Let's you show percentage labels for your chart.
Decimal Precision	How many digits to show after the decimal point for the percentage and for the value.
Group Slices	Allows you to specify the maximum number of slices for the chart. If there are more slices than the maximum, the values of all other slices are combined and have the label "Other" by default. You can change that label.
Min	Allows you to filter the chart by value. Only values greater than or equal to Min are shown.
Max	Allows you to filter the chart by value. Only values smaller than or equal to Max are shown.

Legend Tab

Controls the legend displayed for the chart.

When you look at the chart, you can also control the legend with these keyboard shortcuts:

• Shift-P – Pin the legend.
• Shift – Show detailed units in the legend.

Option	Description
Options	You can select all or none of the Legend options. Fixed Legend -- Even if you don't select this option, you can use Shift-P with the mouse cursor in the chart to add 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 Summarization setting. Disable Legend on Hover -- Select to disable the legend on hover.
Position	Position of the fixed legend.
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
Point Tag Display Options	Offers these options: Show All Top X : Shows the top X (e.g. top 5) point tags. Custom: Allows you to specify selected point tags.

Drilldown Link Tab

The Drilldown Link tab allows you to specify a target dashboard that displays when a user clicks on the chart. You can optionally customize the target dashboard. For example, you can specify a constant us-west-2 to be used as a variable.

Description Tab

Chart description which shows up as hover text when users move the mouse over the chart name.

Advanced Tab

Option	Description
Include Obsolete Metrics	Select this check box 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.