Create a dashboard

Dashboards are workspace pages that collect charts for the metrics you care about. Use them to monitor a service, compare related signals, review incidents, or create an embeddable read-only view for another tool.

What dashboards are for

A dashboard groups charts around one operational question, such as API latency, queue health, or customer-facing error rates.

Each chart can show one or more metric variables. A variable selects a metric, aggregation, dimensions, and display options. This lets one chart compare several series, such as latency by route or request count by status code.

Dashboards also keep a shared time range and optional auto-refresh setting, so every chart is evaluated against the same window.

Find and organize dashboards

Open Dashboards from the app sidebar.

The dashboard list shows every dashboard in the current workspace, the number of charts on each dashboard, and when it was last updated. Use search when the workspace has many dashboards.

You can filter the list to show all dashboards, dashboards with charts, or empty dashboards. You can also sort by last update, name, or chart count.

Create a dashboard

Open Dashboards from the app sidebar, then select New Dashboard.

Enter a name that describes the view, such as API health or Checkout latency, then select Create. The app opens the new dashboard immediately.

You can rename the dashboard later by editing the title at the top of the dashboard page. Unsaved changes are marked until you select Save.

Add charts

Select Add Chart from the dashboard toolbar.

In the chart editor:

• Choose a chart title.
• Pick the chart type, such as Line for time-series trends or Number for a single current value.
• Add one or more variables.
• For each variable, choose a metric, aggregation, and any dimension filters.
• Set a legend label when the default variable name is not descriptive enough.

The preview updates from the selected variables and time range. Save the chart when it shows the data you expect.

Use metric variables

Metric variables are the main way charts read data.

For each metric variable:

• choose the metric name;
• choose the aggregation, such as avg, min, max, sum, count, percentile(95), or trimmed_mean(10;10);
• enter percentile or trimmed-mean bounds when the aggregation needs parameters;
• add dimension filters when you only want one slice of the metric;
• set a legend label when the metric name alone is not clear.

Dimension filters can include or exclude one dimension value. Use them to split operational views by values such as environment, region, endpoint, status, customer, or queue.

Use expression variables

Expression variables calculate a new series from other variables in the same chart.

Use them when the raw metric is not the final value you want to show. For example, you can compare two counters, combine related series, or derive a ratio from separate variables.

Give each source variable a short name, then reference those names in the expression. Keep helper variables hidden when they are only used to calculate the final visible series.

Choose the chart type

Use Line charts for trends over time, comparisons between series, and incident review.

Use Number charts for a compact current value, such as latest latency, current queue depth, or current error rate. A Number chart displays the latest returned bucket, and sum is the sum within that bucket. To show a total for the whole selected window, choose a resolution and window that produce a single returned bucket. Number charts can also show a unit such as ms, %, or req/s.

Arrange the dashboard

Charts can be resized and moved inside the dashboard grid. Use this to keep the most important signals large and visible near the top.

Layout changes are saved automatically. Dashboard-level changes, such as renaming the dashboard or changing auto-refresh settings, are saved with Save.

Use time range and refresh controls

The time range picker controls the window used by every chart on the dashboard. Use shorter windows for live operations and longer windows for trend review.

Auto-refresh keeps the dashboard current while you are watching a service. Disable it when you are investigating a fixed historical window.

See Metric rollups and resolution when choosing the bucket size for dashboard charts.

Share or embed a dashboard

Select Generate iframe to create an embeddable dashboard iframe. The generated iframe uses a restricted embed token, so it can display that dashboard without giving access to the full workspace UI.

Use embedded dashboards for status pages, internal runbooks, or other tools that need a live read-only view.

If the embed token is missing, expired, or cannot access the dashboard, the embedded view shows an error instead of chart data. Generate a new iframe when an old embed stops working.

Delete a dashboard

Use the dashboard list to delete dashboards that are no longer needed.

Deleting a dashboard removes the dashboard and all of its chart configuration. It does not delete the underlying metrics.

Permissions

Dashboards belong to the current workspace. Viewing, creating, updating, embedding, and deleting dashboards require role permissions for dashboard actions in that workspace.

See Create and use roles for custom role policies, and Query metrics in the UI for inspecting the metric data used by dashboard charts.