holoinsight/server

HoloInsight Server 镜像文档

镜像概述

HoloInsight Server是HoloInsight可观测性平台的核心服务组件，负责接收、处理、存储和分析来自各类数据源的监控指标、日志和追踪数据，提供统一的监控视图和告警能力，帮助用户实时掌握系统运行状态并快速定位问题。作为平台的中枢节点，其集成了数据处理引擎、告警系统和可视化模块，支持与HoloInsight Agent等组件协同工作，构建完整的可观测性解决方案。

核心功能与特性

数据处理与集成

• 多源数据采集：支持Prometheus、Telegraf、Filebeat等主流采集器接入，兼容Metrics（指标）、Logs（日志）、Traces（追踪）等多类型数据
• 实时流处理：内置高吞吐数据处理引擎，支持指标聚合、过滤、标签转换等实时计算能力，处理延迟低至毫秒级
• 数据标准化：提供统一的数据模型，支持自定义数据转换规则，实现多源数据格式归一化

监控与告警

• 动态告警管理：支持静态阈值、动态基线、同比环比、异常检测等多种告警策略，支持告警级别定义与升级规则
• 多渠道通知：集成邮件、短信、钉钉、Slack等告警通知渠道，支持告警静默期与抑制规则配置
• 指标查询分析：提供PromQL兼容的查询接口，支持复杂指标计算与历史数据回溯分析

系统与扩展性

• 高可用架构：支持集群部署模式，通过一致性哈希实现负载均衡，具备故障自动转移能力，保障服务连续性
• 多租户隔离：基于租户ID实现数据与配置隔离，支持资源配额管理，满足多团队共享平台需求
• 插件化扩展：支持通过插件扩展数据源适配、数据处理逻辑和告警渠道，兼容社区生态插件

使用场景与适用范围

分布式系统监控

适用于微服务、云原生、容器化等分布式架构，可监控服务调用链路、节点资源使用率、应用性能指标，帮助定位跨服务依赖问题。

云原生环境观测

深度支持Kubernetes集群，可采集Pod、Node、Service等资源指标，结合容器日志与事件数据，实现云原生环境全栈可观测。

业务与技术指标融合

支持整合业务系统自定义指标（如订单量、支付成功率）与技术指标（如响应时间、错误率），构建业务-技术联动的监控体系。

DevOps与SRE支撑

为开发、测试、运维团队提供统一的监控平台，支持告警分级响应、故障演练验证、性能瓶颈分析，提升团队协作效率。

使用方法与配置说明

快速启动（Docker Run）

需提前准备数据库环境（MySQL/PostgreSQL）及时序数据库（InfluxDB/Prometheus），单节点快速启动命令如下：

bash
docker run -d \
  --name holoinsight-server \
  -p 8080:8080 \  # Web控制台与API端口
  -p 9090:9090 \  # 指标数据接收端口
  -e DB_TYPE=mysql \
  -e DB_HOST=192.168.1.100 \
  -e DB_PORT=3306 \
  -e DB_USER=holo_user \
  -e DB_PASSWORD=holo_pass \
  -e DB_NAME=holoinsight \
  -e TSDB_TYPE=influxdb \
  -e TSDB_HOST=192.168.1.101 \
  -e TSDB_PORT=8086 \
  -e TSDB_TOKEN=influxdb-auth-token \
  -e LOG_LEVEL=info \
  -v /data/holoinsight:/var/lib/holoinsight \  # 持久化存储目录
  holoinsight/server:latest

集群部署（Docker Compose）

通过Docker Compose快速部署包含依赖组件的完整环境：

yaml
version: '3.8'
services:
  # 数据库服务
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root_pass
      MYSQL_DATABASE: holoinsight
      MYSQL_USER: holo_user
      MYSQL_PASSWORD: holo_pass
    volumes:
      - mysql-data:/var/lib/mysql
    restart: always
    networks:
      - holo-net

  # 时序数据库
  influxdb:
    image: influxdb:2.7
    environment:
      DOCKER_INFLUXDB_INIT_MODE: setup
      DOCKER_INFLUXDB_INIT_USERNAME: influx_admin
      DOCKER_INFLUXDB_INIT_PASSWORD: influx_pass
      DOCKER_INFLUXDB_INIT_ORG: holo_org
      DOCKER_INFLUXDB_INIT_BUCKET: holo_metrics
      DOCKER_INFLUXDB_INIT_RETENTION: 30d
    volumes:
      - influxdb-data:/var/lib/influxdb2
    restart: always
    networks:
      - holo-net

  # HoloInsight Server节点1
  holo-server-1:
    image: holoinsight/server:latest
    depends_on:
      - mysql
      - influxdb
    ports:
      - "8080:8080"
      - "9090:9090"
    environment:
      SERVER_PORT: 8080
      METRIC_PORT: 9090
      DB_TYPE: mysql
      DB_HOST: mysql
      DB_PORT: 3306
      DB_USER: holo_user
      DB_PASSWORD: holo_pass
      DB_NAME: holoinsight
      TSDB_TYPE: influxdb
      TSDB_HOST: influxdb
      TSDB_PORT: 8086
      TSDB_ORG: holo_org
      TSDB_BUCKET: holo_metrics
      TSDB_TOKEN: ${INFLUXDB_TOKEN}  # 从influxdb容器日志获取初始化token
      LOG_LEVEL: info
      CLUSTER_NODE_ID: node-1
      CLUSTER_PEERS: node-1,node-2  # 集群节点标识列表
    volumes:
      - holo-data-1:/var/lib/holoinsight
    restart: always
    networks:
      - holo-net

  # HoloInsight Server节点2（集群扩展）
  holo-server-2:
    image: holoinsight/server:latest
    depends_on:
      - mysql
      - influxdb
    ports:
      - "8081:8080"
      - "9091:9090"
    environment:
      SERVER_PORT: 8080
      METRIC_PORT: 9090
      # 数据库及时序数据库配置同node-1
      DB_HOST: mysql
      TSDB_HOST: influxdb
      LOG_LEVEL: info
      CLUSTER_NODE_ID: node-2
      CLUSTER_PEERS: node-1,node-2
    volumes:
      - holo-data-2:/var/lib/holoinsight
    restart: always
    networks:
      - holo-net

networks:
  holo-net:
    driver: bridge

volumes:
  mysql-data:
  influxdb-data:
  holo-data-1:
  holo-data-2:

核心配置参数说明

HoloInsight Server支持通过环境变量或挂载配置文件（/etc/holoinsight/application.yml）进行配置，关键环境变量如下表：

服务验证与访问

1. 健康检查：访问 http://<server-ip>:8080/actuator/health，返回 {"status":"UP"} 表示服务正常
2. 控制台访问：通过 http://<server-ip>:8080 访问Web控制台，默认账号密码：admin/admin（首次登录需修改密码）
3. 数据接入验证：配置HoloInsight Agent采集数据后，在控制台"指标浏览"页面查看是否有数据流入

注意事项

• 生产环境建议采用集群部署模式，至少2节点以保障高可用
• 时序数据库需根据数据量规划存储策略（如数据保留期、分片规则）
• 首次部署需执行数据库初始化脚本，容器启动时会自动检测并执行初始化
• 敏感配置（如数据库密码）建议通过Docker Secrets或环境变量注入工具管理，避免明文暴露