内嵌于 ClickHouse

在 ClickHouse 服务器中使用内嵌式 ClickStack - ClickHouse 可观测性栈

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

​

适用场景

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

​

局限性

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

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

​

部署步骤

Docker

1. ​

   启动 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
   
2. ​

   打开 ClickStack UI

   在浏览器中打开 http://localhost:8123，然后点击 ClickStack。

   输入用户名 default 和密码 password，连接到本地实例。

3. ​

   创建数据源

   如果你已有 OpenTelemetry 表，ClickStack 会检测到它们并自动创建数据源。

   在全新安装中，系统会提示你创建数据源。请在 Table 字段中填写相应的表名 (例如 otel_logs) ，然后点击 Save New Source。

   如果你还没有数据，请参阅 摄取数据 了解可用选项。

Binary

1. ​

   启动 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
   
2. ​

   打开 ClickStack UI

   在浏览器中打开 http://localhost:8123，然后点击 ClickStack。系统会自动创建到本地实例的连接。

3. ​

   创建数据源

   如果你已有 OpenTelemetry 表，ClickStack 会检测到它们并自动创建数据源。

   如果你还没有数据，请参阅 摄取数据 了解可用选项。

​

后续步骤

如果你已准备好结束评估并进入下一阶段，可以考虑以下适用于生产环境的部署方式：

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