ClickHouse/ClickStack

这是什么？

核心功能

• 01在同一界面中关联搜索日志、链路追踪、指标、会话回放和错误。
• 02支持属性搜索语法，也可在任意 ClickHouse 表结构上使用原生 SQL。
• 03无需复杂查询语言即可创建仪表盘和告警。
• 04支持日志与链路的实时追踪。
• 05原生兼容 OpenTelemetry，提供浏览器、Node.js 和 Python 的 SDK。
• 06提供终端界面和命令行工具访问 HyperDX 数据。

适用场景

• 从用户会话回放跳转到对应的后端日志和链路，定位线上错误。
• 在已有的 ClickHouse 集群上自托管可观测性系统。
• 监控从 HTTP 请求到数据库查询的应用性能。
• 通过命令行工具在脚本或 AI 智能体中查询遥测数据。

快速上手

1. 1

   使用 Docker 启动一体化 HyperDX 容器

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

   在浏览器中打开 http://localhost:8080 访问界面

使用前须知

• !测试建议至少 4GB 内存和 2 个 CPU 核心。
• !完整部署包含 ClickHouse、OpenTelemetry Collector 和 MongoDB，自托管需要一定运维投入。

收录于专题

标签

常见问题

ClickStack 是什么？

基于 ClickHouse 的开源可观测性平台，用于搜索和可视化日志、链路追踪、指标与会话回放。 HyperDX 是一个可观测性平台，帮助工程师通过搜索和可视化存储在 ClickHouse 集群中的日志与链路追踪数据，定位线上问题。它可以直接使用已有的 ClickHouse 表结构，并基于 OpenTelemetry 采集遥测数据，兼容标准 OpenTelemetry SDK 接入的应用。

ClickStack 可以免费使用吗？用的什么许可证？

ClickStack 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

ClickStack 还在维护吗？

活跃维护中。ClickStack 最近一次提交是在 2026年11月6日。

ClickStack 适合用来做什么？

从用户会话回放跳转到对应的后端日志和链路，定位线上错误。 在已有的 ClickHouse 集群上自托管可观测性系统。 监控从 HTTP 请求到数据库查询的应用性能。 通过命令行工具在脚本或 AI 智能体中查询遥测数据。

ClickStack 怎么安装和运行？

使用 Docker 启动一体化 HyperDX 容器: docker run -p 8080:8080 -p 4317:4317 -p 4318:4318 docker.hyperdx.io/hyperdx/hyperdx-all-in-one 在浏览器中打开 http://localhost:8080 访问界面

在哪里获取 ClickStack？

源代码和安装说明在 GitHub 上：https://github.com/ClickHouse/ClickStack