Histogram Chart

Overview

The Histogram Chart shows the distribution of samples recorded within the specified timespan using percentiles, frequencies, and density.

[widget]
  type = histogram

  top-axis = percentiles
  right-axis = density

  [series]
    entity = nurswgvml007
    metric = cpu_busy

Widget Settings

  • The settings apply to the [widget] section.
  • Common [widget] settings are inherited.
Name Description
mode Add frequencies from multiple series.
Possible values: stack, none.
Example: mode = stack
bar-count Number of bars in which to group loaded samples.
Default value: 50.
Example: bar-count = 20

Axis Settings

Name Description
left-axis Value statistics displayed on the left axis.
Possible values:
frequency - The height of each bar is equal to the number of samples in the bar range.
density - The height of each bar is equal to the number of samples in the bar range divided by the total number of samples. The sum of all densities is 1.
none - No scaling applied.
Default value: frequency.
Example: left-axis = frequency
right-axis Value statistics displayed on the right axis. Same as left axis.
Default value: none.
Example: right-axis = density
top-axis Value statistics displayed on the top axis.
Possible values: none, percentiles, values.
Default value: none.
Example: top-axis = percentiles
bottom-axis Value statistics displayed on the bottom axis.
Possible values: none, percentiles, values.
Default value: values.
Example: bottom-axis = percentiles
rotate-ticks Rotate labels on the bottom axis (typically values axis) by n degrees.
Possible values: 0 (horizontal) and 90 (vertical).
Default value: 0.
Example: rotate-ticks = 90
range-offset Offset applied to the bottom axis, specified in pixels.
Default value: 0.
Example: range-offset = 100
percentiles Percentile numbers to calculate and displayed on the top or bottom axis.
Markers are hidden if the space to display the value is missing.
Possible values: list of comma-separated numbers (0,100].
Example: percentiles = 50,75,90,95,97,99
vertical-grid Display a vertical line corresponding to each percentile or bar range.
Possible values: none, percentiles, values.
Default value: percentiles.
Example: vertical-grid = percentiles
horizontal-grid Display a horizontal line corresponding to each value on the right or left axis.
Possible values: none, density, frequency.
Default value: frequency.
Example: horizontal-grid = frequency

Examples

Multiple Series

Stacked Frequencies

Log-Normal Distribution

Histogram and Box Charts