介绍

Apache HertzBeat™ 是 AI 驱动的下一代开源实时观测系统。指标日志统一收集，告警一站分发，智能管控分析。无需 Agent，高性能集群，提供强大的自定义监控和状态页构建能力。

特点

• 集采集+分析+告警+通知为一体，HertzBeat AI 驱动下的新交互与功能，也内置 MCP Server 对外能力。
• 统一的指标平台，无需 Agent，兼容 Prometheus，支持应用服务，程序，数据库，缓存，操作系统，大数据，中间件，Web 服务器，云原生，网络，自定义等。
• 统一的日志平台，通过 OTLP 协议多日志源无缝对接上报。
• 统一的告警平台，内部告警与外部多种告警源集成接入，统一告警处理分析，灵活的实时与周期阈值规则，分组收敛，静默，抑制等。
• 统一的消息分发，告警平台处理后通过 邮件 Discord Slack Telegram 钉钉 微信 飞书 短信 Webhook Server酱 等方式分发通知。
• 将 Http, Jmx, Ssh, Snmp, Jdbc, Prometheus 等协议规范可配置化，只需配置模板 YML 就能自定义采集指标。您相信只需简单配置即可快速适配一款 K8s 或 Docker 等新的监控类型吗？
• 高性能，支持多采集器集群横向扩展，支持多隔离网络监控，云边协同。
• 提供强大的状态页构建能力，轻松向用户传达您产品服务的实时状态。

HertzBeat部署

方式一：Docker方式快速安装

1. docker 环境仅需一条命令即可开始

   docker run -d -p 1157:1157 -p 1158:1158 --name hertzbeat apache/hertzbeat

   或者使用 quay.io (若 dockerhub 网络链接超时)

   docker run -d -p 1157:1157 -p 1158:1158 --name hertzbeat quay.io/tancloud/hertzbeat

2. 浏览器访问 http://localhost:1157 即可开始，默认账号密码 admin/hertzbeat

3. 部署采集器集群(可选)

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

   • -e IDENTITY=custom-collector-name : 配置此采集器的唯一性标识符名称，多个采集器名称不能相同，建议自定义英文名称。
   • -e MODE=public : 配置运行模式(public or private), 公共集群模式或私有云边模式。
   • -e MANAGER_HOST=127.0.0.1 : 配置连接主HertzBeat服务的对外IP。
   • -e MANAGER_PORT=1158 : 配置连接主HertzBeat服务的对外端口，默认1158。

更多配置详细步骤参考 通过Docker方式安装HertzBeat

方式二：通过安装包安装

1. 下载您系统环境对应的安装包hertzbeat-xx.tar.gz Download Page

2. 配置 HertzBeat 的配置文件 hertzbeat/config/application.yml(可选)

3. 部署启动 $ ./bin/startup.sh 或 bin/startup.bat

4. 浏览器访问 http://localhost:1157 即可开始，默认账号密码 admin/hertzbeat

5. 部署采集器集群(可选)

   • 下载您系统环境对应采集器安装包hertzbeat-collector-xx.tar.gz到规划的另一台部署主机上 Download Page

   • 配置采集器的配置文件 hertzbeat-collector/config/application.yml 里面的连接主HertzBeat服务的对外IP，端口，当前采集器名称(需保证唯一性)等参数 identity mode (public or private) manager-host manager-port

     collector:
       dispatch:
         entrance:
           netty:
             enabled: true
             identity: ${IDENTITY:}
             mode: ${MODE:public}
             manager-host: ${MANAGER_HOST:127.0.0.1}
             manager-port: ${MANAGER_PORT:1158}
     

   • 启动 $ ./bin/startup.sh 或 bin/startup.bat

   • 浏览器访问主HertzBeat服务 http://localhost:1157 查看概览页面即可看到注册上来的新采集器

更多配置详细步骤参考 通过安装包安装HertzBeat

方式三：本地代码启动

1. 此为前后端分离项目，本地代码调试需要分别启动后端工程hertzbeat-startup和前端工程web-app
2. 后端：需要maven3+, java17和lombok环境，修改YML配置信息并启动hertzbeat-startup服务
3. 前端：需要nodejs npm angular-cli环境，待本地后端启动后，在web-app目录下启动 ng serve --open
4. 浏览器访问 http://localhost:4200 即可开始，默认账号密码 admin/hertzbeat

详细步骤参考 参与贡献之本地代码启动

方式四：Docker-Compose 统一安装 hertzbeat+postgresql+tsdb

通过 docker-compose部署脚本 一次性把 postgresql/mysql 数据库, victoria-metrics/iotdb/tdengine 时序数据库和 hertzbeat 安装部署。

详细步骤参考 docker-compose部署方案

方式五：Kubernetes Helm Charts 部署 hertzbeat+collector+postgresql+tsdb

通过 Helm Chart 一次性将 HertzBeat 集群组件部署到 Kubernetes 集群中。

详细步骤参考 Artifact Hub