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

一、項目核心概覽

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

二、環(huá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 一鍵安裝（最快，推薦）

# 主服務啟動
docker run -d \
  -p 1157:1157 \
  -p 1158:1158 \
  --name hertzbeat \
  apache/hertzbeat

• • 訪問：http://服務器IP:1157
• • 登錄：admin / hertzbeat

可選：部署采集器集群

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

• • IDENTITY：采集器唯一名稱
• • MANAGER_HOST：主服務對外 IP
• • 主服務控制臺可自動發(fā)現(xiàn)已注冊采集器

方式二：二進制安裝包部署（無 Docker 首選）

• 1. 下載對應系統(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ù)庫、時序庫等）
• 4. 啟動

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

• 5. 訪問：http://IP:1157

方式三：本地源碼啟動（開發(fā)調試）

• • 后端：JDK17 + Maven + Lombok

# 克隆代碼
git clone https://gitee.com/hertzbeat/hertzbeat.git
cd hertzbeat
# 編譯啟動（添加 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

• • 訪問：http://localhost:4200

方式四：Docker Compose 全組件部署

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

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

• • 訪問：http://IP:1157

方式五：K8s + Helm Charts 部署

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

四、首次使用：控制臺快速配置

1. 登錄系統(tǒng)

• • 地址：http://IP:1157
• • 賬號：admin
• • 密碼：hertzbeat

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

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

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

1. 左側 → 告警通知 → 通知渠道

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

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

4. 查看指標大盤與狀態(tài)頁

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

五、核心配置文件說明

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

六、常見問題與排查

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

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

最新評論