源码启动后端需 Java 25 与 maven3+,前端需 Node.js 22 和 pnpm 10,且 IDE 需加 --add-opens 的 VM 参数;默认账号为 admin/hertzbeat,Web 端口 1157、采集器通信端口 1158;完整部署还需另配 PostgreSQL/MySQL 与 VictoriaMetrics/IoTDB/TDengine 等时序库。
hertzbeat
apacheApache-2.0活跃维护开源的实时可观测性系统,通过 Agent 采集指标、日志并接入 LLM 智能分析,替代 Grafana 等传统监控方案做告警通知。
An AI-powered next-generation open source real-time observability system.
docker run -d -p 1157:1157 -p 1158:1158 --name hertzbeat apache/hertzbeatREADME 未说明显存或 GPU 要求;安装包支持 x86/arm64 CPU 架构,可横向扩展多采集器集群。
Apache HertzBeat 是无需 Agent 的实时可观测性平台,统一采集指标日志并集中告警
开源的实时可观测性系统,通过 Agent 采集指标、日志并接入 LLM 智能分析,替代 Grafana 等传统监控方案做告警通知。
核心能力
- 集成采集、分析、告警、通知于一体,内置 MCP Server 能力
- 无 Agent 采集,兼容 Prometheus,覆盖数据库、中间件、云原生等
- 通过在线配置 YML 模板即可自定义监控类型,如 K8s、Docker
- 统一日志平台,通过 OTLP 协议接入多来源日志
- 告警支持分组收敛、静默、抑制,并可分发到邮件、钉钉、Webhook 等渠道
容易踩的坑
- v1.9.0最新正式版2026-09-13 · 2026-09-13 13:06 UTC
Note
This release contains breaking changes 1.9.0 is not a drop-in replacement for the 1.8.x jar or image. The runtime, the configuration file, the authorization rules, the collector credential format, the GreptimeDB table schema and several alerting semantics all changed incompatibly. Read this guide in full before you start: how to update to 1.9.0
What's Changed
- [fix] Fixed Prometheus task history charts not working in the Favorites tab by @Duansg in https://github.com/apache/hertzbeat/pull/4014
- [improve] improved version validation documentation content by @Duansg in https://github.com/apache/hertzbeat/pull/4013
- docs: update download page to v1.8.0 by @TJxiaobao in https://github.com/apache/hertzbeat/pull/4015
- [Docs] Release version 1.8.0 documentation by @zqr10159 in https://github.com/apache/hertzbeat/pull/4017
- docs: fix the sidebars i18n and version display, add auto deploy action by @tomsun28 in https://github.com/apache/hertzbeat/pull/4018
- [fix] Fixed template name mismatch issue by @Duansg in https://github.com/apache/hertzbeat/pull/4021
- [Task] Add user account monitoring metrics for MongoDB by @turanalmammadov in https://github.com/apache/hertzbeat/pull/4033
- docs: add H2 database security warning page by @turanalmammadov in https://github.com/apache/hertzbeat/pull/4036
- Revert "[Task] Add user account monitoring metrics for MongoDB" by @Duansg in https://github.com/apache/hertzbeat/pull/4038
- Split hertzbeat-common into core and spring modules by @zqr10159 in https://github.com/apache/hertzbeat/pull/4035
- fix: Add i18n support for setting-drawer component by @miantalha45 in https://github.com/apache/hertzbeat/pull/4006
- [improve] Improve the login page style by @Duansg in https://github.com/apache/hertzbeat/pull/4044
- [fix] fix alertmanager integration issue by @Duansg in https://github.com/apache/hertzbeat/pull/4022
- feat: SOP-driven AI workflows with skills, scheduling, and i18n support by @TJxiaobao in https://github.com/apache/hertzbeat/pull/4016
- docs: update security model desc by @tomsun28 in https://github.com/apache/hertzbeat/pull/4047
- fix: fix home doc deploy action by @tomsun28 in https://github.com/apache/hertzbeat/pull/4029
- Fix typo: occured to occurred by @04cb in https://github.com/apache/hertzbeat/pull/4049
- [feat] Support Apache Doris as time-series storage for both metrics and logs by @Saramanda9988 in https://github.com/apache/hertzbeat/pull/4031
- fix[protocol-sd]: add register center params check by @yuluo-yx in https://github.com/apache/hertzbeat/pull/4048
- [improve] add group convergence strategy name validation by @Duansg in https://github.com/apache/hertzbeat/pull/4050
- [improve] improved interaction styling for the template editor by @Duansg in https://github.com/apache/hertzbeat/pull/4051
- style: apply primary button style to monitor manage action by @Darshan-paul in https://github.com/apache/hertzbeat/pull/4045
- feat[common]: add hertzbeat common protocol entitiy check by @yuluo-yx in https://github.com/apache/hertzbeat/pull/4052
- docs: improve website geo by @tomsun28 in https://github.com/apache/hertzbeat/pull/4053
- [bugfix] correct typo in sureness monitor delete verb definition by @brettgervasoni in https://github.com/apache/hertzbeat/pull/4054
- feat[common]: add protocl entity check by @yuluo-yx in https://github.com/apache/hertzbeat/pull/4055
- chore: remove the sharp package by @tomsun28 in https://github.com/apache/hertzbeat/pull/4056
- [chore]: Update to Springboot4 and Hibernate 7 by @zqr10159 in https://github.com/apache/hertzbeat/pull/4057
- feat: update nacos client to 3.1.1 by @yuluo-yx in https://github.com/apache/hertzbeat/pull/4061
- [feat]: migrate blocking executors to virtual threads by @zqr10159 in https://github.com/apache/hertzbeat/pull/4062
- feat[common]: add protocol entity check by @yuluo-yx in https://github.com/apache/hert
- 1.8.0v1.8.02026-01-31 · 2026-01-31 07:12 UTC
查看更新说明
Hi guys! Apache HertzBeat 1.8.0 version has published!
What's Changed
- [improve] Improve styling issues by @Duansg in https://github.com/apache/hertzbeat/pull/3734
- Integration QuestDB as Time Series Database Storage by @TJxiaobao in https://github.com/apache/hertzbeat/pull/3731
- [fix] Fixed issue where default path did not match whitelist by @Duansg in https://github.com/apache/hertzbeat/pull/3740
- [improve] Prometheus streaming parsing supports CRLF by @Duansg in https://github.com/apache/hertzbeat/pull/3745
- [doc] update new version download link by @LiuTianyou in https://github.com/apache/hertzbeat/pull/3747
- fix: update CNCF link by @cxhello in https://github.com/apache/hertzbeat/pull/3746
- chore: optimize pom content by @yuluo-yx in https://github.com/apache/hertzbeat/pull/3732
- [doc] update doc for how to release and add release note for 1.7.3 by @LiuTianyou in https://github.com/apache/hertzbeat/pull/3749
- [GSOC] Chat UI, Conversation Management, OpenAI Chat Client Support, More monitoring tools. by @sarthakeash in https://github.com/apache/hertzbeat/pull/3679
- [bugfix] synchronise AI-related configuration for Docker Compose by @delei in https://github.com/apache/hertzbeat/pull/3751
- [OSPP] Add RISC-V related help document. by @lynx009 in https://github.com/apache/hertzbeat/pull/3712
- [Improve] optimize the dashboard page and adapt to the new theme by @delei in https://github.com/apache/hertzbeat/pull/3730
- [improve] Prometheus streaming parsing optimization by @Duansg in https://github.com/apache/hertzbeat/pull/3752
- [docs] Update contributors by @Calvin979 in https://github.com/apache/hertzbeat/pull/3759
- [GSOC] Added all the necessary tools across services by @sarthakeash in https://github.com/apache/hertzbeat/pull/3722
- [feat] Add configuration file for Dell iDRAC monitoring type by @tuzuy in https://github.com/apache/hertzbeat/pull/3763
- [feat] Support apollo configuration center monitoring by @Duansg in https://github.com/apache/hertzbeat/pull/3768
- [doc] replace with the new ASF logo by @delei in https://github.com/apache/hertzbeat/pull/3770
- [improve] SSE exception handling improvements by @Duansg in https://github.com/apache/hertzbeat/pull/3775
- [feat] Support monitoring center indicator favorites feature by @Duansg in https://github.com/apache/hertzbeat/pull/3735
- [fix]bugfix:Prevent Long.parseLong() error when search param is a float by @starryCoder in https://github.com/apache/hertzbeat/pull/3483
- [doc] add japanese i18n in app-idrac.yml by @Calvin979 in https://github.com/apache/hertzbeat/pull/3766
- [improve] Improving the operation of threshold rules and the output of expression logs by @Duansg in https://github.com/apache/hertzbeat/pull/3780
- [Improve] Optimise and use the label-selector component for label selection within pages by @delei in https://github.com/apache/hertzbeat/pull/3762
- [feat] Support jenkins monitoring by @Duansg in https://github.com/apache/hertzbeat/pull/3774
- [improve] Prometheus streaming parsing optimization enhancements by @Duansg in https://github.com/apache/hertzbeat/pull/3761
- [OSPP] Implement a mcp server to run any scripts or commands securely by @yexuanyang in https://github.com/apache/hertzbeat/pull/3547
- [bugfix] webhook url query parameters missing by @mengnankkkk in https://github.com/apache/hertzbeat/pull/3779
- [bugfix] fix service discovery host field NullPointerException by @pwallk in https://github.com/apache/hertzbeat/pull/3767
- [docs] update doc and add new contributors by @tomsun28 in https://github.com/apache/hertzbeat/pull/3783
- [OSPP] Apache HertzBeat Log Monitoring Capability by @bigcyy in https://github.com/apache/hertzbeat/pull/3673
- [improve] Optimize Gretimedb time-series statistics. by @jl15988 in https://github.com/apache/hertzbeat/pull/3776
- [OSPP] Modify Dockerfile to support RISC-V. by @lynx009 in https://github.com/apache/hertzbeat/pull/3713
- [fix] remove v174 and add v18
- v1.7.32025-08-31 · 2025-08-31 14:27 UTC
查看更新说明
Hi guys! Apache HertzBeat 1.7.3 version has published!
What's Changed
- [release] release new version 1.7.2 by @tomsun28 in https://github.com/apache/hertzbeat/pull/3510
- [doc] japanese hpe switch by @Calvin979 in https://github.com/apache/hertzbeat/pull/3511
- [doc] japanese huawei switch by @Calvin979 in https://github.com/apache/hertzbeat/pull/3515
- [doc] japanese hive by @Calvin979 in https://github.com/apache/hertzbeat/pull/3506
- [doc] japanese hugeGraph by @Calvin979 in https://github.com/apache/hertzbeat/pull/3518
- [feature] Support for
Periodic Thresholdpreview. by @Duansg in https://github.com/apache/hertzbeat/pull/3505 - [Improve] Improve kafka e2e by @zhangshenghang in https://github.com/apache/hertzbeat/pull/3520
- [doc] japanese iceberg by @Calvin979 in https://github.com/apache/hertzbeat/pull/3519
- [fix] Update the correct replacement of outdated functions and placeholders by @Cyanty in https://github.com/apache/hertzbeat/pull/3516
- [doc] japanese influxdb by @Calvin979 in https://github.com/apache/hertzbeat/pull/3521
- [doc] japanese hikvision by @Calvin979 in https://github.com/apache/hertzbeat/pull/3499
- [doc] Add new commiter blog by @MasamiYui in https://github.com/apache/hertzbeat/pull/3522
- [fix] fix i18n error and append two metrics about disk infos by @lx1229 in https://github.com/apache/hertzbeat/pull/3514
- [feat]parallel ci by @Aias00 in https://github.com/apache/hertzbeat/pull/3523
- [doc] japanese influxdb promql by @Calvin979 in https://github.com/apache/hertzbeat/pull/3527
- fix: fix something by @Aias00 in https://github.com/apache/hertzbeat/pull/3524
- [doc] japanese iotdb by @Calvin979 in https://github.com/apache/hertzbeat/pull/3530
- download version deal by @lynx009 in https://github.com/apache/hertzbeat/pull/3531
- [doc] update outdated links by @lynx009 in https://github.com/apache/hertzbeat/pull/3535
- [doc]update download page text by @zqr10159 in https://github.com/apache/hertzbeat/pull/3532
- [doc] japanese ipmi by @Calvin979 in https://github.com/apache/hertzbeat/pull/3537
- [doc] japanese jetty by @Calvin979 in https://github.com/apache/hertzbeat/pull/3539
- enable GitHub Dependabot to create PRs for security alerts but not for every dependency update by @pjfanning in https://github.com/apache/hertzbeat/pull/3543
- [doc] Fix some issues in the documentation by @Duansg in https://github.com/apache/hertzbeat/pull/3526
- [doc] recommend newer mysql connector jar by @pjfanning in https://github.com/apache/hertzbeat/pull/3541
- [doc] add hertzbeat maturity and fix doc by @tomsun28 in https://github.com/apache/hertzbeat/pull/3544
- [doc] update download page by @lynx009 in https://github.com/apache/hertzbeat/pull/3549
- [doc] japanese kafka by @Calvin979 in https://github.com/apache/hertzbeat/pull/3548
- [doc] japanese jvm by @Calvin979 in https://github.com/apache/hertzbeat/pull/3545
- [doc] japanese kafka client by @Calvin979 in https://github.com/apache/hertzbeat/pull/3550
- [feature] Support export all allmonitors by @YxYL6125 in https://github.com/apache/hertzbeat/pull/3509
- feat: Add LogUtil wrapper and optimize logging comments by @Carpe-Wang in https://github.com/apache/hertzbeat/pull/3489
- [refactor]
AlarmCacheManagerrefactoring processing logic by @Duansg in https://github.com/apache/hertzbeat/pull/3525 - [improve] make jackson serialize all field visibility by @tomsun28 in https://github.com/apache/hertzbeat/pull/3551
- [bugfix] fix npe due the victoria insert not config when startup by @tomsun28 in https://github.com/apache/hertzbeat/pull/3552
- [doc] V1.7.2 version blog by @lynx009 in https://github.com/apache/hertzbeat/pull/3558
- [doc] japanese kafka promql by @Calvin979 in https://github.com/apache/hertzbeat/pull/3553
- [doc] Fix documentation error and adjust Chinese semantics by @Duansg in https://github.com/apache/hertzbeat/pull/3559
- [doc] add new pmc and committer by @tomsun28 in https://github.com/apache/
- v1.7.22025-06-25 · 2025-06-25 14:17 UTC
查看更新说明
v1.7.2
Hi guys! Apache HertzBeat (incubating) 1.7.2 version has published!
What's Changed
- [bugfix] Fix incorrect webhook URLs for Uptime Kuma, Zabbix, and Tencent Cloud by @bigcyy in https://github.com/apache/hertzbeat/pull/3351
- [doc] japanese api by @Calvin979 in https://github.com/apache/hertzbeat/pull/3352
- [doc] update OS monitor by @MasamiYui in https://github.com/apache/hertzbeat/pull/3353
- doc: update greptime-init documentation by @zqr10159 in https://github.com/apache/hertzbeat/pull/3355
- [doc] new ppmc liutianyou and update qq num by @tomsun28 in https://github.com/apache/hertzbeat/pull/3357
- [bugfix] Incorrect SD sub-monitor status by @MasamiYui in https://github.com/apache/hertzbeat/pull/3340
- [improve] improve url validation for WeComRobotAlertNotifyHandlerImpl by @Aias00 in https://github.com/apache/hertzbeat/pull/3361
- [improve] improve url validation for TelegramBotAlertNotifyHandlerImpl by @Aias00 in https://github.com/apache/hertzbeat/pull/3362
- [improve] improve url validation for SlackAlertNotifyHandlerImpl by @Aias00 in https://github.com/apache/hertzbeat/pull/3363
- [improve] improve url validation for serverChan by @Aias00 in https://github.com/apache/hertzbeat/pull/3364
- [improve] improve jndi validation by @Aias00 in https://github.com/apache/hertzbeat/pull/3358
- update maven dep by @Aias00 in https://github.com/apache/hertzbeat/pull/3359
- [doc] japanese centos by @Calvin979 in https://github.com/apache/hertzbeat/pull/3376
- [doc] fix incorrect time template syntax usercase in doc by @LL-LIN in https://github.com/apache/hertzbeat/pull/3378
- [doc] Add blog by @LiuTianyou in https://github.com/apache/hertzbeat/pull/3379
- [improve] add path validation for pluginservice by @Aias00 in https://github.com/apache/hertzbeat/pull/3375
- [feat] Support Zookeeper Service Discovery by @bigcyy in https://github.com/apache/hertzbeat/pull/3377
- [doc] modify chinese words by @Duansg in https://github.com/apache/hertzbeat/pull/3380
- [Task] Batch import metrics data in victoria-metrics by @MasamiYui in https://github.com/apache/hertzbeat/pull/3337
- [feature] support auto nacos service discovery by @xiaomizhou2 in https://github.com/apache/hertzbeat/pull/3324
- [doc] modify supplement related documentation by @Duansg in https://github.com/apache/hertzbeat/pull/3383
- [doc] japanese cisco switch by @Calvin979 in https://github.com/apache/hertzbeat/pull/3389
- [test] Add unit tests for HttpSdCollectImpl by @xiaomizhou2 in https://github.com/apache/hertzbeat/pull/3386
- fix: improve GreptimeDB data storage and querying by @zqr10159 in https://github.com/apache/hertzbeat/pull/3387
- [doc] japanese clickhouse by @Calvin979 in https://github.com/apache/hertzbeat/pull/3390
- [doc] new contributor and committer, update doc by @tomsun28 in https://github.com/apache/hertzbeat/pull/3391
- [doc] japanese consul sd by @Calvin979 in https://github.com/apache/hertzbeat/pull/3392
- [doc]add new committer blog by @pwallk in https://github.com/apache/hertzbeat/pull/3395
- [doc] japanese coreos by @Calvin979 in https://github.com/apache/hertzbeat/pull/3393
- [doc] japanese dahua by @Calvin979 in https://github.com/apache/hertzbeat/pull/3396
- [doc] japanese Debian by @Calvin979 in https://github.com/apache/hertzbeat/pull/3398
- [improve] http sd collector adds authentication by @Cyanty in https://github.com/apache/hertzbeat/pull/3388
- [doc] japanese deepseek & dm by @Calvin979 in https://github.com/apache/hertzbeat/pull/3400
- [docs] update alert threshold doc by @bigcyy in https://github.com/apache/hertzbeat/pull/3399
- [doc] japanese dns by @Calvin979 in https://github.com/apache/hertzbeat/pull/3404
- [doc] japanese dns sd by @Calvin979 in https://github.com/apache/hertzbeat/pull/3405
- [doc] japanese docker by @Calvin979 in https://github.com/apache/hertzbeat/pull/3408
- [doc] japanese doris_be by @Calvin979 in https://github.com/apache/hertzbe
- v1.7.12025-05-29 · 2025-05-29 08:37 UTC
查看更新说明
v1.7.1
Hi guys! Apache HertzBeat (incubating) 1.7.1 version has published!
What's Changed
- fix: Ai is a typo by @LinuxSuRen in https://github.com/apache/hertzbeat/pull/3176
- [Doc] Modify the error records in the document by @zhangshenghang in https://github.com/apache/hertzbeat/pull/3178
- [bug]bugfix:fix bug for package import error by @PengJingzhao in https://github.com/apache/hertzbeat/pull/3180
- [doc] add help documentation for Alarms Center by @bigcyy in https://github.com/apache/hertzbeat/pull/3181
- [docs] add collector user guide by @sarthakeash in https://github.com/apache/hertzbeat/pull/3187
- [bugfix] Modify inconsistent icons by @MasamiYui in https://github.com/apache/hertzbeat/pull/3190
- [doc] add blog bout How Does Metrics Collection Work by @JuJinPark in https://github.com/apache/hertzbeat/pull/3195
- [improve] update monitor detail ui by @tomsun28 in https://github.com/apache/hertzbeat/pull/3199
- [doc] update new hertzbeat ppmc by @tomsun28 in https://github.com/apache/hertzbeat/pull/3191
- [improve] update monitor list ui by @tomsun28 in https://github.com/apache/hertzbeat/pull/3200
- update download info by @Aias00 in https://github.com/apache/hertzbeat/pull/3203
- [bugfix] fix bulletin indicator selection status error by @bigcyy in https://github.com/apache/hertzbeat/pull/3201
- [improve] optimize kafka collection logic and expand test coverage by @Rancho-7 in https://github.com/apache/hertzbeat/pull/3189
- [improve] support the use of time expressions in HTTP payloads by @LiuTianyou in https://github.com/apache/hertzbeat/pull/3192
- [improve] i18n Portuguese by @LiuTianyou in https://github.com/apache/hertzbeat/pull/3193
- support plc s7 protocol for siemens by @boyucjz in https://github.com/apache/hertzbeat/pull/3194
- [doc] add doc for alarm grouping and alarm inhibit by @LiuTianyou in https://github.com/apache/hertzbeat/pull/3206
- [improve] optimize
DnsCollectTestwith status code. by @Rancho-7 in https://github.com/apache/hertzbeat/pull/3209 - [doc] archive version docs by @tomsun28 in https://github.com/apache/hertzbeat/pull/3207
- [feature]Implementation of Hikvision camera monitoring and http monitoring xml parsing function by @zqr10159 in https://github.com/apache/hertzbeat/pull/3211
- [test]add test for controller AlertInhibitController by @PengJingzhao in https://github.com/apache/hertzbeat/pull/3183
- test: add unit test for XML response parsing by @zqr10159 in https://github.com/apache/hertzbeat/pull/3212
- add a Pushgateway to push module by @leo-934 in https://github.com/apache/hertzbeat/pull/3204
- [feature]add support for Dahua and Uniview devices by @zqr10159 in https://github.com/apache/hertzbeat/pull/3214
- [Doc] Fix dead link by @zhangshenghang in https://github.com/apache/hertzbeat/pull/3227
- [feature]A preliminary logging module implementation by @zqr10159 in https://github.com/apache/hertzbeat/pull/3218
- [Doc] Modify the YML configuration parameters for Spring Boot 2.0/3.0 monitoring by @Cyanty in https://github.com/apache/hertzbeat/pull/3231
- [Doc] Add Blog by @zhangshenghang in https://github.com/apache/hertzbeat/pull/3224
- [doc] add alerting silence doc. by @a-little-fool in https://github.com/apache/hertzbeat/pull/3229
- [doc] code style check by @a-little-fool in https://github.com/apache/hertzbeat/pull/3232
- [bugfix]: Fix the issue where pendingTimeouts may be incorrect in the HashedWheelTimer. by @gagaradio in https://github.com/apache/hertzbeat/pull/3174
- [doc] add code-style-check zh-ch. by @a-little-fool in https://github.com/apache/hertzbeat/pull/3236
- [doc]update Grafana dashboard setup instructions by @zqr10159 in https://github.com/apache/hertzbeat/pull/3238
- [bugfix] Added jobContentCache.remove(jobId) to cancelAsyncCollectJob by @bigcyy in https://github.com/apache/hertzbeat/pull/3240
- [doc] add new release 1.7.0 blog by @tomsun28 in https://github.com/apache/hertzbeat/pull/3237
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Home: hertzbeat.apache.org
Email: Mail to [email protected] to subscribe mailing lists
🎡 Introduction
Apache HertzBeat™ is an AI-powered next-generation open source real-time observability system. Unified metrics and logs collection, centralized alerting distribution, intelligent management and analysis. No Agent required, high performance cluster, provides powerful custom monitoring and status page building capabilities.
Features
- Integrates collection + analysis + alerting + notification into one platform, with new AI-powered interactions and features under HertzBeat AI, and built-in MCP Server capabilities.
- Unified metrics platform, agentless, Prometheus-compatible, supports application services, programs, databases, caches, operating systems, big data, middleware, web servers, cloud-native, networks, custom monitoring and more.
- Unified logging platform, seamlessly integrates multiple log sources through OTLP protocol for reporting.
- Unified alerting platform, integrates internal alerts with various external alert sources, unified alert processing and analysis, flexible real-time and periodic threshold rules, grouping convergence, silence, suppression, etc.
- Unified message distribution, alerts processed by the alerting platform are distributed via
EmailDiscordSlackTelegramDingTalkWeChatFeiShuSMSWebhookServerChanand other methods. - Makes protocols such as
Http, Jmx, Ssh, Snmp, Jdbc, Prometheusconfigurable, allowing you to collect any metrics by simply configuring the templateYMLfile online. Imagine being able to quickly adapt to a new monitoring type like K8s or Docker simply by configuring online with HertzBeat. - High performance, supports horizontal expansion of multi-collector clusters, multi-isolated network monitoring and cloud-edge collaboration.
- Provides powerful status page building capabilities, easily communicate the real-time status of your service to users.
HertzBeat's unified platform, AI intelligence, powerful customization, multi-type support, high performance, and easy expansion, aims to help users quickly and conveniently achieve observability requirements.
🥐 Architecture

🐕 Quick Start
-
Community alpha preview users can start from docs/alpha-preview.md for the current Next.js frontend, entity-centered observability, local smoke, and known alpha limitations.
-
If you wish to deploy HertzBeat locally, please refer to the following Deployment Documentation for instructions.
🍞 Install HertzBeat
HertzBeat supports installation through source code, docker or package, cpu support x86/arm64.
1:Install quickly via docker
-
Just one command to get started
docker run -d -p 1157:1157 -p 1158:1158 --name hertzbeat apache/hertzbeat -
Access
http://localhost:1157to start, default account:admin/hertzbeat -
Deploy collector clusters (Optional)
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: set the collector unique identity name.-e MODE=public: set the running mode(public or private), public cluster or private cloud-edge.-e MANAGER_HOST=127.0.0.1: set the main hertzbeat server ip.-e MANAGER_PORT=1158: set the main hertzbeat server port, default 1158.
Detailed config refer to Install HertzBeat via Docker
2:Install via package
- Download the release package
hertzbeat-xx.tar.gzDownload - Configure the HertzBeat configuration yml file
hertzbeat/config/application.yml(optional) - Run command
$ ./bin/startup.shorbin/startup.bat - Access
http://localhost:1157to start, default account:admin/hertzbeat - Deploy collector clusters (Optional)
- Download the release package
hertzbeat-collector-xx.tar.gzto new machine Download - Configure the collector configuration yml file
hertzbeat-collector/config/application.yml: uniqueidentityname, runningmode(public or private), hertzbeatmanager-host, hertzbeatmanager-portcollector: dispatch: entrance: netty: enabled: true identity: ${IDENTITY:} mode: ${MODE:public} manager-host: ${MANAGER_HOST:127.0.0.1} manager-port: ${MANAGER_PORT:1158} - Run command
$ ./bin/startup.shorbin/startup.bat - Access
http://localhost:1157and you will see the registered new collector in dashboard
- Download the release package
Detailed config refer to Install HertzBeat via Package
3:Start via source code
- Local source code debugging needs to start the back-end project
hertzbeat-startupand the front-end projectweb-app. - Backend: need
maven3+, Java 25, andlombok; add VM options in IDE:--add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED, then start thehertzbeat-startupservice. - Web: need
Node.js 22andpnpm 10, runcorepack [email protected] install --frozen-lockfile && corepack [email protected] devinweb-appafter backend startup. - Access
http://localhost:4200to start, default account:admin/hertzbeat
Detailed steps refer to CONTRIBUTING
4:Install All(hertzbeat+postgresql+tsdb) via Docker-compose
Install the postgresql/mysql database, victoria-metrics/iotdb/tdengine database and hertzbeat at one time through docker-compose deployment script.
Detailed steps refer to Install via Docker-Compose
5: Install All(hertzbeat+collector+postgresql+tsdb) via kubernetes helm charts
Install HertzBeat cluster in a Kubernetes cluster by Helm chart.
Detailed steps refer to Artifact Hub
HAVE FUN
✨ Contributors
Thanks to these wonderful people, welcome to join us: Contributor Guide
💬 Join discussion
Channel
Join the Mailing Lists : Mail to [email protected] to subscribe mailing lists.
WeChat Group : Add friend ahertzbeat and invite to the group.
WeChat Public : Search ID usthecom.
QQ Group : Group num 1035688434
Open-Source Project Build From Open-Source
HertzBeat is built on so many great open source projects, thanks to them!
Java Spring SpringBoot Jpa Maven Assembly Netty Lombok Sureness Protobuf HttpClient Guava SnakeYaml JsonPath ...TypeScript Next.js React Tailwind CSS Node.js Npm ECharts G6 MonacoEditor Docusaurus ...