嵌入到 ClickHouse 中

ClickStack 直接集成在 ClickHouse 服务器二进制可执行文件中。这意味着您可以在自己的 ClickHouse 实例上直接访问 ClickStack UI (HyperDX) ，而无需部署任何其他组件。此部署方式类似于公共演示站点 play-clickstack.clickhouse.com，但会在您自己的 ClickHouse 实例和数据之上运行。

适用场景

• 以最小配置体验 ClickStack
• 使用可观测性 UI 探索自己的 ClickHouse 数据
• 演示与评估

限制

此内嵌版本并非面向生产环境使用而设计。与适用于生产环境的 OSS 部署相比，缺少以下功能：

• 告警
• Dashboard 和 search 的持久化能力 —— 仪表板和已保存的搜索不会在不同会话之间保留
• 可自定义的查询设置
• 事件模式

部署步骤

Docker

启动 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，以连接到本地实例。

创建 Source

如果您已有 OpenTelemetry 表，ClickStack 会自动检测并创建相应的 Source。

在全新安装的环境中，系统会提示您创建一个 Source。将 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 的 Log Source：

设置	值
名称	Query Logs
数据库	system
表	query_log
时间戳列	event_time
默认 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。系统会自动创建与本地实例的连接。

创建 Source

如果您已有 OpenTelemetry 表，ClickStack 会自动检测并创建相应的 Source。

如果您尚无数据，请参阅 数据摄取 以了解可用选项。

后续步骤

如果您已经准备好从评估阶段迈向正式使用，可以考虑以下面向生产环境的部署方案：

• All-in-One — 单个容器包含所有组件，包括数据持久化和认证
• Docker Compose — 各组件以独立服务形式运行，便于获得更精细的控制
• Helm — 推荐用于生产环境中的 Kubernetes 部署
• Managed ClickStack — 由 ClickHouse Cloud 提供全托管服务