仅使用本地模式

以纯本地模式部署 ClickStack - ClickHouse 可观测性技术栈

与一体化镜像类似，这个完整的 Docker 镜像集成了所有 ClickStack 组件：

• ClickHouse
• HyperDX
• OpenTelemetry (OTel) 收集器 (通过端口 4317 和 4318 提供 OTLP)
• MongoDB (用于持久化应用状态)

不过，此 HyperDX 发行版已禁用用户身份验证功能

​

适用场景

• 演示
• 调试
• 使用 HyperDX 的开发场景

​

部署步骤

1. ​

   使用 Docker 部署

   本地模式会在 8080 端口部署 HyperDX UI。

   docker run -p 8080:8080 clickhouse/clickstack-local:latest
   
2. ​

   访问 HyperDX UI

   访问 http://localhost:8080 即可打开 HyperDX UI。

   你不会被提示创建用户，因为此部署模式未启用身份验证。

   连接到你自己的外部 ClickHouse 集群，例如 ClickHouse Cloud。

   创建一个数据源，保留所有默认值，并在 Table 字段中填入 otel_logs。其他设置应会自动检测，你可以直接点击 Save New Source。

​

schema 选择：Map 与 JSON

默认情况下，ClickStack 将属性存储为 Map(LowCardinality(String), String) 列。这是可观测性 workloads 推荐使用的 schema。结合 bucketed map serialization 以及针对 map 键和值的文本索引，它可以实现有针对性的 lookup，同时避免动态 JSON 子列逐键摄取带来的额外开销。

JSON 类型的 schema 也已提供，目前处于 Beta 阶段，适合在属性键集合较小且稳定的 workloads 上进行评估。不建议将其作为默认选项。有关完整对比以及启用 JSON 支持所需的环境变量，请参见 Map vs JSON type。