内嵌于 ClickHouse

ClickStack 直接集成在 ClickHouse 服务器二进制文件中。这意味着你无需部署任何额外组件，即可从你的 ClickHouse 实例访问 ClickStack UI (HyperDX) 。这种部署方式类似于公开演示 play-clickstack.clickhouse.com，但它运行的是你自己的 ClickHouse 实例和数据。

适用场景

以最少配置试用 ClickStack
使用可观测性 UI 探索自己的 ClickHouse 数据
演示和评估

局限性

此嵌入式版本不适用于生产环境。与可用于生产环境的 OSS 部署相比，以下功能不可用：

告警
仪表盘和搜索持久化——仪表盘和保存的搜索不会在不同会话间保留
可自定义的查询设置
事件模式

部署步骤

Docker
Binary

启动 ClickHouse

拉取并运行 ClickHouse 服务器镜像，并设置密码：

docker run --rm -it -p 8123:8123 -e CLICKHOUSE_PASSWORD=password clickhouse/clickhouse-server:head-alpine

无密码运行如果你希望在不使用密码的情况下运行，则必须显式启用默认访问管理：

docker run --rm -it -p 8123:8123 -e CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT=1 clickhouse/clickhouse-server:head-alpine

打开 ClickStack UI

在浏览器中打开 http://localhost:8123，然后点击 ClickStack。输入用户名 default 和密码 password，连接到本地实例。

创建数据源

如果你已有 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。系统会自动创建到本地实例的连接。

创建数据源

如果你已有 OpenTelemetry 表，ClickStack 会检测到它们并自动创建数据源。如果你还没有数据，请参阅摄取数据了解可用选项。

后续步骤

如果你已准备好从评估转向正式使用，可以考虑以下适用于生产环境的部署方式：

All-in-One — 单容器方案，包含所有组件，并支持持久化和身份验证
Docker Compose — 各组件独立部署，便于获得更高的控制度
Helm — 推荐用于生产环境中的 Kubernetes 部署
Managed ClickStack — 在 ClickHouse Cloud 上的全托管方案

功能特性

指南

适用场景

局限性

部署步骤

后续步骤

​适用场景

​局限性

​部署步骤

​后续步骤

适用场景

局限性

部署步骤

后续步骤