For the complete documentation index, see llms.txt. This page is also available as Markdown.

Dashboard Visualizations

This page documents the visualization types available in dashboard widgets and the configuration options for each one.

For the overall dashboard workflow (creating widgets, variables, saving, and permissions), see Creating Dashboards.

Visualization types at a glance

Visualization
Best for

Time series

Trends and rates over time

Table

Grouped or row-level tabular results

Stat

One or more KPI numbers

Top list

Ranked values as horizontal bars

Pie

Share of total across a small number of categories

Treemap

Hierarchical share of total across many categories

Data

Raw log, trace, or event rows (list-style)

In the Widget Builder, switch types with the visualization tabs under your query. The preview updates immediately; configuration panels below the preview change based on the selected type.

Which visualizations each data type supports

Not every data type supports every visualization.

Data type

Time series

Table

Stat

Top list

Pie

Data

Metrics

Logs

Traces

Events

Entities

Issues

RUM

APM

Ingestion

Multiple queries in one widget

Some visualizations let you add query B, C, … or a formula query in the same widget.

Visualization
Multiple queries
Formula

Time series

Table

Stat

Top list

Pie

Data

When a widget has more than one query (or a formula), results are shown in a combined view. For example, multiple series on one chart or merged table columns.

Data widgets always use a single query.


Cross-cutting configuration options

These settings apply across several visualization types.

Rollup interval (bucket size)

For time-bucketed queries, the rollup interval controls how data is grouped in time (for example 1m, 5m, 1h). It appears on the query row when the data type supports it.

The effective interval may be adjusted automatically to respect minimum bucket sizes for certain data types (for example ingestion queries enforce a minimum of ten minutes).

Data unit

The Data Unit panel controls how numeric values are formatted (labels, axes, legend stats, and stat tiles).

Unit category
Examples

General

Number, Percentage, Raw

Time

Nanoseconds through Minutes

Data size

Bytes, Bytes/sec, KB/s

Other

mCPU, Dollars, Req/s

For tables with multiple numeric columns, you can set a unit per column.

Only stats column units can be edited.

High series count warning

Time series, table, top list, and pie widgets may return many series or groups. When the result count exceeds the default display limit (1,000 series), a warning appears above the preview.

Control
Behavior

Show all

Renders more series (up to a hard cap of 5,000)

Performance note

Showing all series can slow rendering on dense queries

Stat widgets do not offer this toggle; they display up to 50 stat tiles and truncate beyond that.


Time series

Use when: You need to see how a metric or aggregated signal changes over the dashboard time range.

Chart display type

Under Additional Styling → Display:

Option
Appearance

Lines

Separate line per series (default for most data types)

Stacked Bars

Time buckets as stacked bars

Area

Stacked area chart

Missing buckets

When a time bucket has no data point, you can choose how gaps are rendered:

Option
Effect

Nulls (default)

Breaks the line / leaves the bucket empty

Zeros

Treats missing buckets as zero

Color palette

Under Additional Styling → Color:

Palette
Description

Classic

Default product palette

Smart

Semantic coloring (status-aware where applicable)

Red / Green / Blue / Orange / Gray / Purple

Fixed theme palettes

Color applies across series in the chart (eight-color rotation for time series).

Legend

Under Legend → Mode:

Mode
Behavior

Compact

Inline legend chips below the chart

Table

Tabular legend with optional stat columns

None

Legend hidden

When Table mode is selected, choose which stat columns appear:

Column
Shows

Avg

Average over the visible time range

Min

Minimum value

Max

Maximum value

Sum

Sum over the range

Value

Latest / instant value

Y-axis controls

Setting
Description

Scale

Linear (default) or Log

Min

Fixed lower bound (leave empty for auto)

Max

Fixed upper bound (leave empty for auto)

Always Include Zero

Forces the axis to include zero when compatible with min/max and scale

Log scale cannot include zero. If min is above zero or max is below zero, Always Include Zero is disabled.

Interaction on the dashboard

  • Zoom on the time axis refines the dashboard time range (when chart zoom is enabled on the dashboard view).

  • Hover over a series will show the value at a specific point along with indication for the step size.

Table

Use when: You need sortable columns, grouped aggregates, or row-level detail in a grid.

Configuration in the widget builder

Option
Where
Description

Data unit

Data Unit panel

Default formatting for numeric value columns

Per-column units

Data Unit panel

Available when multiple numeric columns are detected

Rollup interval

Query row

For time-bucketed SQL/metrics table queries

Combined tables

When multiple queries feed one table widget, columns from each query are merged into a single grid. Per-column units can be set for numeric columns from each query.

Interaction on the dashboard

Hovering over a specific line will show the option to drill down further either in Explore, for aggregated drill down, or to the relevant data type page (e.g. Logs), to see the actual rows.

Stat

Use when: You want a large numeric KPI - one number per series or group.

Configuration

Option
Description

Data unit

Controls value unit of measurement

Rollup interval

For time-aggregated stats

Behavior

  • Each series or group renders as a stat tile in a responsive grid.

  • Up to 50 stats are shown; additional series are truncated.

  • With multiple queries or a formula, stats from all queries appear in the combined stat grid.

Top list

Use when: You want a ranked horizontal bar chart (for example “top 10 namespaces by log volume”).

Configuration

Option
Where
Description

Data unit

Data Unit panel

Value axis formatting

Color

Additional Styling

Single-bar palette (one color theme for all bars)

Rollup interval

Query row

When the query is time-bucketed

Behavior

  • Bars are ranked by the query’s sort/limit.

  • Works with multiple queries in combined view (each query contributes bars).

  • Supports the high-series warning and Show all toggle (same limits as time series).

Pie

Use when: You want proportional breakdowns across a small number of categories.

Configuration

Option
Where
Description

Data unit

Data Unit panel

Slice value formatting

Color

Additional Styling

Multi-slice palette (same options as time series)

Rollup interval

Query row

When applicable

Behavior

  • Best suited to a limited number of slices (use query limit to keep the chart readable).

  • Supports multiple queries in combined view.

  • Supports the high-series warning and Show all toggle.

Data

Use when: You want a scrollable list of raw records - similar to the Logs, Traces, or Events explorers - embedded in a dashboard tile.

Availability

Requirement
Detail

Data types

Logs, Traces, or Events only

Query mode

Builder mode only (not the raw SQL/editor mode)

Query count

Single query per widget

Configuration

Option
Description

Column selectors

Choose which fields appear (builder query row)

Filters

Standard gcQL / filter builder for the signal type

Limit

Controls page size; scroll or load more for additional rows

Last updated