> For the complete documentation index, see [llms.txt](https://docs.groundcover.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.groundcover.com/use-groundcover/dashboards-and-alerts/dashboard-visualizations.md). # 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](/use-groundcover/dashboards-and-alerts/create-a-dashboard.md). ### 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 typeTime seriesTableStatTop listPieData
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 | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.groundcover.com/use-groundcover/dashboards-and-alerts/dashboard-visualizations.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.