Apache HertzBeat 是AI 驅(qū)動(dòng)、無(wú) Agent、一站式開源實(shí)時(shí)觀測(cè)系統(tǒng)，支持指標(biāo)/日志統(tǒng)一采集、告警智能分發(fā)、靈活自定義監(jiān)控，兼容多協(xié)議與云原生環(huán)境，本文基于 Gitee 官方倉(cāng)庫(kù)整理最全安裝、配置、使用流程，小白也能快速上手。

一、項(xiàng)目核心概覽

• • 定位：采集 + 分析 + 告警 + 通知一體化實(shí)時(shí)觀測(cè)平臺(tái)
• • 優(yōu)勢(shì)：無(wú)需 Agent、高性能集群、自定義 YML 模板、多協(xié)議兼容、狀態(tài)頁(yè)構(gòu)建
• • 端口：Web 控制臺(tái) 1157、采集器通信 1158
• • 默認(rèn)賬號(hào)：admin / hertzbeat
• • 協(xié)議支持：HTTP/JMX/SSH/SNMP/JDBC/Prometheus/OTLP 等
• • 部署方式：Docker / 安裝包 / 源碼 / Docker Compose / Kubernetes

二、環(huán)境準(zhǔn)備（必看）

• • 系統(tǒng)：Linux/macOS/Windows（x86_64/arm64）
• • 最低配置：2 核 CPU、4G 內(nèi)存、10G 磁盤
• • 依賴：
  • • Docker 方式：Docker 20.10+
  • • 安裝包/源碼：JDK 17+、Maven 3.6+、Node.js 16+
• • 防火墻放行：1157（Web）、1158（采集器）端口

三、5 種安裝部署方式（官方推薦）

方式一：Docker 一鍵安裝（最快，推薦）

# 主服務(wù)啟動(dòng)
docker run -d \
  -p 1157:1157 \
  -p 1158:1158 \
  --name hertzbeat \
  apache/hertzbeat

• • 訪問(wèn)：http://服務(wù)器IP:1157
• • 登錄：admin / hertzbeat

可選：部署采集器集群

docker run -d \
  -e IDENTITY=my-collector-01 \
  -e MANAGER_HOST=主服務(wù)IP \
  -e MANAGER_PORT=1158 \
  --name hertzbeat-collector \
  apache/hertzbeat-collector

• • IDENTITY：采集器唯一名稱
• • MANAGER_HOST：主服務(wù)對(duì)外 IP
• • 主服務(wù)控制臺(tái)可自動(dòng)發(fā)現(xiàn)已注冊(cè)采集器

方式二：二進(jìn)制安裝包部署（無(wú) Docker 首選）

• 1. 下載對(duì)應(yīng)系統(tǒng)安裝包：https://hertzbeat.apache.org/zh-cn/docs/download/
• 2. 解壓

tar -zxvf apache-hertzbeat-x.x.x-bin.tar.gz
cd apache-hertzbeat-x.x.x

• 3. （可選）修改配置：config/application.yml（數(shù)據(jù)庫(kù)、時(shí)序庫(kù)等）
• 4. 啟動(dòng)

# Linux/macOS
./bin/startup.sh
# Windows
bin/startup.bat

• 5. 訪問(wèn)：http://IP:1157

方式三：本地源碼啟動(dòng)（開發(fā)調(diào)試）

• • 后端：JDK17 + Maven + Lombok

# 克隆代碼
git clone https://gitee.com/hertzbeat/hertzbeat.git
cd hertzbeat
# 編譯啟動(dòng)（添加 JVM 參數(shù)）
mvn clean install -DskipTests
cd hertzbeat-startup
java --add-opens=java.base/java.nio=org.apache.arrow.memory.core,ALL-UNNAMED -jar target/hertzbeat.jar

• • 前端：Node.js + Angular

cd web-app
npm install
ng serve --open

• • 訪問(wèn)：http://localhost:4200

方式四：Docker Compose 全組件部署

適合生產(chǎn)環(huán)境，一鍵部署：HertzBeat + PostgreSQL + VictoriaMetrics 時(shí)序庫(kù)

# 下載解壓
wget 安裝包地址
tar -zxvf apache-hertzbeat-x.x.x-docker-compose.tar.gz
cd hertzbeat-postgresql-victoria-metrics
# 啟動(dòng)
docker-compose up -d
# 查看狀態(tài)
docker-compose ps

• • 訪問(wèn)：http://IP:1157

方式五：K8s + Helm Charts 部署

helm repo add hertzbeat https://charts.hertzbeat.apache.org/
helm repo update
helm install hertzbeat hertzbeat/hertzbeat

四、首次使用：控制臺(tái)快速配置

1. 登錄系統(tǒng)

• • 地址：http://IP:1157
• • 賬號(hào)：admin
• • 密碼：hertzbeat

2. 添加監(jiān)控（以 Linux 為例）

• 1. 左側(cè)菜單 → 監(jiān)控管理 → 新增監(jiān)控
• 2. 選擇監(jiān)控類型：Linux 操作系統(tǒng)
• 3. 填寫參數(shù)：
• • 主機(jī) IP
• • SSH 端口（默認(rèn) 22）
• • 用戶名/密碼或密鑰
• 4. 保存，自動(dòng)開始采集

3. 告警通知配置（釘釘/微信/郵件）

1. 左側(cè) → 告警通知 → 通知渠道

2. 新增渠道：釘釘機(jī)器人/企業(yè)微信/郵箱/Slack/Webhook 等

3. 設(shè)置告警規(guī)則、閾值、收斂策略

4. 查看指標(biāo)大盤與狀態(tài)頁(yè)

• • 概覽：實(shí)時(shí)監(jiān)控大盤、主機(jī)/服務(wù)狀態(tài)
• • 狀態(tài)頁(yè)：一鍵生成對(duì)外服務(wù)狀態(tài)頁(yè)，向用戶展示可用性

五、核心配置文件說(shuō)明

• • config/application.yml：主配置（端口、數(shù)據(jù)庫(kù)、時(shí)序庫(kù)、采集器）
• • config/sureness.yml：用戶賬號(hào)權(quán)限配置
• • define/ 目錄：各類監(jiān)控 YML 模板（MySQL、Redis、K8s 等）
• • 自定義監(jiān)控：只需編寫 YML 即可擴(kuò)展新監(jiān)控類型

六、常見(jiàn)問(wèn)題與排查

• 1. 無(wú)法訪問(wèn) 1157
  • • 檢查防火墻/安全組是否放行端口
  • • 查看日志：logs/hertzbeat.log
• 2. 采集器連接失敗
  • • 確認(rèn)主服務(wù) 1158 端口通
  • • 檢查 MANAGER_HOST 填寫正確
• 3. 監(jiān)控?zé)o數(shù)據(jù)
  • • 確認(rèn)目標(biāo)主機(jī)端口、賬號(hào)、權(quán)限正常
  • • 查看監(jiān)控詳情 → 最近采集日志
• 七、社區(qū)與資源
  • • 官方文檔：https://hertzbeat.apache.org/zh-cn/docs/intro/
  • • Gitee 倉(cāng)庫(kù)：https://gitee.com/hertzbeat/hertzbeat
  • • 許可證：Apache License 2.0

到此這篇關(guān)于Apache HertzBeat 安裝使用完整指南的文章就介紹到這了,更多相關(guān)Apache HertzBeat 安裝使用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論