RousselTMLEARNING

Article · ClickStack: from discovery to expertise

ClickStack architecture

1. What ClickStack is #

An integrated stack on ClickHouse.

The principle #

Available in: ✓ Open source ✓ Managed ClickStack open source · also offered managed in ClickHouse Cloud

ClickStack is the observability stack published by ClickHouse since 2025. It brings together three building blocks preconfigured to work together: an OpenTelemetry collector receiving logs, traces, metrics and sessions, ClickHouse storing them in optimized tables, and a UI (from HyperDX, acquired by ClickHouse in 2025) to search, correlate, visualize and alert.

ClickStack

Why ClickHouse? #

  • Compression: highly repetitive telemetry often compresses 10 to 20 times in columnar storage.
  • High cardinality: filtering by trace_id, user_id or pod costs no more than any other field, unlike label-based systems.
  • SQL: anything the UI does not do can be done in SQL, with joins to your business data.
  • One engine for logs, traces, metrics and sessions: one database to run and back up.

2. Components and data flow #

Who does what.

Architecture #

ClickStack architecture
ComponentRolePorts
OpenTelemetry collector (ClickStack distribution)receives OTLP, checks the ingestion key, batches and writes into ClickHouse4317 (gRPC), 4318 (HTTP), 13133 (health), 8888 (metrics), 24225 (Fluentd)
ClickHousestores events in otel_logs, otel_traces, otel_metrics_*, hyperdx_sessions8123 (HTTP), 9000 (native)
ClickStack UI (HyperDX)search, traces, sessions, dashboards, alerts; queries ClickHouse in SQL8080 (UI), 8000 (API), 4320 (OpAMP)
MongoDBapplication state: users, dashboards, alerts, saved searches (not telemetry data)27017

An event's journey #

  1. The application sends a span or log line as OTLP to the collector, with the ingestion key in the authorization header.
  2. The collector batches events and inserts them into ClickHouse (large batches, as ClickHouse likes them).
  3. The UI translates a search (level:err service:checkout) into an SQL query on the source table, and shows the result.
  4. Dashboards and alerts are stored in MongoDB; alerts are evaluated periodically in SQL.
Good to know : The UI also drives the collector through OpAMP (port 4320): it supplies its configuration, hence the collector's OPAMP_SERVER_URL variable.

3. Versions, licences and offerings #

What changed in 2026.

Landmarks #

  • Images: published as clickhouse/clickstack-* (all-in-one, collector…); the old docker.hyperdx.io/hyperdx/… and ghcr.io/hyperdxio/… names must be replaced.
  • Managed ClickStack (beta since February 2026): ClickHouse and the UI are hosted in ClickHouse Cloud, integrated with its console and access control; you only run the collector. No extra product to buy: billing follows ClickHouse Cloud infrastructure.
  • Embedded UI: since ClickHouse 26.2, the ClickStack UI ships inside the ClickHouse binary, handy for local experiments.
  • Licences: ClickHouse is Apache 2.0 licensed and the HyperDX UI is open source (MIT licence).

4. Strengths and limits #

Positioning it well.

Comparing #

AspectClickStackNote
Storage costlow (compression, object storage possible)depends on chosen retention
Full-text searchfast on large volumes“skip” indexes rather than inverted index
Correlationlogs, traces, metrics and sessions in one UIrequires propagated trace IDs
Operationsa ClickHouse database to size and monitorexcept with Managed ClickStack
Ecosystemyounger than Grafana or Elasticfeatures evolving fast

Commands to know #

Commands to know
  • docker run … clickhouse/clickstack-all-in-one:latest : whole stack in one container
  • curl http://localhost:13133 : collector health
  • clickhouse-client --query "SHOW TABLES" : tables created by the stack
  • OTEL_EXPORTER_OTLP_HEADERS=authorization=<clé> : ingestion key for SDKs

Sources #

Checked in November 2026: ClickStack evolves fast (Managed ClickStack is in beta), check the ClickHouse documentation before relying on a detail.

📄 ClickStack: architecture, components and offerings (ClickHouse, HyperDX, OpenTelemetry) →

My progress

  • ⏱ Estimated time : ≈ 4 min

Sign in to track your progress and take notes. Sign in

💬 Questions about this lesson

No questions yet: be the first to ask for help or share your configuration.

Ask a question about this lesson →

Recommended Articles

Installing and deploying ClickStack: all-in-one, Docker Compose, Helm and Managed ClickStack

Deploying ClickStack to fit the need: all-in-one container with persistence, Docker Compose and i...

Observability on ClickHouse: why a columnar database changes the game

Why more and more observability platforms store logs, traces and metrics in ClickHouse: columnar ...

SigNoz, ClickStack and ClickHouse best practices for observability

Best practices for observability on ClickHouse with SigNoz or ClickStack: OpenTelemetry instrumen...

Sending telemetry to ClickStack: OpenTelemetry SDKs, collectors, logs, Kubernetes and browser sessions

Feeding ClickStack: ingestion key, OpenTelemetry SDK variables, forwarding through an existing co...

Operating an observability platform on ClickHouse and choosing a tool

Operate ClickHouse for telemetry (replication, disks, merges, object storage, monitoring) and com...

Operating ClickHouse for ClickStack: sizing, replication, monitoring, security and backup

Running ClickHouse in production for observability: estimating volume and disk, replicating with ...

Alerts and dashboards in ClickStack

Building charts and dashboards in ClickStack, creating alerts on a search or a chart, sending the...

SigNoz: architecture and installation

SigNoz components (OpenTelemetry collector, ClickHouse, query service, interface, alerts), instal...

Exploring with the ClickStack UI: sources, search, traces, sessions and SQL

Using the ClickStack UI (HyperDX): data sources, property and full-text search syntax, SQL mode, ...

Support us

♥ SUPPORT US

Support RousselTM Learning

Courses, articles, labs and certificates stay free with no intrusive ads. A voluntary contribution, of any amount you choose, pays for hosting, lab environments and new content.

Contribute with PayPal Any amount · card or PayPal accountLearn more
QR code PayPal
Or scan this QR code with your phone

Thank you, every contribution counts!