Skip to content
numbrs docs

Dashboard Builder

Dashboards are the main way to view your data in numbrs. Each dashboard is a collection of panels, and each panel visualizes one metric or data source. You can mix data from any integration — relay latency, Claude costs, system stats — all on one screen.

Creating a dashboard

Section titled “Creating a dashboard”
  1. Click Dashboards in the sidebar
  2. Click New Dashboard
  3. Give it a name
  4. Click Add Panel to start

You can create as many dashboards as you want. One per concern works well — a relay monitoring dashboard, a Claude usage dashboard, a system stats dashboard.

Panel types

Section titled “Panel types”

Choose the panel type based on what you’re measuring:

Line chart — Time series with a line. Good for anything that changes continuously over time: response latency, token counts, CPU usage, uptime percentage. Shows trends and anomalies clearly.

Area chart — Like a line chart but with a filled area below the line. Works well for cumulative or volume-based metrics where the “area under the curve” has meaning — total tokens consumed, total plays, total bytes transferred.

Stat — A single large number showing the current or aggregated value. Great for “at a glance” numbers at the top of a dashboard: sessions today, current uptime %, total spend this week. Optionally shows a trend arrow.

Gauge — A radial gauge showing where a value falls within a defined range. Best for metrics with a natural min/max: battery percentage, disk usage %, load average. The color shifts as the value approaches the max.

Configuring a panel

Section titled “Configuring a panel”

When you add or edit a panel:

  1. Select a metric — choose from the dropdown (e.g. server.cpu_pct, relay.connect_latency)
  2. Set the time range — inherit from the dashboard global setting or override per panel
  3. Filter by tags — narrow to a specific host, project, channel, or any tag you’ve set
  4. Choose aggregation — average, sum, max, min, or last value, depending on what makes sense for the metric
  5. Set the panel type and configure display options (colors, units, thresholds)

Layout

Section titled “Layout”

Panels sit on a grid. Drag them to reorder. Resize by dragging the bottom-right corner. The layout saves automatically.

On mobile, panels stack vertically. No separate mobile configuration is needed.

Using templates

Section titled “Using templates”

Templates are pre-built dashboards for common setups. Instead of building from scratch, you can use a template and have charts ready immediately.

To use a template:

  1. Click New Dashboard
  2. Click Use a template
  3. Choose a template (Claude usage, relay monitoring, system stats, etc.)
  4. The dashboard is created with panels pre-configured for the relevant metrics

You can customize template dashboards after creating them — add panels, remove ones you don’t need, change chart types.

Sharing a dashboard

Section titled “Sharing a dashboard”

Any dashboard can be made public. Public dashboards are view-only — visitors see your data but can’t edit anything.

To share:

  1. Open the dashboard
  2. Click the gear icon (settings)
  3. Toggle Public sharing
  4. Copy the URL

The URL works for anyone without a numbrs account. Useful for sharing relay stats with your community.

Tips

Section titled “Tips”
  • Put Stat panels at the top for summary numbers, then line/area charts below for trends. Easier to scan.
  • Give panels specific names: “Output tokens today (Claude Code)” beats “output_tokens”.
  • Create one dashboard per concern rather than cramming everything onto one screen.
  • Use the global time range control at the top of the dashboard to zoom in on incidents.

Next steps

Section titled “Next steps”