PIE CHART

The Pie Chart illustrates numerical proportions between series values and their total value.

Ring Icons

pie_chart_icons

Chart Lab: View

Series Labels

pie_chart_labels

Chart Lab: View

Pie

pie chart 1

Chart Lab: View

Ring

pie-ring

Chart Lab: View

Alert

pie-alert

Chart Lab: View

Total + Other

pie-other

Chart Lab: View

Hidden Other

pie-other-hidden

Chart Lab: View

[widget] Settings

Inherited settings from Generic Widget: type, title, tooltip, left-units, top-units, width-units, height-units, timespan, path, url, alert-style, alert-expression, style, format, last, legend-position.

Pie Chart has special interactions when a pie segment is clicked:

  • Single click – opens dialog window with a time chart for the series
  • Double click – expands/collapses the selected pie segment

The initial segment position can be controlled with the expand setting.

NameExampleDescriptionChart Lab
modemode = ringDisplay ring instead of pie.
Possible values: pie, ring.
Default value: pie		View
total-valuetotal-value = 1024
total-value = value('007-root') + value('006-root')		Defines the total value explicitly, otherwise it is computed as the sum of series values.

total-value can be calculated by referencing other (hidden) series similar to computed series.

View
View
expandexpand = trueCan be set under [widget] and/or for each [series].
Expands all segments or an individual segment.
Possible values: true, false
Double click modifies expand setting interactively. 		View
selector-modeselector-mode = highlightSelector mode controls how pie segmets react to click interaction.
Possible Settings: highlight, expand.
Highlight – double click highlights the selected pie segment, other segments are greyed out.
Expand – double click expands the selected pie segment.		View
on-series-double-clickon-series-double-click = ''Disable double click functionality in the widget.View
[series] Settings

Inherited settings from Generic Widget [series]: entity, metric, style, color, label, tooltip, format, display, hidden, refresh-interval, retry-refresh-interval, error-refresh-interval.

NameExampleDescriptionChart Lab
series-labelsseries-labels = inside
series-labels = outside
series-labels = connected
series-labels = value >= 2000000 ? 'connected' : 'auto'		Display values for each pie slice (series) as a tick.
Possible settings: inside, outside, connected, auto, none
Default value: none
Can be set to an expression that will change the label type depending on series value.		View
View
Icon and Caption Settings

Icons and captions can be applied to series when Pie chart mode is set to ring.

NameExampleDescriptionChart Lab
iconicon = public/img/svg/linear/users.svg
icon = alerts_color_07
icon = alerts-color-07		Displays an .svg icon.
Path to your custom icons must be set.
We suggest using the /opt/atsd/atsd/conf/portal/img/ directory in your ATSD installation to hold your icons.
ATSD includes a built-in collection of icons.
Built in icons are referenced by name, without the full path.
View built-in Icon Reference Sheet.
Underscores in built-in icon names can substituted with dashes:
icon = alerts_color_07
icon = alerts-color-07
View
View
icon-alert-expressionicon-alert-expression = value('s1') > 10Alert rules that are applied to the icon.View
icon-alert-styleicon-alert-style = return alert > 12000 ? 'fill: red' : 'fill:green';Styles that are applied to the icon when the alert expression is satisfied.View
captioncaption = Administrative UsersСaption displayed below the icon.View
caption-stylecaption-style = font-size: 64px; font-weight: bold; fill: silver;Style applied to the caption.View
min-font-sizemin-font-sizeMinimum caption font size.
Font size will not scale below set size.		View
max-font-sizemax-font-sizeMaximum caption font size.
Font size will not scale above set size.		View
[other] Settings
NameExampleDescriptionChart Lab
displaydisplay = falseDisplay the difference between total-value and the sum of visible series values.
If total-value is defined, but [other] tag is missing, the Other section will not be displayed.
Default: true		View
labellabel = Unmonitored memoryLabel of the Other section.
Default: Other		View
tooltiptooltip = Unmonitored memory (HMC disabled)Tooltip for the Other section displayed on mouse-over.
Default: Other		View
colorcolor = silverColor of the Other section.
Default: lightgray		View
Configuration Example

Chart Lab: View

  [widget]
    type = pie
    timespan = 15 minute
    format = kilobytes
  [series]
    entity = nurswgvml003
    metric = memfree
  [series]
    entity = nurswgvml006
    metric = memfree
  [series]
    entity = nurswgvml007
    metric = memfree