hyperdx/hyperdx-local

HyperDX 本地部署镜像

概述

该Docker镜像提供了HyperDX可观测性平台的本地部署模式，基于ClickHouse数据库构建，旨在为开发和测试环境提供完整的可观测性解决方案，包括日志收集、指标监控和分布式追踪功能。

核心功能

• 集成ClickHouse数据库，提供高效的数据存储和查询能力
• 支持多源日志收集和集中式管理
• 实时指标监控和可视化
• 分布式追踪功能，支持OpenTelemetry标准
• 简化的本地部署流程，无需复杂的基础设施配置

适用场景

• 开发环境中的应用可观测性测试
• 小型团队或项目的本地监控解决方案
• 可观测性相关功能的原型验证
• 学习和评估HyperDX平台的功能特性

使用方法

基本部署

使用以下命令启动本地模式的HyperDX服务：

bash
docker run -d -p 8080:8080 docker.xuanyuan.run/hyperdxio/hyperdx-local:latest

持久化存储

为确保数据持久化，可挂载本地目录：

bash
docker run -d \
  -p 8080:8080 \
  -v hyperdx_data:/var/lib/clickhouse \
  docker.xuanyuan.run/hyperdxio/hyperdx-local:latest

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  hyperdx:
    image: docker.xuanyuan.run/hyperdxio/hyperdx-local:latest
    ports:
      - "8080:8080"
    volumes:
      - hyperdx_data:/var/lib/clickhouse
    environment:
      - LOG_LEVEL=info
      - HTTP_PORT=8080

volumes:
  hyperdx_data:

启动服务：

bash
docker-compose up -d

配置参数

环境变量

访问界面

服务启动后，通过以下URL访问HyperDX Web界面：

• Web UI: http://localhost:8080
• API端点: http://localhost:8080/api

注意事项

• 该镜像仅适用于开发和测试环境，不适用于生产环境
• 默认配置未启用身份验证，请勿暴露在公共网络中
• 如需更高性能或生产部署，请参考官方的分布式部署指南
• 详细文档和最新更新请访问: https://github.com/hyperdxio/hyperdx/blob/main/LOCAL.md

数据持久化

使用Docker卷hyperdx_data存储ClickHouse数据，确保容器重启后数据不丢失。如需备份数据，可导出该卷内容或使用ClickHouse的备份功能。