hertzbeat

免Agent、AI加持，一站式搞定全栈监控告警

HertzBeat 是一个 AI 驱动的下一代开源实时可观测性系统，专注于解决传统监控工具在易用性、告警准确性和智能化方面的不足。它无需 Agent，支持对网站、API、数据库、操作系统、中间件等数十种监控对象的直接探测，提供丰富的监控指标采集、可视化仪表盘、告警通知（支持钉钉、邮件、Webhook 等）以及基于 AI 的异常检测和根因分析能力。其核心能力包括：统一的监控配置界面、灵活的告警规则引擎、分布式部署支持、以及通过 AI 模型自动识别指标异常和关联分析，帮助运维和开发人员快速定位故障。项目采用 Java 技术栈，模块化设计，易于扩展，适合中小型团队快速搭建全栈可观测平台。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 7401

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队apache

所属国家

官网地址https://hertzbeat.apache.org

GitHubhttps://github.com/apache/hertzbeat

定价模式free

价格说明开源项目，Apache-2.0 许可证，可免费自行部署使用。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Java

技术栈/模型agent,ai,alerting,database,grafana,linux,llm,logs,metrics,monitor,monitoring,notifications,observability,prometheus,self-hosted,server,status,status-page,uptime,zabbix

GitHub 星标★ 7401

30天Star增速

HF 下载量

上线时间2022-02-04 00:00:00

最近更新2026-09-21 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：Docker 6 步

环境要求

Docker 环境（支持 x86/arm64 CPU）
源码方式需 maven3+ 与 java25、lombok
前端源码方式需 nodejs 与 pnpm
可选：下载发行包 apache-hertzbeat-xx-bin.tar.gz

安装与启动步骤

1Docker 一键启动

一条命令即可启动 HertzBeat 主服务，同时映射 1157（Web）和 1158（采集通信）端口，容器名设为 hertzbeat。
```
docker run -d -p 1157:1157 -p 1158:1158 --name hertzbeat apache/hertzbeat
```
2访问控制台登录

浏览器打开 http://localhost:1157 进入控制台，默认账号 admin，默认密码 hertzbeat，登录后建议修改密码。
3部署采集器集群

可选步骤。如需集群采集，再启动一个 collector 容器，用 IDENTITY 指定采集器唯一名称，MANAGER_HOST/PORT 指向主服务。
```
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
```
4发行包方式部署

从下载页获取 apache-hertzbeat-xx-bin.tar.gz，解压后可按需修改 hertzbeat/config/application.yml，再执行启动脚本（Windows 用 bin/startup.bat）。
```
./bin/startup.sh
```
5源码启动后端

本地调试需启动 hertzbeat-startup 后端；环境需 maven3+、java25、lombok，并在 IDE 中添加 VM 参数后运行该服务。
```
--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED
```
6源码启动前端

在 web-app 目录下先安装依赖再启动前端，需 nodejs 与 pnpm 环境，后端启动后再执行，访问 http://localhost:4200。
```
pnpm install
pnpm start
```

关键配置

配置项	必填	说明	示例
`IDENTITY`	否	采集器唯一标识名称，用于集群中区分节点	`custom-collector-name`
`MODE`	否	采集器运行模式，public 为集群，private 为云边协同	`public`
`MANAGER_HOST`	否	主 HertzBeat 服务所在 IP 地址	`127.0.0.1`
`MANAGER_PORT`	否	主 HertzBeat 服务端口，默认 1158	`1158`
`collector.dispatch.entrance.netty.enable`	否	发行包配置文件中开启 netty 入口	`true`

如何确认成功

浏览器访问 http://localhost:1157 能打开登录页，用 admin/hertzbeat 登录成功即启动完成；集群模式下仪表盘会显示新注册的采集器。

常见问题

Q：默认账号密码是什么？

A：Web 控制台默认账号 admin，默认密码 hertzbeat，源码方式访问端口为 4200，Docker 与发行包方式为 1157。

Q：需要额外安装数据库吗？

A：最简 Docker 命令未要求外部数据库；如需一次性安装 postgresql/mysql 与 victoria-metrics/iotdb/tdengine，可使用 script/docker-compose 部署脚本。

Q：如何在 Kubernetes 中部署？

A：README 提供 Helm chart 方式，安装 HertzBeat 集群，详细步骤参考 Artifact Hub 上的 hertzbeat 包。

Q：Oracle 和 DB2 监控能否用原生采集器？

A：不能。Oracle 与 DB2 依赖外部 JDBC 驱动，仍需使用 JVM 采集器包；MySQL、MariaDB、OceanBase 可用内置查询引擎。

Q：怎样接入多个采集器？

A：在目标机器下载对应 collector 包，配置 unique identity、mode、manager-host 与 manager-port 后启动，控制台仪表盘即可看到注册节点。

注意事项

Docker 启动需占用 1157 与 1158 两个端口，注意宿主机端口冲突
默认密码 admin/hertzbeat 应在首次登录后立即修改
collector 容器的 MANAGER_HOST 需填写主服务实际可访问的 IP，而非容器内部地址
修改 ext-lib 中的 JDBC 驱动后需重启采集器才会生效

核心亮点

无需安装Agent，通过HTTP/ICMP/JDBC等协议直接探测，部署成本低
内置AI异常检测和根因分析，减少误报并辅助定位问题
支持数十种主流监控对象，覆盖网站、数据库、中间件、云服务等

不足之处

AI能力依赖外部模型或规则，复杂场景下准确性待验证
文档/社区待观察，相比Prometheus等生态仍较小

适用场景

中小团队快速搭建统一监控告警平台
对网站和API进行可用性及性能实时监测
需要AI辅助异常检测和故障根因分析的运维场景

替代项目

Prometheus、Zabbix、Nightingale

项目介绍

hertzbeat 是基础设施领域的开源项目，由 apache 开发，2022 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（7,401）位列前 7%，在基础设施分类的 1,130 个项目里位列前 9%。

近 41 天，它的 GitHub 星标从 7,357 增加到 7,401，净增 44。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-21。Apache-2.0 许可证，可免费自行部署使用。

它主要面向的使用场景是：中小团队快速搭建统一监控告警平台。同类可对比的替代方案包括 Prometheus、Zabbix、Nightingale。

上一篇：MegaParse

下一篇：awesome-free-llm-apis