ITADN · 发现全球开源项目

Readme: English | 中文 | 日本語

主页: hertzbeat.apache.org 邮箱: 发送邮件至 dev-subscribe@hertzbeat.apache.org 以订阅邮件列表

🎡 简介

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

特性

将采集 + 分析 + 告警 + 通知集成到一个平台中，在 HertzBeat AI 下提供新的 AI 驱动交互和功能，并内置 MCP Server 能力。
统一的指标平台，无代理，兼容 Prometheus，支持应用服务、程序、数据库、缓存、操作系统、大数据、中间件、Web 服务器、云原生、网络、自定义监控等。
统一的日志平台，通过 OTLP 协议无缝集成多种日志源进行上报。
统一的告警平台，集成内部告警与各种外部告警源，统一的告警处理和分析，灵活的实时和周期性阈值规则，分组收敛、静默、抑制等。
统一的消息分发，由告警平台处理的告警通过 Email Discord Slack Telegram DingTalk WeChat FeiShu SMS Webhook ServerChan 等方式进行分发。
使 Http, Jmx, Ssh, Snmp, Jdbc, Prometheus 等协议可配置，允许您仅通过在线配置模板 YML 文件来采集任何指标。想象一下，仅通过 HertzBeat 在线配置即可快速适应 K8s 或 Docker 等新的监控类型。
高性能，支持多采集器集群的水平扩展、多隔离网络监控和云边协同。
提供强大的状态页面构建能力，轻松向用户传达服务的实时状态。

HertzBeat 的统一平台、AI 智能、强大的定制化能力、多类型支持、高性能以及易于扩展的特性，旨在帮助用户快速便捷地实现可观测性需求。

🥐 架构

HertzBeat

🐕 快速开始

如果您希望在本地部署 HertzBeat，请参阅以下部署文档以获取说明。

🍞 安装 HertzBeat

HertzBeat 支持通过源码、docker 或安装包进行安装，cpu 支持 x86/arm64。

1：通过 docker 快速安装

只需一条命令即可开始

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

访问 http://localhost:1157 以开始，默认账户：admin/hertzbeat

部署采集器集群（可选）

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 或 private），public 集群或 private 云边。
- -e MANAGER_HOST=127.0.0.1 : 设置主 hertzbeat 服务器 IP。
- -e MANAGER_PORT=1158 : 设置主 hertzbeat 服务器端口，默认 1158。

详细配置请参考 Install HertzBeat via Docker

2：通过安装包安装

Download the release package apache-hertzbeat-xx-bin.tar.gz Download
Configure the HertzBeat configuration yml file hertzbeat/config/application.yml (optional)
Run command $ ./bin/startup.sh or bin/startup.bat
Access http://localhost:1157 to start, default account: admin/hertzbeat
Deploy collector clusters (Optional)
- Download the release package apache-hertzbeat-collector-xx-bin.tar.gz (JVM collector) or the native collector package for your platform, such as apache-hertzbeat-collector-native-xx-linux-amd64-bin.tar.gz or apache-hertzbeat-collector-native-xx-windows-amd64-bin.zip, to the new machine Download
- Configure the collector configuration yml file hertzbeat-collector/config/application.yml: unique identity name, running mode (public or private), hertzbeat manager-host, hertzbeat 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}
```
- If you do not provide JDBC drivers in ext-lib, MySQL, MariaDB, and OceanBase can use the built-in query engine and run on the native collector package as well. TiDB follows the same rule for its SQL query metric set.
- If mysql-connector-j is present in ext-lib, the built-in server collector or JVM collector automatically prefers JDBC after restart for MySQL, MariaDB, and OceanBase. TiDB follows the same rule for its SQL query metric set, while its HTTP metrics are unchanged. Oracle and DB2 still require the JVM collector package because they depend on external JDBC drivers.
- Run $ ./bin/startup.sh or bin/startup.bat for the JVM collector package. Run $ ./bin/startup.sh for Linux or macOS native collector packages, and bin\\startup.bat for the Windows native collector package.
- Access http://localhost:1157 and you will see the registered new collector in dashboard

详细配置请参考通过软件包安装 HertzBeat

3：通过源代码启动

本地源码调试需要启动后端项目 hertzbeat-startup 和前端项目 web-app。
后端：需要 maven3+, java25, lombok, 在 IDE 中添加 VM 选项：--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED, 然后启动 hertzbeat-startup 服务。
Web：需要 nodejs 和 pnpm 环境，在后端启动后，在 web-app 目录中运行 pnpm install 然后 pnpm start。
访问 http://localhost:4200 开始，默认账号：admin/hertzbeat

详细步骤请参考 CONTRIBUTING

4：通过 Docker-compose 安装所有组件（hertzbeat+postgresql+tsdb）

通过 docker-compose 部署脚本一次性安装 postgresql/mysql 数据库、victoria-metrics/iotdb/tdengine 数据库以及 hertzbeat。

详细步骤请参考 Install via Docker-Compose

5: 通过 kubernetes helm charts 安装所有组件（hertzbeat+collector+postgresql+tsdb）

通过 Helm chart 在 Kubernetes 集群中安装 HertzBeat 集群。

详细步骤请参考 Artifact Hub

HAVE FUN

✨ Contributors

感谢这些优秀的人，欢迎加入我们： Contributor Guide

  <td align="center" valign="top" width="14.28%"><a href="https://github.com/xiaohe428"><img src="https://avatars.githubusercontent.com/u/99130317?v=4?s=100" width="100px;" alt="xiaohe428"/><br /><sub><b>xiaohe428</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=xiaohe428" title="Code">💻</a> <a href="https://github.com/apache/hertzbeat/commits?author=xiaohe428" title="Documentation">📖</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/baiban114"><img src="https://avatars.githubusercontent.com/u/59152619?v=4?s=100" width="100px;" alt="TableRow"/><br /><sub><b>TableRow</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=baiban114" title="Documentation">📖</a> <a href="https://github.com/apache/hertzbeat/commits?author=baiban114" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/ByteIDance"><img src="https://avatars.githubusercontent.com/u/100207562?v=4?s=100" width="100px;" alt="ByteIDance"/><br /><sub><b>ByteIDance</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=ByteIDance" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/mangel2002"><img src="https://avatars.githubusercontent.com/u/9348020?v=4?s=100" width="100px;" alt="Jangfe"/><br /><sub><b>Jangfe</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=mangel2002" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/zqr10159"><img src="https://avatars.githubusercontent.com/u/30048352?v=4?s=100" width="100px;" alt="zqr10159"/><br /><sub><b>zqr10159</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=zqr10159" title="Documentation">📖</a> <a href="https://github.com/apache/hertzbeat/commits?author=zqr10159" title="Code">💻</a> <a href="#blog-zqr10159" title="Blogposts">📝</a> <a href="https://github.com/apache/hertzbeat/issues?q=author%3Azqr10159" title="Bug reports">🐛</a> <a href="https://github.com/apache/hertzbeat/commits?author=zqr10159" title="Tests">⚠️</a> <a href="#design-zqr10159" title="Design">🎨</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/vinci-897"><img src="https://avatars.githubusercontent.com/u/55838224?v=4?s=100" width="100px;" alt="vinci"/><br /><sub><b>vinci</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=vinci-897" title="Code">💻</a> <a href="https://github.com/apache/hertzbeat/commits?author=vinci-897" title="Documentation">📖</a> <a href="#design-vinci-897" title="Design">🎨</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/js110"><img src="https://avatars.githubusercontent.com/u/51191863?v=4?s=100" width="100px;" alt="js110"/><br /><sub><b>js110</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=js110" title="Code">💻</a></td>
</tr>
<tr>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/JavaLionLi"><img src="https://avatars.githubusercontent.com/u/31852897?v=4?s=100" width="100px;" alt="CrazyLionLi"/><br /><sub><b>CrazyLionLi</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=JavaLionLi" title="Documentation">📖</a></td>
  <td align="center" valign="top" width="14.28%"><a href="http://www.banmajio.com"><img src="https://avatars.githubusercontent.com/u/53471385?v=4?s=100" width="100px;" alt="banmajio"/><br /><sub><b>banmajio</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=banmajio" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://suder.fun"><img src="https://avatars.githubusercontent.com/u/69955165?v=4?s=100" width="100px;" alt="topsuder"/><br /><sub><b>topsuder</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=topsuder" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/richar2022"><img src="https://avatars.githubusercontent.com/u/129016397?v=4?s=100" width="100px;" alt="richar2022"/><br /><sub><b>richar2022</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=richar2022" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/fcb-xiaobo"><img src="https://avatars.githubusercontent.com/u/60566194?v=4?s=100" width="100px;" alt="fcb-xiaobo"/><br /><sub><b>fcb-xiaobo</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=fcb-xiaobo" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/wenkyzhang"><img src="https://avatars.githubusercontent.com/u/13983669?v=4?s=100" width="100px;" alt="wenkyzhang"/><br /><sub><b>wenkyzhang</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=wenkyzhang" title="Documentation">📖</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/ZangJuxy"><img src="https://avatars.githubusercontent.com/u/71380295?v=4?s=100" width="100px;" alt="ZangJuxy"/><br /><sub><b>ZangJuxy</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=ZangJuxy" title="Documentation">📖</a></td>
</tr>
<tr>

  <td align="center" valign="top" width="14.28%"><a href="https://github.com/Mr-zhou315"><img src="https://avatars.githubusercontent.com/u/10276100?v=4?s=100" width="100px;" alt="Mr.zhou"/><br /><sub><b>Mr.zhou</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=Mr-zhou315" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/XimfengYao"><img src="https://avatars.githubusercontent.com/u/17541537?v=4?s=100" width="100px;" alt="姚贤丰"/><br /><sub><b>姚贤丰</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=XimfengYao" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/LINGLUOJUN"><img src="https://avatars.githubusercontent.com/u/16778977?v=4?s=100" width="100px;" alt="lingluojun"/><br /><sub><b>lingluojun</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=LINGLUOJUN" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="http://www.luelueking.com"><img src="https://avatars.githubusercontent.com/u/93204032?v=4?s=100" width="100px;" alt="1ue"/><br /><sub><b>1ue</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=luelueking" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="http://www.jimmyqiao.top"><img src="https://avatars.githubusercontent.com/u/67301054?v=4?s=100" width="100px;" alt="qyaaaa"/><br /><sub><b>qyaaaa</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=qyaaaa" title="Code">💻</a> <a href="https://github.com/apache/hertzbeat/issues?q=author%3Aqyaaaa" title="Bug reports">🐛</a></td>
</tr>
<tr>
  <td align="center" valign="top" width="14.28%"><a href="https://novohit.top"><img src="https://avatars.githubusercontent.com/u/101090395?v=4?s=100" width="100px;" alt="novohit"/><br /><sub><b>novohit</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=novohit" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/rbsrcy"><img src="https://avatars.githubusercontent.com/u/4798540?v=4?s=100" width="100px;" alt="zhuoshangyi"/><br /><sub><b>zhuoshangyi</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=rbsrcy" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/ruanliang-hualun"><img src="https://avatars.githubusercontent.com/u/65543716?v=4?s=100" width="100px;" alt="ruanliang"/><br /><sub><b>ruanliang</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=ruanliang-hualun" title="Documentation">📖</a> <a href="https://github.com/apache/hertzbeat/commits?author=ruanliang-hualun" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/Eden4701"><img src="https://avatars.githubusercontent.com/u/68422437?v=4?s=100" width="100px;" alt="Eden4701"/><br /><sub><b>Eden4701</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=Eden4701" title="Code">💻</a> <a href="https://github.com/apache/hertzbeat/commits?author=Eden4701" title="Documentation">📖</a> <a href="#design-Eden4701" title="Design">🎨</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/XiaTian688"><img src="https://avatars.githubusercontent.com/u/111830921?v=4?s=100" width="100px;" alt="XiaTian688"/><br /><sub><b>XiaTian688</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=XiaTian688" title="Documentation">📖</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/liyin"><img src="https://avatars.githubusercontent.com/u/863169?v=4?s=100" width="100px;" alt="liyinjiang"/><br /><sub><b>liyinjiang</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=liyin" title="Code">💻</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/jiashu1024"><img src="https://avatars.githubusercontent.com/u/67859663?v=4?s=100" width="100px;" alt="ZhangJiashu"/><br /><sub><b>ZhangJiashu</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=jiashu1024" title="Documentation">📖</a></td>
</tr>
<tr>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/1036664317"><img src="https://avatars.githubusercontent.com/u/7696697?v=4?s=100" width="100px;" alt="moghn"/><br /><sub><b>moghn</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=1036664317" title="Documentation">📖</a></td>
  <td align="center" valign="top" width="14.28%"><a href="https://github.com/xiaoguolong"><img src="https://avatars.githubusercontent.com/u/33684988?v=4?s=100" width="100px;" alt="xiaoguolong"/><br /><sub><b>xiaoguolong</b></sub></a><br /><a href="https://github.com/apache/hertzbeat/commits?author=xiaoguolong" title="Code">💻</a></td>

_tomsun28 💻 📖 🎨	_{会编程的王学长} 💻 📖 🎨	_MaxKey 💻 🎨 🤔	_观沧海 💻 🎨 🐛	_yuye 💻 📖	_jx10086 💻 🐛	_winnerTimer 💻 🐛
_goo-kits 💻 🐛	_brave4Time 💻 🐛	_WalkerLee 💻 🐛	_jianghang 💻 🐛	_ChineseTony 💻 🐛	_wyt199905 💻	_卫傅庆 💻 🐛
_zklmcookle 💻	_DevilX5 📖 💻	_tea 💻	_yangshihui 💻 🐛	_DreamGirl524 💻 📖	_gzwlly 📖	_{cuipiheqiuqiu} 💻 ⚠️ 🎨
_lambert 💻	_mroldx 📖	_{woshiniusange} 📖	_VampireAchao 💻	_zcx 💻 🐛 🎨 ⚠️ 📝	_CharlieXCL 📖	_Privauto 💻 📖
_emrys 📖	_SxLiuYu 🐛	_{所有贡献者} 📖	_铁甲小宝 💻 📖	_click33 📖	_蒋小小 📖	_{Kevin Huang} 📖
_铁甲小宝 🐛 💻 📖 ⚠️ 🎨	_{Captain Jack} 📖	_haibo.duan ⚠️ 💻	_assassin 🐛 💻	_{Reverse wind} ⚠️ 💻	_luxx 💻	_{Ikko Ashimine} 📖
_leizenan 💻	_BKing 📖	_xingshuaiLi 📖	_wangke6666 📖	_刺猬 🐛 💻	_Haste 💻	_zhongshi.yi 📖
_{Qi Zhang} 📖	_MrAndyMing 📖	_idongliming 💻	_{Zichao Lin} 💻 📖	_liudonghua 💻 🤔	_Jerry 💻 ⚠️ 🤔	_yanhom 📖
_fsl 💻	_xttttv 📖	_{NavinKumarBarnwal} 💻	_Zakkary 📖	_sunxinbo 💻 ⚠️	_ldzbook 📖 🐛	_余与雨 💻 ⚠️
_{MysticalDream} 💻 ⚠️	_zhouyoulin12 💻 ⚠️	_jerjjj 💻	_wjl110 💻	_Sean 📖	_chenyiqin 💻 ⚠️	_{hudongdong129} 💻 ⚠️ 📖 🎨
_TherChenYang 💻 ⚠️	_HattoriHenzo 💻 ⚠️	_ycilry 📖	_aoshiguchen 📖 💻	_蔡本祥 💻	_浮游 💻	_Grass-Life 💻
_l646505418 💻 🐛	_Carpe-Wang 💻 🐛	_莫枢 💻	_huangcanda 💻	_{世纪末的架构师} 💻	_ShuningWan 📖	_MrYZhou 📖
_suncqujsj 📖	_sunqinbo 💻	_haoww 📖	_i-mayuan 📖	_fengruge 📖	_zhanghuan 💻	_shenymin 💻
_{Dhruva Chandra} 💻	_{miss_z} 📖	_wyt990 💻	_licocon 💻	_{Mi Na} 💻	_Kylin-Guo 📖	_{Mr灬Dong先生} 💻
_{Pratyay Banerjee} 📖 💻	_{yujianzhong520} 💻	_SPPan 💻	_ZhangJiashu 💻	_impress 💻	_{凌晨一点半} 📖	_{Eeshaan Sawant} 💻
_{nandofromthebando} 💻	_caiboking 💻	_baixing99 💻	_{Yang Chuang} 💻	_wlin20 💻	_guojing1983 💻	_moxi 📖
_qq471754603 💻	_渭雨 💻	_liuxuezhuo 💻	_lisongning 💻	_YutingNie 💻 📖 🎨	_{Mike Zhou} 💻 📖 🎨	_lynx009 📖
_{littlezhongzer} 💻	_{ChenXiangxxxxx} 💻	_Smliexx 💻 🐛	_Calvin 📖 💻 🎨 🐛 ⚠️	_{Bala Sukesh} 💻	_{Jinyao Ma} 💻	_Rick 💻 ⚠️
_东风 💻 🎨 📖 🐛	_{sonam singh} 💻	_{ZhangZixuan1994} 💻	_SHIG 💻	_泰上老菌 💻	_ldysdu 💻	_梁同学 💻
_avv 💻	_yqxxgh 📖 💻 🐛	_CharlieShi46 💻	_Nctllnty 💻	_Wang-Yonghao 📖	_读钓 💻	_Xin 💻 🐛
_handy 💻	_LiuTianyou 💻 📖 🐛 ⚠️ 📝 🎨	_WinterKi1ler 💻	_miki 💻	_{Keshav Carpenter} 💻 📖	_{makechoicenow} 💻	_{Gao Jian} ⚠️ 💻 📖 🎨 🐛
_{Hyeon Sung} 💻 📖	_crossoverJie 💻 📖 📝 ⚠️ 🎨	_PeixyJ 💻	_风如歌 💻	_{Manan Pujara} 💻	_xuziyang 💻 📖 🐛