当前位置： 首页 > news >正文

HertzBeat 监控 SpringBoot 使用案例

news 2025/7/17 11:40:10

HertzBeat 监控 SpringBoot 使用案例

在云原生时代，Spring Boot应用的监控与可视化已然成为运维体系的核心环节，实时监控应用性能是保障系统稳定性的关键。

这篇文章将结合 HertzBeat 实现从指标采集、可视化到告警的一体化解决方案，并展示完整操作流程与监控实践。

HertzBeat 是什么

Apache HertzBeat (incubating) 一个拥有强大自定义监控能力，无需Agent的实时监控工具。网站监测，PING连通性，端口可用性，数据库，操作系统，中间件，API监控，阈值告警，告警通知(邮件微信钉钉飞书)。

github: https://github.com/apache/hertzbeat

安装 HertzBeat

生产环境中推荐使用 PostgreSQL + VictoriaMetrics 服务的方式部署 HertzBeat。

1、部署 HertzBeat

  • 下载安装包

    从 下载页面 下载您系统环境对应的安装包版本 apache-hertzbeat-xxx-incubating-bin.tar.gz；

    解压安装包到主机，如: /opt/hertzbeat

- tar zxvf apache-hertzbeat-xxx-incubating-bin.tar.gz

2、快速安装 PostgreSQL + VictoriaMetrics 服务

  • Docker 安装 PostgreSQL
- docker run -d --name postgresql -p 5432:5432 -v "$PWD/data:/var/lib/postgresql/data" -e POSTGRES_USER=root -e     POSTGRES_PASSWORD=123456 -e TZ=Asia/Shanghai postgres:15
  • Docker 安装 VictoriaMetrics
- docker run -d -p 8428:8428 -v "$PWD/victoria-metrics-data:/victoria-metrics-data" --name victoria-metrics victoriametrics/victoria-metrics:v1.95.1

3、修改 HertzBeat 的配置文件

  • 切换元数据储存数据源

    修改位于 hertzbeat/config/application.yml 的配置文件，替换为 PostgreSQL 服务：

- spring:datasource:driver-class-name: org.postgresql.Driverusername: rootpassword: 123456url: jdbc:postgresql://postgresql:5432/hertzbeathikari:max-lifetime: 120000jpa:show-sql: falsedatabase-platform: org.eclipse.persistence.platform.database.PostgreSQLPlatformdatabase: postgresqlproperties:eclipselink:logging:level: SEVERE

  • 配置时序数据库服务

    同理，修改 hertzbeat/config/application.yml 的配置文件，开启 VictoriaMetrics 服务用于存储指标：

- warehouse:store:# 关闭默认JPAjpa:enabled: false# 启用 victoria-metricsvictoria-metrics:enabled: trueurl: http://localhost:8428username: rootpassword: root

4、启动

在上述解压好的安装目录 bin 下的启动脚本 startup.sh，windows 环境下为 startup.bat

./startup.sh

SpringBoot 应用配置

  1. 开启Actuator监控

    在pom.xml添加依赖：

-  <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-actuator</artifactId></dependency><dependency><groupId>io.micrometer</groupId><artifactId>micrometer-registry-prometheus</artifactId></dependency>

配置application.yml暴露端点：

-  management:endpoints:web:exposure:include: '*'enabled-by-default: truemetrics:export:prometheus:enabled: true

注意：如果你的项目里还引入了认证相关的依赖，比如 springboot-security ,那么 SpringBoot Actuator 暴露出的接口可能会被拦截，此时需要你手动放开这些接口，以 springboot-security 为例，需要在 SecurityConfig 配置类中加入以下代码：

-  public class SecurityConfig extends WebSecurityConfigurerAdapter{@Overrideprotected void configure(HttpSecurity httpSecurity) throws Exception{httpSecurity// 配置要放开的接口.antMatchers("/actuator/**").permitAll().antMatchers("/metrics/**").permitAll().antMatchers("/trace").permitAll().antMatchers("/heapdump").permitAll()// ...}}

  1. 验证端点

    请求URL: http://<your-host>:<port>/actuator 验证已启用的端点，http://<your-host>:<port>/actuator/prometheus 应返回指标数据。

监控 SpringBoot 应用

  1. 新增 AUTO 监控

    系统导航至「监控中心」→「新增监控」→「AUTO」→「Prometheus任务」

  2. 填写关键参数

    • 目标Host：SpringBoot 应用服务器地址（不带协议头，例如: https://, http:// ）

    • 端口：应用服务端口（例如: 8080）

    • 端点路径：/actuator/prometheus

    • 使用标签分类来管理任务，如添加env=test等业务相关标签

  3. 查看检测指标数据

    点击进入新建监控，可以查看指标数据详情及指标历史图表等。

Grafana可视化集成 (可选)

  1. Grafana 部署

    启用 Grafana 可嵌入功能, 并开启匿名访问：

    参考: https://grafana.com/blog/2023/10/10/how-to-embed-grafana-dashboards-into-web-applications/ 修改配置文件grafana.ini中的allow_embedding = true 修改配置文件grafana.ini中的[auth.anonymous] 为 true 或者通过docker运行Grafana,使用以下命令:

-  docker run -d --name grafana -p 3000:3000 -v "$PWD/grafana:/var/lib/grafana" -e "GF_AUTH_PROXY_ENABLED=true" -e "GF_AUTH_ANONYMOUS_ENABLED=true" -e "GF_AUTH_ANONYMOUS_ORG_ROLE=Admin" -e "GF_USERS_VIEWERS_CAN_EDIT=true" -e "GF_SECURITY_ALLOW_EMBEDDING=true" grafana/grafana:10.4.18

-  [auth.proxy]enabled = true[auth.anonymous]enabled = trueorg_role = Admin[users]viewers_can_edit = true[security]allow_embedding = true
环境变量grafana.ini配置段配置键名功能说明
GF_AUTH_PROXY_ENABLED=true[auth.proxy]enabled启用反向代理认证模式，允许通过HTTP头传递用户身份
GF_AUTH_ANONYMOUS_ENABLED=true[auth.anonymous]enabled开启匿名访问，无需登录即可访问Grafana界面
GF_AUTH_ANONYMOUS_ORG_ROLE=Admin[auth.anonymous]org_role设置匿名用户的默认权限为管理员（Admin），赋予所有操作权限
GF_USERS_VIEWERS_CAN_EDIT=true[users]viewers_can_edit允许"Viewer"角色的用户编辑仪表盘（通常仅限"Editor"或"Admin"角色有此权限）
GF_SECURITY_ALLOW_EMBEDDING=true[security]allow_embedding允许通过iframe等方式将Grafana面板嵌入第三方页面

  1. 在HertzBeat中配置Grafana

    在 HertzBeat 的配置文件application.yml中，配置 Grafana 数据源:

-  grafana:enabled: trueurl: http://127.0.0.1:3000username: adminpassword: admin

  1. 在 HertzBeat 监控中嵌入 Grafana 仪表盘

    配置启用 Grafana 后，重启 HertzBeat 服务，在新增的 AUTO 监控中启用并上传 Grafana 模板。比如：Grafana 数据源选择hertzbeat-victoria-metrics，然后在仪表盘点击:「Share」→「Export」→「Save to file」下载模板并上传至 HertzBeat 监控中。

  2. 查看 Grafana 图表

    进入新增 AUTO 监控页面，点击 Grafana 图标按钮，即可查看 Grafana 图表。

告警与通知联动

  1. HertzBeat告警配置

    系统页面 -> 告警 -> 阈值规则 -> 新增 -> 新增阈值

  2. 填写关键参数

    HertzBeat 提供了 实时计算 和 计划周期 两种类型的阈值规则设置，这里我们以 计划周期 阈值规则为例。

    • 阈值名称：阈值规则名称
    • 阈值规则：填写指标监测的规则（支持 PromQL）
    • 执行周期：周期性执行阈值计算的时间间隔
    • 告警级别：触发阈值的告警级别,从低到高依次为: 警告-warning，严重-critical，紧急-emergency
    • 触发次数：设置触发阈值多少次之后才会发送告警
    • 告警内容：填写指标监测的告警内容

  3. 设置阈值规则

    比如监测 SpringBoot 应用程序的 CPU 占用，添加阈值规则：system_cpu_usage{job="Jolly_Vulture_43vT"} > 0.01，当然，可以设置的阈值规则有很多，用户可以根据自身需求设置更丰富的告警规则。

    最终可以在告警中心看到已触发的告警。

  4. 告警通知

    系统页面 -> 消息通知 -> 通知媒介 -> 新增接收对象

    消息通知 -> 通知策略 -> 新增告警通知策略 -> 将刚才配置的接收人启用通知

    OK 当阈值触发后我们就可以收到对应告警消息啦，如果没有配通知，也可以在告警中心查看告警信息。

小总结

通过简洁的配置，用户几分钟之内就可搭建完整的监控体系，这充分体现了 HertzBeat 的几点优势：

  • 无需部署 Exporter 和 Agent 即可监控 Spring Boot Actuator 端点，支持自定义指标采集与告警规则。

  • 轻量化：相比传统 Prometheus + AlertManager 组合，HertzBeat 简化了部署和维护流程。

  • 无缝集成 Grafana，HertzBeat 将采集的时序数据实时推送至 Grafana 构建可视化仪表盘。

  • 监控+告警+通知功能整合联动，全协议覆盖 + 实时/周期阈值检测 + 多通道通知（钉钉/飞书/Webhook等）。

监控springboot应用的实践就到这里，当然对hertzbeat来说这个功能只是冰山一角，如果您觉得hertzbeat这个开源项目不错的话，欢迎在 GitHub 上点亮小星星哦✨

github: https://github.com/apache/hertzbeat

http://www.dtcms.com/a/283265.html

相关文章：

  • elf、axf、bin的区别与转换
  • freetds 解决连接SQL SERVER报错Unexpected EOF from the server
  • 基于组学数据的药物敏感性预测模型构建与验证
  • AI时代基础入门
  • 卷积神经网络（CNN）最本质的技术
  • 离线环境中将现有的 WSL 1 升级到 WSL 2
  • list类的常用接口实现及迭代器
  • [BJDCTF2020]Cookie is so stable
  • Mybatis07-缓存
  • 正确选择光伏方案设计软件：人力成本优化的关键一步
  • 聊聊自己的新书吧
  • lustre设置用户配额
  • 同态加密赋能大模型医疗文本分析：可验证延迟压缩的融合之道
  • xss-labs靶场前八关
  • C语言基础：循环练习题
  • Linux切换到Jenkins用户解决Jenkins Host key verification failed
  • Electron实现“仅首次运行时创建SQLite数据库”
  • 大语言模型幻觉检测：语义熵揭秘
  • [Mysql] Connector / C++ 使用
  • AutoMQ 正式通过 SOC 2 Type II 认证
  • 尚庭公寓-----day1 业务功能实现
  • 八、DMSP/OLS、NPP/VIIRS等夜间灯光数据能源碳排放空间化——碳排放空间分级、空间自相关
  • PyCharm高效入门指南
  • docker+小皮面板
  • TCP 三次握手与四次挥手笔记
  • 光伏气象数据驱动设计方案优化
  • Spider的用法
  • 搭建云途YTM32B1MD1芯片VSCODE+GCC + Nijia + Cmake+Jlink开发环境
  • Python设计模式深度解析：单例模式（Singleton Pattern）完全指南
  • 深度解析api-ms-win-crt-runtime-l1-1-0.dll：它是什么？为什么重要？如何修复？