ClickStack 直接集成在 ClickHouse 服务器二进制文件中。这意味着你无需部署任何额外组件,即可从你的 ClickHouse 实例访问 ClickStack UI (HyperDX) 。这种部署方式类似于公开演示 play-clickstack.clickhouse.com,但它运行的是你自己的 ClickHouse 实例和数据。
适用场景
- 以最少配置试用 ClickStack
- 使用可观测性 UI 探索自己的 ClickHouse 数据
- 演示和评估
局限性
此嵌入式版本不适用于生产环境。与可用于生产环境的 OSS 部署相比,以下功能不可用:
部署步骤
启动 ClickHouse
拉取并运行 ClickHouse 服务器镜像,并设置密码:
docker run --rm -it -p 8123:8123 -e CLICKHOUSE_PASSWORD=password clickhouse/clickhouse-server:head-alpine打开 ClickStack UI
创建数据源
如果你已有 OpenTelemetry 表,ClickStack 会检测到它们并自动创建数据源。
在全新安装中,系统会提示你创建数据源。请在 Table 字段中填写相应的表名 (例如 otel_logs) ,然后点击 Save New Source。

如果你还没有数据,请参阅 摄取数据 了解可用选项。
启动 ClickHouse
下载并启动 ClickHouse:
curl https://clickhouse.com/ | sh可选:启用系统日志表
如果你想查看 ClickHouse 自身的内部日志和指标,请在启动服务器之前,先在当前工作目录中创建一个配置片段:
mkdir -p config.d && cat > config.d/query_logs.xml << 'EOF'
<clickhouse>
<query_log>
<database>system</database>
<table>query_log</table>
</query_log>
<query_thread_log>
<database>system</database>
<table>query_thread_log</table>
</query_thread_log>
<query_views_log>
<database>system</database>
<table>query_views_log</table>
</query_views_log>
<metric_log>
<database>system</database>
<table>metric_log</table>
</metric_log>
<asynchronous_metric_log>
<database>system</database>
<table>asynchronous_metric_log</table>
</asynchronous_metric_log>
</clickhouse>
EOF启用后,在打开 ClickStack 后,你可以创建一个指向 system.query_log 的 日志数据源:
| 设置 | 值 |
|---|---|
| Name | Query Logs |
| Database | system |
| Table | query_log |
| Timestamp Column | event_time |
| Default Select | event_time, query_kind, query, databases, tables, initial_user, projections, memory_usage, written_rows, read_rows, query_duration_ms |
启动服务器:
./clickhouse server打开 ClickStack UI
在浏览器中打开 http://localhost:8123,然后点击 ClickStack。系统会自动创建到本地实例的连接。
创建数据源
后续步骤
如果你已准备好从评估转向正式使用,可以考虑以下适用于生产环境的部署方式:
- All-in-One — 单容器方案,包含所有组件,并支持持久化和身份验证
- Docker Compose — 各组件独立部署,便于获得更高的控制度
- Helm — 推荐用于生产环境中的 Kubernetes 部署
- Managed ClickStack — 在 ClickHouse Cloud 上的全托管方案
