跳转到主内容
跳转到主内容

仅限本地模式

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

  • ClickHouse
  • HyperDX
  • OpenTelemetry (OTel) collector (在端口 4317 和 4318 上暴露 OTLP)
  • MongoDB (用于持久化应用状态)

但是，此版本的 HyperDX 未启用用户身份验证功能

适用场景​

  • 演示
  • 调试
  • 基于 HyperDX 的开发

部署步骤​


使用 Docker 部署​

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

docker run -p 8080:8080 clickhouse/clickstack-local:latest

访问 HyperDX UI​

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

系统不会提示您创建用户，因为在此部署模式下未启用身份验证。

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

创建登录

创建一个 Source，保留所有默认值，并将 Table 字段设置为 otel_logs。其他设置应会自动检测完成，此时您可以点击 Save New Source。

创建日志 Source

schema 选择：Map 与 JSON​

默认情况下，ClickStack 将属性存储为 Map(LowCardinality(String), String) 列。这是可观测性工作负载的推荐 schema。结合分桶化 Map 序列化以及 Map 键和值上的文本索引，它可以实现有选择的查找，而无需承担动态 JSON 子列为每个键带来的额外摄取开销。

JSON 类型的 schema 提供 Beta 版本，可用于评估属性键集合较小且稳定的工作负载。不建议将其作为默认选项。有关完整对比以及启用 JSON 支持所需的环境变量，请参见 Map 与 JSON 类型。