Device Historical Analytics chart

What this widget is for

The Device Historical Analytics chart is the dashboard's deep-dive tool for looking back over device data. You pick which devices, which fields, and which day (or range of days), and the chart plots the readings as lines so you can see trends, compare devices, spot anomalies, and total a value over a window.

It's the right widget when a question starts with "on this day…", "between these dates…", or "how do these devices compare for…". For at-a-glance live values use the icon widgets instead; this chart is built for analysis, not real-time monitoring.

Companion guides

• Dashboard overview — how to add, move, resize, and remove widgets, and how to save layouts as different Views.

Where to find it

Open the Dashboard, click the pencil icon to enter edit mode, then click Add New Widget. In the picker, search for Device Historical Analytics (or scroll to it) and click Add Widget. The chart drops onto your dashboard with the default header Device Record — you can rename it from the gear-icon settings.

The chart at a glance

A newly added chart shows the header on the left and a row of small tool icons in the top-right:

• Date picker — pick the day (or days) to plot.
• Magnifier — switch the chart into zoom mode.
• Open hand — switch into "select a range to total" mode.
• Download — export the plotted data as CSV.
• Gear — open the settings dialog (this is where you choose what to plot).

Below the toolbar is the chart area itself with one or more y-axes that appear automatically as you add series with different units, and a legend / model pager at the bottom that lets you switch which device model's controls are visible.

Choosing what to plot

Open the gear icon. The settings dialog lets you:

• Set the title that appears at the top of the chart.
• Pick devices and fields per device model. For each model that is relevant on this site, a section lets you choose which serial numbers and which fields of that model to plot. Tick all serial numbers to plot every device of that model; tick specific ones to focus on a subset. The fields available depend on the model.

You can mix models freely — for example one series from the inverter and three series from the battery cluster in the same chart. Each new unit (V, A, kW, °C, %) gets its own y-axis on the side, so the lines stay readable instead of all squeezing onto one scale.

Changes save automatically as soon as you close the dialog. There is no separate save button.

Picking a date or a range

Click the date picker in the top-right of the chart. The calendar opens. Pick a day to plot that single day, or use the date picker's multi-day option to include several days ending on the chosen date — useful for weekly trends or for comparing weekdays to weekends.

The chart redraws as soon as you choose a date. The x-axis shows time of day for a single day, or the full date+time for a multi-day range.

Reading the chart

• Hover anywhere along the chart to see a tooltip. It lists every series at the hovered time, sorted highest to lowest, with the value and unit for each.
• Click the chart to pin the tooltip in place. Click again to unpin and let it follow the cursor again. This is the easiest way to compare exact values across many series at one moment — pin the tooltip, then read down the list.
• Multiple y-axes stack on either side of the chart as needed. Each axis is labelled with its unit; series follow the axis that matches their unit.
• The line for a series may have gaps. Gaps are deliberate: they mean the chart had no data for that span (sensor offline, gateway down, etc.). A flat line at zero would have misleadingly implied "the value was zero" — a gap means "we don't know".

Zooming into detail

Click the magnifier icon to enter zoom mode. The icon changes to a close (✕) icon. Drag horizontally on the chart to zoom into that time window; the percentage of the original range left visible appears in the top-right corner.

To leave zoom mode and return to the full range, click the close (✕) icon. The chart redraws with all data again.

Selecting a region to total

The open-hand icon turns on select mode. Drag horizontally across the chart and release to mark a window. The widget computes a sum / total for the selected window — handy for answering "how much energy was used between 10am and 2pm" without doing the maths by hand.

Click the close (✕) icon (the open hand turned into a ✕) to leave select mode.

Downloading the underlying data

Click the download icon to export the plotted data as CSV — one row per timestamp, columns for each series currently on the chart. The CSV reflects what you can see right now: same date range, same series selection. Change the chart first if you want a different export.

Who can do what

• Any signed-in user can add the chart to their dashboard, choose models and fields, change dates, zoom, total a region, and download the CSV. The chart is read-only — it never sends a command back to a device.

Common issues

• "No Selection" — the chart is showing this when no field is ticked in the settings dialog. Open the gear and tick at least one field on at least one device model.
• "No Data For Time Period" — a field is selected but the back-end returned no readings for the chosen date(s). Common causes: the date is before the device started reporting, the device was offline that day, or the chosen field isn't recorded for the chosen device. Try a different date or a different field.
• A series is missing a unit — the unit on the y-axis or tooltip is blank for one series. The device metadata for that field is incomplete on the server. The chart still plots the values correctly; only the unit label is missing. Raise this with support so the metadata can be filled in.
• The legend "pager" arrows are greyed out — that's normal when only one device model is being plotted. The arrows let you flick between models when you have several; with one model there's nowhere to flick to.

Tips and gotchas

• Wide ranges + many devices = slow first load. Each enabled series fetches data for every day in the range. A week of every battery in a large fleet is a lot of points. Start with a single day and a few devices; widen once you know what you're looking for.
• Pin the tooltip before clicking icons. If you've zoomed in or selected a range and then click a chart icon, the tooltip un-pins. Pinning is a viewing aid, not a saved state.
• Rename your charts. A dashboard with three charts all titled Device Record is hard to read at a glance. Give each one a name that matches what it's there to show ("Battery temperatures — last 24h", "Inverter power — week view").
• The widget refreshes with the dashboard. When Auto Update is on in your View Settings, this chart re-fetches its data on every refresh, so a chart you leave open quietly picks up the newest readings.