Skip to content

Custom dashboards

While the standard views (Dashboard, Error Overview, Host Detail) have fixed layouts, custom dashboards let you build your own — mixed widgets, your own variables, share links.

Create a dashboard

/dashboards → New:

Field Meaning
Name display name
Description optional
Tenant super admin: global or tenant-specific
Visibility private / shared with tenant / public (with URL token)

After creation you land in edit mode.

Place widgets

Drag-and-drop grid. Per widget:

  1. + Widget bottom right
  2. Pick widget type (see Widget reference)
  3. Configure data source and options
  4. Resize via handle

Layout auto-saves every 2 s.

Variables

Variables are placeholders like $host, $tenant that let multiple widgets react to the same selection.

Variable types

Type Values
query dynamic from DB: all_hosts, all_services, all_tenants, all_tags
custom manually maintained list of values

Define

Edit mode → Settings → Variables → New:

name: host
label: Host
type: query
query: all_hosts
multi: true            # Multi-select?
all_option: true       # "All" as a value?
default: all

Use in widgets

In widget options where a host pick is needed: $host or $host.id. With multi-select, the widget renders per value or as a combined view — depends on type.

URL persistence

Variable values land in URL params:

/dashboards/<id>?var-host=web01,web02&var-time=last_24h

Sharing a current view = copy browser URL.

Variable bar

At the top of the dashboard the VariableBar shows dropdowns per variable. Multi-select via pills, „All" option, search in dropdown.

Time range

Per dashboard a global time range:

  • last_15m / last_1h / last_6h / last_24h / last_7d / last_30d
  • Custom range with date picker

The time range applies to all time-based widgets.

Sharing

Private → tenant-shared

Edit mode → Settings → Visibility:

  • Private: owner only
  • Tenant: all users in the tenant with dashboard.view
  • Public: token URL without login (read-only)

Public token

Public dashboards have a unique URL:

/public/dashboards/<token>

Visible without login, read-only. Variables + time range can be adjusted by visitors, but layout is fixed.

Token rotatable — old link becomes invalid.

Permission

Permission Effect
dashboard.view visible in list
dashboard.edit edit
dashboard.create create new
dashboard.publish issue public token

Example

A „Datacenter Health" dashboard:

┌─────────────────────────────────────────────────────────────┐
│ Variables: Tenant=$tenant, Host=$host, Time=last_24h        │
├─────────────────────────────────────────────────────────────┤
│ [Status summary]  [Alerts (last 24h)]  [Active downtimes]   │
│  44 OK              7 CRIT/WARN          2 active           │
├─────────────────────────────────────────────────────────────┤
│ [Top 10 problems by time (bar chart)]                       │
├─────────────────────────────────────────────────────────────┤
│ [CPU per host (heatmap)]   [Disk per host (bar chart)]      │
├─────────────────────────────────────────────────────────────┤
│ [Predictions: disk filling up]                              │
└─────────────────────────────────────────────────────────────┘

Next