Chart
A device's related readings over time, as a line chart
The Chart widget plots the history of several related readings from a device over the time range chosen in the filter — for example a measured temperature together with its own setpoint.
The gear icon opens this chart's settings. They are split into three tabs: Data (what is drawn), Appearance (how it is drawn) and Widget (height of the chart, note, width and position of the card).
Data
- Device: which device is shown — defaults to "Current filter device", so it automatically follows the filter bar.
-
Left axis and Right axis: each axis has its own box with two ways to choose what is drawn — they can be combined:
- Group: a set of related readings from that device, drawn as lines. Which groups are available depends on the device type. Defaults to the first group on the left axis and to "None" on the right.
- Individual metrics: tick any number of single readings from the list — alone or in addition to the group. A reading already part of the selected group is shown ticked and locked; a reading that is plotted on the other axis is locked here, since it can only appear once.
The right axis is optional and handy for comparing two values with very different scales in the same chart; it only appears once something is selected for it.
Only groups and readings the device has actually reported data for are offered (and drawn).
Appearance
For all series together:
- Leave gaps where no data was reported: off by default — a period without data is then bridged by a straight line. When on, the line is interrupted there, so outages of the device stay visible in the chart.
- Smooth line: off by default — the line then runs in straight segments between the data points. When on, it is drawn as a smoothed curve. Step, bar and scatter series are not affected.
- Own Y-axis for every series: off by default — all series on one side then share that side's axis. When on, every series gets a scale of its own, which keeps series with very different value ranges readable next to each other. The axes of the left-hand series sit to the left of the chart, those of the right-hand series to the right. Hiding a series via the legend also removes its axis.
- Color the axes like their series: only available together with the previous option — the axis line and labels of every axis then appear in the color of the series it belongs to, so axis and series can be matched at a glance.
Below that, every plotted series has a row of its own and can be styled individually:
- Color: a click on the color field opens the color picker.
- Shape: line, steps, bars or points. Preselected is the shape stored for the metric — it can be changed here per chart.
- Line style: solid, dashed or dotted.
- Line width: from 1 to 10 pixels — or "No line" if only the fill should be visible.
- Fill: "None", "Area" (the region below the line is filled in one color) or "Gradient" (the fill fades out towards the bottom).
- Opacity: how strong the fill is.
The arrow at the end of the row resets the series to its default. Line style, line width, fill and opacity apply to lines and steps; for bars and points they are locked. For shaded bands only the color can be changed.
Height
On the Widget tab, Height sets how tall the chart is at least — from 150 to 800 pixels; "Default" is the previous height. Next to a taller widget in the same dashboard row the chart still grows to match.
Zoom
To take a closer look at a section, drag across the desired time span in the chart with the mouse button held down — on release the chart zooms in to that section, and the value axes adjust. Repeat to zoom in further. "Reset zoom" in the top right of the chart shows the whole time range again. Zooming is available with a mouse or trackpad, not on touch devices.
Legend
Above the chart, the legend lists every plotted series. A click on an entry hides all other series and shows only the one you clicked. From there, further series can be added back one at a time with a click — or hidden again; only when you deselect the last visible series are all of them shown again. Ctrl + click (Mac: Cmd + click, or Shift + click) always shows or hides just the clicked series — which also lets you take a single series out of the full view. Hidden entries appear greyed out in the legend.
Multiple charts
You can have as many Chart widgets on your dashboard as you like, each with its own device and group selection — via "Add another chart" at the bottom of the settings, or via "+ Widget" in the gear menu (see Adding widgets).
