ClickStack FAQ

[Edit this page](https://github.com/ClickHouse/clickhouse-docs/blob/main/docs/use-cases/observability/clickstack/faq.md)

This page answers frequently asked questions about ClickStack capabilities, including alerting, dashboards and drill-downs, and metrics discovery.

## Alerting[​](#alerting "Direct link to Alerting")

**What types of alerts does ClickStack support?**

ClickStack supports two types of alerts:

- [Search alerts](/docs/use-cases/observability/clickstack/alerts#search-alerts) — trigger notifications when the count of matching log or trace results within a time window exceeds or falls below a threshold.
- [Dashboard chart alerts](/docs/use-cases/observability/clickstack/alerts#dashboard-alerts) — trigger notifications when a metric plotted on a dashboard tile crosses a defined threshold.

Both alert types use static threshold conditions. For full details, see [Alerts](/docs/use-cases/observability/clickstack/alerts).

**Can I alert on complex metric conditions such as ratios, p95/p99, or multi-metric formulas?**

Ratios of two metrics, p95, and p99 values can be plotted on a dashboard tile using the [chart builder](/docs/use-cases/observability/clickstack/dashboards#navigate-chart-explorer) UI. You can then create threshold-based alerts on those tiles.

However, ClickStack does not currently support:

- Alerting on custom SQL queries for metrics.
- Multi-condition or multi-metric alert rules combined into a single alert.
- Dynamic or anomaly-detection-based alert conditions (anomaly detection is planned).

If you need to alert on a complex metric, the recommended approach is to build the visualization as a dashboard chart first, then attach a threshold alert to that chart.

**Can I use materialized views for alerting use cases?**

Materialized views are automatically used by ClickStack for alerts where applicable. However, materialized views are not currently supported on OpenTelemetry metrics data sources. For metrics, ClickStack works best with the default [ClickHouse OpenTelemetry metrics schema](/docs/use-cases/observability/clickstack/ingesting-data/schemas). For more on materialized views, see [Materialized views](/docs/use-cases/observability/clickstack/materialized_views).

## Dashboards and drill-downs[​](#dashboards-and-drill-downs "Direct link to Dashboards and drill-downs")

**Does ClickStack support parameterized dashboards or dashboard variables?**

ClickStack supports custom dropdown filters on dashboards, populated by data queried from ClickHouse. These filters allow you to dynamically scope all tiles on a dashboard to a specific value (e.g., a service name, environment, or host).

ClickStack does not currently support reusable dashboard variables in the style of Grafana template variables. Because ClickStack works exclusively with ClickHouse as its data source, drill-down and filtering capabilities can be provided natively without requiring a variable abstraction layer.

For details on creating dashboards and applying filters, see [Dashboards](/docs/use-cases/observability/clickstack/dashboards).

**What drill-down capabilities are available?**

ClickStack supports the following drill-down workflows:

- [Dashboard-level filtering](/docs/use-cases/observability/clickstack/dashboards#filter-dashboards) — Lucene or SQL filters and time range adjustments applied at the dashboard level propagate to all tiles.
- Custom dashboard filters — custom dashboards support explicit filter controls that are populated with values from your data, allowing users to scope all tiles without writing queries manually.
- Click-to-view events — clicking on data in a dashboard tile and selecting **View Events** navigates to the [Search](/docs/use-cases/observability/clickstack/search) page with relevant filters for log and trace data.
- [Prebuilt dashboard drill-downs](/docs/use-cases/observability/clickstack/dashboards#presets) — the [Services](/docs/use-cases/observability/clickstack/dashboards#services-dashboard), [ClickHouse](/docs/use-cases/observability/clickstack/dashboards#clickhouse-dashboard), and [Kubernetes](/docs/use-cases/observability/clickstack/dashboards#kubernetes-dashboard) dashboards include richer, built-in drill-down navigation across tabs.

Multi-level drill-downs from one custom dashboard to another (dashboard → dashboard → detail view) are not currently supported.

Note

The **View Events** drill-down works best with log and trace data. Because metrics data cannot be viewed on the [Search](/docs/use-cases/observability/clickstack/search) page, drilling down from a metrics tile will link to logs from around the selected time frame instead.

## Metrics discovery[​](#metrics-discovery "Direct link to Metrics discovery")

**Is there a UI for browsing and searching metrics?**

![Metric Attribute Explorer](/docs/assets/images/metrics-explorer-b203773929dad8afce789acbbcad87e8.png)

Metric names are discoverable via the metric name dropdown in the [chart builder](/docs/use-cases/observability/clickstack/dashboards#navigate-chart-explorer). When a metric is selected, the Metric Attribute Explorer panel displays the metric's description, units, and available attributes along with their values. This allows you to browse attributes and add them as filters or group-by fields directly from the panel.

There is not currently a dedicated metrics search page similar to the log search experience. Improving metric discovery is an active area of development.

**Is SQL-based discovery the intended long-term approach for metrics?**

No. While SQL queries can be used to discover metrics today, this is not the intended long-term approach. Improved metrics discovery tooling is actively being developed.

## Further reading[​](#further-reading "Direct link to Further reading")

- [Alerts](/docs/use-cases/observability/clickstack/alerts) — search alerts, dashboard chart alerts, and webhook integrations.
- [Dashboards](/docs/use-cases/observability/clickstack/dashboards) — creating visualizations, building dashboards, and applying filters.
- [Search](/docs/use-cases/observability/clickstack/search) — querying logs and traces with Lucene and SQL syntax.
- [Schemas](/docs/use-cases/observability/clickstack/ingesting-data/schemas) — OpenTelemetry data schemas for logs, traces, and metrics.
- [Architecture](/docs/use-cases/observability/clickstack/architecture) — ClickStack components and how they fit together.

- [Alerting](#alerting)- [Dashboards and drill-downs](#dashboards-and-drill-downs)- [Metrics discovery](#metrics-discovery)- [Further reading](#further-reading)

Was this page helpful?