Apache HertzBeat Collector Docker 镜像文档

镜像概述与主要用途

Apache HertzBeat Collector 是 Apache HertzBeat 开源实时监控系统的核心组件，专为集群模式设计的独立部署采集器。作为 HertzBeat 架构的关键部分，其主要用途是扩展监控系统的采集能力，支持高性能集群监控、多网络隔离环境下的数据采集及云边协同，与 HertzBeat 服务端通信并执行监控数据采集任务，助力构建大规模、高可用的监控体系。

核心功能与特性

核心功能

• 高性能集群支持：支持水平扩展，通过多采集器集群分担监控任务，提升系统整体采集能力。
• 多网络隔离监控：适配复杂网络环境，可部署于不同网络分区，实现跨隔离网络的监控数据采集。
• 云边协同架构：支持云端与边缘节点协同，边缘侧部署采集器，实现边缘设备/服务的本地化监控与数据上报。
• 无代理采集：延续 HertzBeat 无代理（agentless）特性，无需在目标监控对象部署代理，通过协议（如 HTTP、SSH、SNMP 等）远程采集数据。
• 灵活配置：支持自定义身份标识、运行模式及服务端连接参数，适配多样化部署场景。

使用场景与适用范围

典型使用场景

• 大规模监控任务：当监控目标数量庞大（如数千节点、服务），单节点采集能力不足时，通过部署多个 Collector 实现负载分担。
• 跨网络环境监控：企业内网、DMZ 区、边缘网络等多隔离网络环境下，在各网络分区部署 Collector，实现全场景覆盖。
• 云边协同监控：云端部署 HertzBeat 服务端，边缘节点（如工厂、门店设备）部署 Collector，实现边缘数据本地化采集与云端统一管理。
• 高可用架构构建：通过 Collector 集群冗余部署，避免单点故障，保障监控系统持续稳定运行。

适用范围

• 需扩展监控能力的 HertzBeat 用户。
• 大规模分布式系统、云原生环境、边缘计算场景的监控需求。
• 多网络隔离环境下的跨区域监控任务。

使用方法与配置说明

前提条件

使用 Collector 前，需先完成以下准备：

1. 已部署并启动 Apache HertzBeat 服务端（版本需与 Collector 兼容）。
2. 确保 HertzBeat 服务端已开启集群模式 Netty 服务（默认端口 1158），且 Collector 可网络访问服务端。

Docker 快速启动

基础运行命令

shell
docker run -d \
  -e IDENTITY=custom-collector-name \
  -e MODE=public \
  -e MANAGER_HOST=127.0.0.1 \
  -e MANAGER_PORT=1158 \
  --name hertzbeat-collector \
  apache/hertzbeat-collector

命令参数说明

高级配置（可选）

挂载日志目录：将 Collector 日志持久化到宿主机，避免容器重建导致日志丢失。

shell
docker run -d \
  -e IDENTITY=collector-01 \
  -e MODE=public \
  -e MANAGER_HOST=192.168.1.100 \
  -e MANAGER_PORT=1158 \
  -v /opt/hertzbeat-collector/logs:/opt/hertzbeat-collector/logs \
  --name hertzbeat-collector \
  apache/hertzbeat-collector

自定义配置文件：挂载本地修改后的配置文件，覆盖容器内默认配置（适用于高级调优）。

shell
docker run -d \
  -e IDENTITY=collector-01 \
  -e MODE=public \
  -e MANAGER_HOST=192.168.1.100 \
  -e MANAGER_PORT=1158 \
  -v /opt/hertzbeat-collector/config/application.yml:/opt/hertzbeat-collector/config/application.yml \
  -v /opt/hertzbeat-collector/logs:/opt/hertzbeat-collector/logs \
  --name hertzbeat-collector \
  apache/hertzbeat-collector

Docker Compose 部署示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  hertzbeat-collector:
    image: apache/hertzbeat-collector
    container_name: hertzbeat-collector
    restart: always
    environment:
      - IDENTITY=collector-node-01
      - MODE=public
      - MANAGER_HOST=hertzbeat-server  # 替换为 HertzBeat 服务端实际 IP/域名
      - MANAGER_PORT=1158
    volumes:
      - ./logs:/opt/hertzbeat-collector/logs  # 本地日志目录挂载
      # - ./config/application.yml:/opt/hertzbeat-collector/config/application.yml  # 可选：自定义配置文件
    networks:
      - hertzbeat-network

networks:
  hertzbeat-network:
    driver: bridge

启动命令：

shell
docker-compose up -d

配置参数详解

环境变量（必填）

挂载卷（可选）

补充信息

• ***主页：hertzbeat.apache.org
• GitHub 仓库：github.com/apache/hertzbeat
• Docker Hub：docker.io/apache/hertzbeat-collector