Dashboards in the Cockpit app

Dashboards in Lumen mode are the same documents as on lumen.orkestia.dev. A board you save in the app opens unchanged on the web, and the other way round.

Viewing

Open a dashboard from the Dashboards section of the sidebar, from ⌘K, or from the dashboards index. Each panel reads its endpoint for the toolbar's time range and refreshes on the dashboard's auto-refresh interval while the window is visible. A panel that fails shows its own error and a retry; the others keep working.

If the dashboard declares variables that a panel uses, a bar above the grid lets you pick a value. See Variables.

Panel types

Every panel is one of seven types; the type fixes the query source.

How the app turns a panel into a request:

• window on KPI strip, Error groups and Projects, and from/to on Log pulse and metrics, always follow the selected time range.
• interval: auto resolves from the range. Log pulse: 15m/1h → 1m, 6h → 5m, 24h → 15m, 7d → 1h. Metrics: 15m/1h/6h → 5m, 24h/7d → 1h (the metrics API only knows 5m, 1h, 1d).
• A project of * means all projects; it is dropped from the request.
• filter entries look like attrs.key:value or resource_attrs.key:value; they are sent as repeated filter parameters.

A Single stat reduces the buckets to one number: sum and count add every bucket, any other aggregation shows the last bucket. In a split Time series, a series named by an organization id shows the organization's name.

Customize mode

Choose Customize on a dashboard you own. The page gets an edit bar and the grid shows its guides.

The grid is 12 columns wide with 28 px rows and 12 px gaps. Default sizes (columns × rows): KPI strip 12×4, Log pulse 12×8, Projects 12×12, Error groups 7×10, Activity feed 5×10, Time series 6×9, Single stat 3×5. Below 720 px of width the grid stacks to one column in layout order. A layout change counts only when you finish a drag or resize, so the grid settling as it opens never marks a board as edited.

The panel editor

A live preview under the form shows the panel with your current settings.

Settings

The viewer never changes your toolbar range on its own. If the board's default differs, it shows "Dashboard default: last X · Use it".

Variables

A variable is declared once and used as $name (or ${name}) in a panel's project or filter values. Viewers pick its value above the dashboard; All (*) drops that filter. Checks the app makes before saving, mirroring the API:

• the name matches [A-Za-z_][A-Za-z0-9_]* and is unique;
• the dimension is project, service_name, attrs.<key> or resource_attrs.<key>;
• every $name a panel uses is a declared variable;
• a metrics panel has a metric; the dashboard has a name and at most 40 panels.

Only variables that some panel uses get a picker. A project variable's picker lists your projects; other variables take free text. A choice lasts for the visit, not across launches.

System dashboards

System dashboards (for example Home) come from the server and are read-only. Duplicate to customize makes an editable copy named <name> (copy), then (copy 2) and so on.

Dashboards index

The grid icon in the Dashboards section header opens a searchable list of every board, system ones first, with a home marker, panel count and "updated ago".

An organization can have at most 50 dashboards; the buttons disable at the limit.

Import from Grafana

Paste a dashboard's JSON model (Grafana: Dashboard settings → JSON Model, or Share → Export → Save to file) or choose the file, then Preview import. The app sends it to POST /api/import/grafana. Nothing is saved until you create the dashboard.

The preview says N of M panels imported and lists each Grafana panel with its mapped Lumen type and a tag:

Read the notes, rename the dashboard if you like, then Create dashboard. The button is disabled when no panel was imported.

Compatibility

The app saves each board with layout.grid (the 12-column placements) and layout.rows derived from it, so clients that only read rows still show a sensible order. A board that only has rows is read as a grid by splitting each row's width equally. Limits enforced on save: 40 panels per dashboard, 50 dashboards per organization, names and titles up to 80 characters; a slug is derived from the name and made unique.

Next: Explore and correlate, Query API.