hyperdx/hyperdx-all-in-one

ClickStack 一体化可观测性部署镜像

镜像概述

该镜像为ClickHouse ClickStack的一体化部署方案，整合了ClickHouse数据库及可观测性相关工具（如数据收集、可视化、告警等组件），提供开箱即用的可观测性平台部署能力。旨在简化用户搭建可观测性基础设施的流程，无需手动配置多个独立组件，降低部署和运维门槛。

核心功能与特性

• 一站式可观测性解决方案：集成数据采集、存储、查询、可视化全流程组件，覆盖日志、指标、追踪等多类型可观测性数据处理需求。
• 预配置优化：内置针对可观测性场景优化的ClickHouse配置，包括预设表结构、索引策略及查询性能调优参数，适配典型可观测性数据特性。
• 简化部署流程：通过单一Docker镜像实现全组件一键部署，无需复杂的多服务编排或手动配置，缩短从部署到可用的时间。
• 灵活配置能力：支持通过环境变量自定义关键参数（如访问密码、数据保留策略等），适应不同场景下的个性化需求。

使用场景与适用范围

• 中小企业快速部署：适用于资源有限的中小企业，无需投入大量人力搭建复杂可观测性系统，快速实现基础监控能力。
• 开发与测试环境：供开发或测试团队在本地环境快速搭建可观测性平台，验证监控策略、告警规则及数据查询逻辑。
• 演示与POC场景：用于展示ClickHouse在可观测性领域的应用能力，或进行概念验证（POC），快速评估平台功能是否满足业务需求。

使用方法与配置说明

基本部署

通过以下命令可快速启动镜像：

bash
docker run -d --name clickstack-all-in-one -p 8123:8123 -p 9000:9000 -p 3000:3000 docker.xuanyuan.run/clickhouse/clickstack-all-in-one:latest

端口说明

持久化存储配置

为避免容器重启导致数据丢失，建议挂载持久化存储卷保存关键数据（如ClickHouse数据文件、配置文件等）：

bash
docker run -d --name clickstack-all-in-one \
  -p 8123:8123 -p 9000:9000 -p 3000:3000 \
  -v /path/to/host/clickhouse-data:/var/lib/clickhouse \
  -v /path/to/host/grafana-data:/var/lib/grafana \
  docker.xuanyuan.run/clickhouse/clickstack-all-in-one:latest

环境变量配置

支持通过环境变量调整核心配置参数，常用环境变量说明如下：

配置示例（自定义密码）：

bash
docker run -d --name clickstack-all-in-one \
  -p 8123:8123 -p 9000:9000 -p 3000:3000 \
  -e CLICKHOUSE_PASSWORD=SecurePass123 \
  -e GRAFANA_ADMIN_PASSWORD=GrafanaPass456 \
  -e DATA_RETENTION_DAYS=15 \
  docker.xuanyuan.run/clickhouse/clickstack-all-in-one:latest

部署验证

部署完成后，可通过以下方式验证服务状态：

1. ClickHouse HTTP接口验证：访问 http://<主机IP>:8123，返回 Ok. 表示接口正常。
2. Grafana界面访问：访问 http://<主机IP>:3000，使用配置的 GRAFANA_ADMIN_USER 和 GRAFANA_ADMIN_PASSWORD 登录。
3. ClickHouse客户端连接：通过容器内客户端连接验证数据库可用性：

   bash
   docker exec -it clickstack-all-in-one clickhouse-client -h localhost -u default --password <配置的CLICKHOUSE_PASSWORD>
   

注意事项

• 适用场景限制：该镜像适用于开发、测试及中小型生产环境，大规模或高可用性要求的生产环境建议采用ClickStack分布式架构部署。
• 存储要求：持久化存储路径需确保有足够磁盘空间，建议根据预期数据量规划存储容量，避免因空间不足导致服务异常。
• 安全加固：生产环境中必须修改默认密码（如 CLICKHOUSE_PASSWORD、GRAFANA_ADMIN_PASSWORD），并限制容器端口访问范围，增强系统安全性。