HyperDX项目部署指南：从零开始搭建日志分析平台

HyperDX项目部署指南：从零开始搭建日志分析平台

【免费下载链接】hyperdx Resolve production issues, fast. An open source observability platform unifying session replays, logs, metrics, traces and errors. 项目地址: https://gitcode.com/gh_mirrors/hy/hyperdx

项目概述

HyperDX是一款专为工程师设计的日志与追踪数据分析平台，它能够帮助开发团队快速定位生产环境中的问题。该平台的主要优势在于能够轻松地在ClickHouse集群上进行日志搜索和可视化操作，类似于Kibana在Elasticsearch生态中的角色，但专为ClickHouse优化设计。

部署方案选择

HyperDX提供三种主要部署方式，适用于不同场景：

1. 自带ClickHouse集群部署

适用场景：已有ClickHouse生产环境，需要集成日志分析能力

部署步骤：

1. 准备MongoDB实例用于存储用户数据、仪表板配置等信息
2. 运行以下Docker命令启动HyperDX服务：

docker run -e MONGO_URI=mongodb://YOUR_MONGODB_URI -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx:2-beta

关键配置项：

• MONGO_URI：必须设置为有效的MongoDB连接字符串
• EXPRESS_SESSION_SECRET：生产环境必须设置的安全密钥，建议使用强随机字符串
• FRONTEND_URL：自定义前端访问地址

注意事项：

• 服务启动后需通过8080端口访问Web界面完成ClickHouse连接配置
• 生产环境务必设置会话密钥增强安全性

2. 一体化Docker Compose部署

适用场景：全新环境快速搭建完整解决方案

部署流程：

1. 获取项目代码
2. 执行以下命令启动完整服务：

docker compose up -d

包含组件：

• ClickHouse数据库
• OpenTelemetry收集器
• HyperDX主服务
• MongoDB实例

安全建议：

• 生产环境应仅暴露必要的OTel收集器和API端口
• 必须设置EXPRESS_SESSION_SECRET环境变量
• 注意Docker端口映射会绕过常规防火墙规则

3. 本地开发模式

适用场景：开发调试环境快速搭建

快速启动：

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

特点：

• 集成OpenTelemetry收集器
• 内置ClickHouse和MongoDB
• 无认证机制
• 配置不持久化（适合临时使用）

生产环境部署建议

1. 安全配置：务必设置强会话密钥，防止会话劫持
2. 网络隔离：合理配置网络策略，仅开放必要端口
3. 资源规划：根据日志量预估ClickHouse集群规模
4. 监控配置：对HyperDX服务本身建立监控机制
5. 备份策略：定期备份MongoDB中的重要配置数据

常见问题排查

1. 连接问题：检查ClickHouse网络连通性和认证配置
2. 性能问题：优化ClickHouse表结构和索引设计
3. 存储问题：监控ClickHouse磁盘使用情况，合理设置TTL

通过以上部署方案，团队可以根据实际需求选择最适合的方式快速搭建HyperDX日志分析平台，提升生产环境问题排查效率。

【免费下载链接】hyperdx Resolve production issues, fast. An open source observability platform unifying session replays, logs, metrics, traces and errors. 项目地址: https://gitcode.com/gh_mirrors/hy/hyperdx