跳到主要内容
跳到主要内容

仅限本地模式

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

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

但是，此版本的 HyperDX 未启用用户认证功能

适用场景​

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

部署步骤​


使用 Docker 部署​

本地模式会在 8080 端口上运行 HyperDX UI。

docker run -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx-local

访问 HyperDX UI​

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

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

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

创建登录

创建一个数据源，保留所有默认值，并将 Table 字段设置为 otel_logs。其他设置会自动检测完成，然后你就可以点击 Save New Source。

创建日志数据源

JSON 类型支持​

Beta feature. Learn more.
Beta 功能 - 尚未准备好用于生产环境

ClickStack 中的 JSON 类型支持目前为 Beta 功能。虽然 JSON 类型本身在 ClickHouse 25.3+ 中已经可以用于生产环境，但其在 ClickStack 中的集成仍在积极开发中，可能存在功能限制、未来变更或缺陷。

从 2.0.4 版本开始，ClickStack 对 JSON 类型 提供 Beta 支持。

关于此类型的优势，请参见 JSON 类型的优势。

要启用对 JSON 类型的支持，用户必须设置以下环境变量：

  • OTEL_AGENT_FEATURE_GATE_ARG='--feature-gates=clickhouse.json' - 在 OTel collector 中启用支持，确保使用 JSON 类型创建模式（schema）。
  • BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true - 在 HyperDX 应用中启用支持，允许查询 JSON 数据。

对于仅用于本地模式的镜像，用户只需要设置 BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true 参数，例如：

docker run -e BETA_CH_OTEL_JSON_SCHEMA_ENABLED=true -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx-local