Repolode
ClickHouse

ClickHouse/ClickStack

Open-source observability platform for searching and visualizing logs, traces, metrics, session replays and errors on top of ClickHouse.

Open-source alternative to:DatadogKibanaNew Relic

Stars
9,993
Forks
517
Open issues
244
Last commit
24 hours ago

What is it?

HyperDX is an observability platform that helps engineers find the cause of production issues by searching and visualizing logs and traces stored in a ClickHouse cluster. It works with an existing ClickHouse schema and is built around OpenTelemetry for collecting telemetry, so it can be used with applications instrumented by standard OpenTelemetry SDKs.

The interface combines full-text search with a property search syntax such as level:err, with optional raw SQL. Users can build dashboards, set alerts, live tail logs and traces, and correlate session replays with backend data. It also covers application performance monitoring from HTTP requests to database queries.

HyperDX can be run as a single Docker container for local testing, deployed against an existing ClickHouse instance, or used with ClickHouse Cloud. A command-line tool, @hyperdx/cli, provides a terminal UI and scriptable access to the same data.

Key features

  • 01Search and correlate logs, traces, metrics, session replays and errors in one place.
  • 02Property search syntax with optional raw SQL on any ClickHouse schema.
  • 03Dashboards and alerts built without a complex query language.
  • 04Live tail for logs and traces.
  • 05Native OpenTelemetry ingestion with SDKs for browser, Node.js and Python.
  • 06Terminal UI and CLI for querying HyperDX data.

Use cases

  • Diagnosing production errors by jumping from a session replay to the backend logs and traces behind it.
  • Running a self-hosted observability stack on an existing ClickHouse cluster.
  • Monitoring application performance from HTTP requests down to database queries.
  • Querying telemetry from scripts or AI agents through the CLI.

Quick start

  1. 1

    Start the all-in-one HyperDX container with Docker

    docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.hyperdx.io/hyperdx/hyperdx-all-in-one
  2. 2

    Open http://localhost:8080 in your browser to access the UI

Things to know

  • Recommends at least 4GB of RAM and 2 cores for testing.
  • Full deployment bundles ClickHouse, OpenTelemetry Collector and MongoDB, so self-hosting takes operational effort.

In collections

Topics

FAQ

What is ClickStack?
Open-source observability platform for searching and visualizing logs, traces, metrics, session replays and errors on top of ClickHouse. HyperDX is an observability platform that helps engineers find the cause of production issues by searching and visualizing logs and traces stored in a ClickHouse cluster. It works with an existing ClickHouse schema and is built around OpenTelemetry for collecting telemetry, so it can be used with applications instrumented by standard OpenTelemetry SDKs.
Is ClickStack free to use? What license does it have?
ClickStack is open source under the MIT license. Check the license terms before using it in commercial products.
Is ClickStack still maintained?
Actively maintained. The last commit to ClickStack was on Nov 6, 2026.
What can I use ClickStack for?
Diagnosing production errors by jumping from a session replay to the backend logs and traces behind it. Running a self-hosted observability stack on an existing ClickHouse cluster. Monitoring application performance from HTTP requests down to database queries. Querying telemetry from scripts or AI agents through the CLI.
How do I install ClickStack?
Start the all-in-one HyperDX container with Docker: docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.hyperdx.io/hyperdx/hyperdx-all-in-one Open http://localhost:8080 in your browser to access the UI
Where can I get ClickStack?
The source code and installation instructions are on GitHub: https://github.com/ClickHouse/ClickStack

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects