开始使用 ClickStack
Getting started with ClickStack is straightforward thanks to the availability of prebuilt Docker images. These images are based on the official ClickHouse Debian package and are available in multiple distributions to suit different use cases.
Local deployment
最简单的选项是单镜像分发,它将堆栈的所有核心组件捆绑在一起:
- HyperDX UI
- OpenTelemetry (OTel) collector
- ClickHouse
这个一体化镜像让您可以通过一条命令启动整个堆栈,非常适合测试、实验或快速本地部署。
Deploy stack with docker
以下命令将运行一个 OpenTelemetry collector(在端口 4317 和 4318 上)以及 HyperDX UI(在端口 8080 上)。
为了在容器重启之间保持数据和设置,用户可以修改上述 docker 命令以挂载路径 /data/db
、/var/lib/clickhouse
和 /var/log/clickhouse-server
。
例如:
Navigate to the HyperDX UI
访问 http://localhost:8080 来访问 HyperDX UI。
创建一个用户,提供符合复杂性要求的用户名和密码。

HyperDX 将自动连接到本地集群并为日志、跟踪、指标和会话创建数据源 - 让您能立即探索产品。
Explore the product
在堆栈部署后,尝试我们的一些相同数据集。
要继续使用本地集群:
- Example dataset - 从我们的公共演示加载示例数据集。诊断一个简单的问题。
- Local files and metrics - 加载本地文件并使用本地 OTel collector 在 OSX 或 Linux 上监控系统。
或者,您可以连接到一个演示集群,在那里您可以探索更大的数据集:
- Remote demo dataset - 在我们的演示 ClickHouse 服务中探索演示数据集。
Deploy with ClickHouse Cloud
用户可以针对 ClickHouse Cloud 部署 ClickStack,受益于完全托管的安全后端,同时保留对数据摄取、模式和可观察性工作流的完全控制。
Create a ClickHouse Cloud service
请遵循 getting started guide for ClickHouse Cloud 来创建服务。
Deploy with docker
打开终端并导出上面复制的凭据:
运行以下 docker 命令:
这将暴露一个 OpenTelemetry collector(在端口 4317 和 4318 上)和 HyperDX UI(在端口 8080 上)。
Create a ClickHouse Cloud connection
导航到 Team Settings
并点击 Edit
以获取 Local Connection
:

将连接重命名为 Cloud
并在单击 Save
之前填写后续表单与您的 ClickHouse Cloud 服务凭据:

Explore the product
在堆栈部署后,尝试我们的一些相同数据集。
- Example dataset - 从我们的公共演示加载示例数据集。诊断一个简单的问题。
- Local files and metrics - 加载本地文件并使用本地 OTel collector 在 OSX 或 Linux 上监控系统。
Local mode
本地模式是一种在不需要身份验证的情况下部署 HyperDX 的方式。
不支持身份验证。
此模式旨在用于快速测试、开发、演示以及调试用例,其中不需要身份验证和设置持久化。
Hosted version
您可以使用可在 play.hyperdx.io 中提供的本地模式托管版本。
Self-hosted version
Run with docker
自托管本地模式镜像预配置了 OpenTelemetry collector 和 ClickHouse 服务器。这使得从您的应用中获取遥测数据并在 HyperDX 中可视化变得简单,外部设置最少。要开始使用自托管版本,只需运行 Docker 容器并转发相应的端口:
您将不会被提示创建用户,因为本地模式不包括身份验证。
Complete connection credentials
要连接到您自己的外部 ClickHouse 集群,您可以手动输入连接凭据。
或者,若要快速探索产品,您还可以单击Connect to Demo Server来访问预加载的数据集,无需设置即可尝试 ClickStack。

如果连接到演示服务器,用户可以使用 demo dataset instructions 探索数据集。