Visualizations and dashboards with ClickStack

To remove, edit, or duplicate a visualization, hover over it and use the corresponding action buttons.

## Dashboard - Listing and search[​](#dashboard-listing-search "Direct link to Dashboard - Listing and search")

Dashboards are accessible on the dashboards page. They are organized by tag, with built-in search and filtering to quickly locate specific dashboards.

Dashboards can be favorited for easy access on the sidebar and at the top of the listing page. Favorites are individual to each user.

## Dashboards - tagging[​](#tagging "Direct link to Dashboards - tagging")

You can add tags to dashboards and saved searches to help organize them.
Tags provide a flexible way to categorize and filter based on your needs.

#### How tags work[​](#how-tags-work "Direct link to How tags work")

- **Organization**: Tags appear in the left sidebar, where dashboards and saved searches are grouped by their assigned tags
- **Multiple tags**: You can add one or more tags to a single item for better categorization
- **Auto-creation**: If you assign a tag that doesn't exist yet, it will be automatically created
- **Easy management**: You can add or remove tags at any time to adjust your organization structure

This makes it easy to find related items and maintain an organized workspace as your collection grows.

You can also select multiple tags to filter and view items across different categories:

## Custom filters[​](#custom-filters "Direct link to Custom filters")

In addition to the [free-text filters](#filter-dashboards) available on all dashboards, saved dashboards support custom dropdown filters populated by data queried from ClickHouse. These provide reusable, point-and-click filter controls so that dashboard viewers can filter without writing expressions manually.

The following steps demonstrate adding a custom filter to the dashboard created in the ["Creating dashboards"](#creating-dashboards) section.

Open the Edit Filters dialog

### Open the Edit Filters dialog[​](#open-edit-filters "Direct link to Open the Edit Filters dialog")

Open a saved dashboard and select **Edit Filters** from the toolbar.

Add a new filter

### Add a new filter[​](#add-new-filter "Direct link to Add a new filter")

Click **Add new filter**. Configure the filter by providing a **Name**, selecting a **Data source**, and entering a **Filter expression** — a SQL column or expression whose distinct values will populate the dropdown. Click **Save filter**.

For example, to add a service filter for trace data, use `ServiceName` as the filter expression with the `Traces` data source. The "Dropdown values filter" is optional, and provides a way to restrict which values appear in the dropdown.

The Filters modal shows all configured filters for the dashboard. From here you can edit or delete existing filters, or add additional ones.

Use the filter

### Use the filter[​](#use-filter "Direct link to Use the filter")

Close the Filters modal. The new dropdown filter appears below the search bar. Click it to see the available values, then select one to filter all visualizations on the dashboard.

(Optional) Save filter values as default

### (Optional) Save filter values as default[​](#save-default-filters "Direct link to (Optional) Save filter values as default")

To persist a filter selection as the dashboard default, choose **Save Query & Filters as Default** from the dashboard menu. The dashboard will always open with the selected filters applied. To reset, select **Remove Default Query & Filters** from the same menu.

Note

Custom dropdown filters are available on saved dashboards. For an example of this pattern in action, see the [Kubernetes dashboard](#kubernetes-dashboard), which provides built-in dropdown filters for Pod, Deployment, Node name, Namespace, and Cluster.

## Drilldown to search[​](#drilldown-to-search "Direct link to Drilldown to search")

Dashboard tiles support drilldown to the Search page. Click on a data point in a visualization to open a context menu with the following options:

- **View All Events** — navigates to the Search page showing all events from the selected time window.
- **Filter by group** — navigates to the Search page filtered to a specific series.

This is useful for investigating specific spikes or anomalies spotted in a dashboard — you can quickly pivot from an aggregated view to the underlying individual events.

## Presets[​](#presets "Direct link to Presets")

HyperDX is deployed with out-of-the-box dashboards.

### ClickHouse dashboard[​](#clickhouse-dashboard "Direct link to ClickHouse dashboard")

This dashboard provides visualizations for monitoring ClickHouse. To navigate to this dashboard, select it from the left menu.

This dashboard uses tabs to separate monitoring of **Selects**, **Inserts**, and **ClickHouse Infrastructure**.

Required system table access

This dashboard queries the ClickHouse [system tables](/docs/operations/system-tables) to expose key metrics. The following grants are required:

`GRANT SHOW COLUMNS, SELECT(CurrentMetric_MemoryTracking, CurrentMetric_S3Requests, ProfileEvent_OSCPUVirtualTimeMicroseconds, ProfileEvent_OSReadChars, ProfileEvent_OSWriteChars, ProfileEvent_S3GetObject, ProfileEvent_S3ListObjects, ProfileEvent_S3PutObject, ProfileEvent_S3UploadPart, event_time) ON system.metric_log`

`GRANT SHOW COLUMNS, SELECT(active, database, partition, rows, table) ON system.parts`

`GRANT SHOW COLUMNS, SELECT(event_date, event_time, memory_usage, normalized_query_hash, query, query_duration_ms, query_kind, read_rows, tables, type, written_bytes, written_rows) ON system.query_log`

`GRANT SHOW COLUMNS, SELECT(event_date, event_time, hostname, metric, value) ON system.transposed_metric_log`

### Services dashboard[​](#services-dashboard "Direct link to Services dashboard")

The Services dashboard displays currently active services based on trace data. This requires you to have collected traces and configured a valid Traces data source.

Service names are auto-detected from the trace data, with a series of prebuilt visualizations organized across three tabs: HTTP Services, Database, and Errors.

Visualizations can be filtered using Lucene or SQL syntax, and the time window can be adjusted for focused analysis.

### Kubernetes dashboard[​](#kubernetes-dashboard "Direct link to Kubernetes dashboard")

This dashboard allows you to explore Kubernetes events collected via OpenTelemetry. It includes advanced filtering options, enabling you to filter by Kubernetes Pod, Deployment, Node name, Namespace, and Cluster, as well as perform free-text searches.

Kubernetes data is organized across three tabs for easy navigation: Pods, Nodes, and Namespaces.

- [Creating visualizations](#creating-visualizations)
  - [Navigate to Chart Explorer](#navigate-chart-explorer)- [Create visualization](#create-visualization)- [Creating dashboards](#creating-dashboards)
    - [Navigate to Dashboards](#navigate-dashboards)- [Create a visualization – average request time by service](#create-a-tile)- [Create a visualization – events over time by service](#create-a-tile-2)- [Filter dashboard](#filter-dashboards)- [Dashboards - editing visualizations](#dashboards-editing-visualizations)- [Dashboard - Listing and search](#dashboard-listing-search)- [Dashboards - tagging](#tagging)- [Custom filters](#custom-filters)
            - [Open the Edit Filters dialog](#open-edit-filters)- [Add a new filter](#add-new-filter)- [Use the filter](#use-filter)- [(Optional) Save filter values as default](#save-default-filters)- [Drilldown to search](#drilldown-to-search)- [Presets](#presets)
                - [ClickHouse dashboard](#clickhouse-dashboard)- [Services dashboard](#services-dashboard)- [Kubernetes dashboard](#kubernetes-dashboard)

Was this page helpful?