Dashboards

A dashboard is a saved board of widgets, and each widget is driven by its own query. Use dashboards to keep the numbers your team checks every morning in one place, such as pipeline duration, failure rate, flaky tests and storage growth, so nobody has to work them out again each time.

Dashboards are available on plans that include API and query access. Team members with any role can create and edit them.

Finding and creating boards

Dashboards in the left navigation lists your team's saved boards, with a search box to find one by name.

New dashboard asks for a name and opens an empty board, which prompts you to add your first widget. A board is read-only until you press Edit. This prevents an accidental drag from rearranging a board your team shares.

The editing surface

In edit mode, the board becomes a grid and the properties panel opens on the right.

The toolbar at the top holds the controls for the whole board: the time range, a manual Refresh, the auto-refresh interval, Add widget, import and export, Clear and Save. If you close edit mode with unsaved changes, you are asked before they are discarded.

Adding and arranging widgets

Add widget opens a searchable list of the five widget types.

• A chart plots trends and comparisons over time as a line, bar or pie chart.
• A table shows rows of detail, with resizable columns.
• A metric shows a single number.
• A gauge shows one value against thresholds you set.
• A markdown widget holds text, links and headings. Use it to explain what the board is for or to link to a runbook.

Widgets sit on a 24-column grid. Drag a widget to move it, drag an edge to resize it, and the board closes up the space around it. The properties panel on the right always edits the selected widget. When you enter edit mode, the first widget on the board is selected.

Configuring a widget

The properties panel has three parts. Widget Type and Title identify the widget. Data holds the source and the query that feeds the widget, written in the query language described in the BNQL reference. Attributes holds the display settings for the widget type you chose, such as chart type and data format for a chart, thresholds and style for a gauge, or the value template and unit for a metric.

Widgets are usually driven by their query instead of by fixed values, so a saved board always shows live data. To change what a widget shows, change its query. A widget can also use inline values or no data at all, which is how a static markdown panel works.

Charts and tables support per-field overrides. Add a field by name, then set only the properties you want to change for it: colour, unit, whether it is plotted, tooltip behaviour, column width, visibility or thresholds. For example, you can make failures red without changing the colour of the whole series, or format one column as a duration and another as a percentage.

Units come from a shared catalog that covers data sizes, durations, throughput, currency, temperature, dates and more. This means a value displays as 2h 5m or 1.4 GB without any formatting in your query. If you type a unit that isn't in the catalog, it is used as a plain suffix.

Time range and refresh

The board's time-range control sets the window for every widget query, which is why widget queries usually don't include their own time bounds. When you change the range, the whole board reloads.

Refresh runs every query again on demand. Next to it is the auto-refresh interval. You can turn it off or set it anywhere from five seconds to one day, which keeps a board up to date on a wall display.

Saving, importing, and exporting

Save stores the layout, widget configuration and refresh interval for your team. Clear removes every widget from the board.

Export downloads the whole dashboard as JSON, and Import loads one back in. Use them to copy a board between teams, keep a template in version control or share a layout with another team.

The AI Insights assistant can also build a complete dashboard from a question, and you can save it here with one click. This is often the quickest way to get a first version on screen.