Calendar Chart

Overview

The Calendar Chart displays the deviation of aggregated series values for a calendar period from a specified threshold. Series values within each period are aggregated by statistical function and assigned a color which reflects the magnitude of deviation.

[widget]
  type = calendar
  
  thresholds = 0,30,60,100
  colors = green,yellow,red

  timespan = 12 hour
  summarize-period = 1 hour
  summarize-statistic = percentile(95)

  [series]
    metric = cpu_busy
    entity = nurswgvml0*

Widget Settings

  • The settings apply to the [widget] section.
  • Common [widget] settings are inherited.
Name Description
summarize-period Period specified in time units to split loaded time series into calendar segments.
Format: count time_unit.
Default value: 5 minute.
Example: summarize-period = 1 hour
summarize-statistic Statistical function applied to values within each period.
Refer to Aggregators for possible values.
Default value: avg.
Example: summarize-statistic = percentile(75)
palette-ticks Display legend labels.
Possible values: false, true.
Default Value: false.
Example: palette-ticks = true
rotate-palette-ticks Rotate legend labels.
Possible values: false (horizontal), true (vertical).
Default value: false.
Example: rotate-palette-ticks = true
range-merge Compute a single range for all series with minimum and maximum from all loaded series.
Possible values: false, true.
Default value: false.
Example: range-merge = true
sort Sort entities by name or value in ascending (ASC) or descending (DESC) order.
Example: sort = name DESC
centralize-ticks Center time and date markers over summarize periods.
Possible values: false, true.
Default value: false.
Example: centralize-ticks = true
ticks-time Tick marks on the time axis.
Default value: 10.
Example: ticks-time = 5
data-labels Display values inside colored rectangles formatted according to format setting.
Default value: false.
Example: data-labels = true

Series Color Settings

  • The settings apply to the [widget] or [series] section.
  • Common [series] settings are inherited.
Name Description
thresholds Threshold values.
The number of specified colors must be 1 fewer than the number of thresholds.
Example: thresholds = 0, 50, 90, 100
colors Comma separated list of color names or hex codes, assigned to threshold ranges.
The number must be 1 fewer than the number of thresholds.
Example: colors = green, yellow, red
Recommended color palette tools: colorhexa, material.io.
color-range Color palette assigned to threshold ranges.
Possible values: color names.
Built-in ranges: red, blue, black.
Example: color-range = black
gradient-count Number of gradients per threshold range.
Default value: 3.
Example: gradient-count = 2

Examples

Data Labels

Custom Color Range

Legend Position

No Threshold

Threshold

Multiple Weather Stations