Dashboard
Dashboard
A dashboard is a canvas of panels arranged on a grid. Each panel pulls data from a data source, runs it through a transformation pipeline, and draws a chart or table. Dashboards belong to a system and can be opened, edited, and shared by anyone with access to that system.
Anatomy of a dashboard
| Part | What it does |
|---|---|
| Name | The dashboard's display title. |
| Panels | The charts, tables, and stats laid out on the grid. See Panels. |
| Layout | Where each panel sits and how big it is — stored as a grid of x, y, width, height values. |
| Time range | A global start/end window applied to every panel that binds to it. |
| Refresh interval | How often panels re-fetch their data automatically. |
| Global transforms | Optional transformations applied to every panel before its own pipeline runs. |
Editing a dashboard
Open a dashboard to enter the editor. Changes save automatically — you'll see a "Saving…" / "Saved" indicator near the title.
The grid
Panels live on a 24-column grid.
- Move a panel by dragging its header.
- Resize a panel from its bottom-right corner.
- The layout is free-form — panels stay where you put them and don't auto-collapse.
Toolbar controls
- "Add Panel" — create a new panel and drop it onto the grid.
- "Time Range" — set the global window (e.g. Last 24 hours, Last 7 days, or a custom range). Panels that bind their query to the dashboard time range update together.
- "Refresh interval" — choose how often data re-fetches: Off, 5s, 10s, 30s, 1m, or 5m.
- Refresh — re-fetch every panel once, now.
- Unused panels — panels that exist but aren't placed on the grid appear here for quick re-adding.
Configuration shape
Under the hood a dashboard is stored as:
Code
| Field | Type | Notes |
|---|---|---|
name | string | Required. |
refreshInterval | number | Seconds between auto-refreshes. Default 5; set 0 to disable. |
panelIds | string[] | Panels belonging to this dashboard. |
layout | object[] | One entry per placed panel (see below). |
globalTransformIds | string[] | Transformers run before each panel's own pipeline. |
Layout items
Each layout entry positions one panel on the 24-column grid:
| Field | Meaning |
|---|---|
i | The panel ID this entry positions. |
x, y | Grid column and row of the top-left corner. |
w, h | Width (in columns) and height (in row units). |
minW, minH, maxW, maxH | Optional size limits. |
static | true locks the panel so it can't be moved or resized. |
Next: add Panels to your dashboard, then connect them to a Data Source.
Last modified on