Skip to content
dashboards
Analysis

Dashboards

Dashboards put business numbers and operational health on the same canvas. A widget can read from a saved query, a monitor, a host, or a metric — so the KPI and the uptime of the service producing it live side by side.

Read
5 min
Module
Dashboards

Widget sources

Every widget declares a source. They all resolve through one endpoint, so the chart renderers do not care where the numbers came from — which is what lets a single dashboard mix a revenue query with the uptime of the checkout endpoint.

Query
Any saved query. Results are shaped into series by picking a label column and one or more value columns.
Monitor
Check history for an endpoint monitor — response time, status over the selected window.
Host
Metric samples pushed by the host agent: CPU, memory, disk, network.
Metric
A definition from the semantic layer, so the number matches everywhere it is quoted.

Widget types

TypeBest forShape expected
Line / areaA value over timeOne time column + one or more numeric columns
BarComparison across categoriesOne label column + one numeric column
StatA single headline numberFirst row, first numeric column
TableDetail you actually read row by rowAny result set
UptimeAvailability of a monitorMonitor source only
A widget that returns the wrong shape renders an explicit message naming the columns it found, rather than an empty chart. If a widget looks blank, read that message — it is almost always a column-selection problem, not a data problem.

Layout and refresh

Widgets sit on a grid you drag and resize; the layout is versioned, so an older client cannot corrupt a newer arrangement. Each widget carries its own refresh interval — a monitor tile can poll every 30 seconds while an expensive nightly aggregation refreshes once an hour.

Time range
The dashboard-level range applies to every time-aware widget. A widget can opt out and pin its own window.
Caching
Query-backed widgets reuse the cached result when parameters and window are unchanged, so opening a dashboard does not re-run every query.

Sharing and embedding

A dashboard can be shared read-only through a signed public link, or embedded in another product using a workspace embed key. Both paths are scoped to the single dashboard and carry no session — a shared link cannot be walked back into the console.

Public share
Token-based URL, revocable at any time. Optional expiry.
Embed
Signed embed key per workspace, rendered in an iframe with the console chrome stripped.