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.Driver
      username: root
      password: 123456
      url: jdbc:postgresql://postgresql:5432/hertzbeat
      hikari:
        max-lifetime: 120000
    jpa:
      show-sql: false
      database-platform: org.eclipse.persistence.platform.database.PostgreSQLPlatform
      database: postgresql
      properties:
        eclipselink:
          logging:
            level: SEVERE

配置时序数据库服务

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

- warehouse:
    store:
      # 关闭默认JPA
      jpa:
        enabled: false
      # 启用 victoria-metrics
      victoria-metrics:
         enabled: true
         url: http://localhost:8428
         username: root
         password: root

4、启动

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

./startup.sh

SpringBoot 应用配置

开启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: true
     metrics:
       export:
         prometheus:
           enabled: true

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

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

验证端点

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

监控 SpringBoot 应用

新增 AUTO 监控

系统导航至「监控中心」→「新增监控」→「AUTO」→「Prometheus任务」
填写关键参数
- 目标Host：SpringBoot 应用服务器地址（不带协议头，例如: https://, http:// ）
- 端口：应用服务端口（例如: 8080）
- 端点路径：/actuator/prometheus
- 使用标签分类来管理任务，如添加env=test等业务相关标签
查看检测指标数据

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

Grafana可视化集成 (可选)

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 = true
   org_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面板嵌入第三方页面

在HertzBeat中配置Grafana

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

-  grafana:
     enabled: true
     url: http://127.0.0.1:3000
     username: admin
     password: admin

在 HertzBeat 监控中嵌入 Grafana 仪表盘

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

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

告警与通知联动

HertzBeat告警配置

系统页面 -> 告警 -> 阈值规则 -> 新增 -> 新增阈值
填写关键参数

HertzBeat 提供了 实时计算 和 计划周期 两种类型的阈值规则设置，这里我们以 计划周期 阈值规则为例。
- 阈值名称：阈值规则名称
- 阈值规则：填写指标监测的规则（支持 PromQL）
- 执行周期：周期性执行阈值计算的时间间隔
- 告警级别：触发阈值的告警级别,从低到高依次为: 警告-warning，严重-critical，紧急-emergency
- 触发次数：设置触发阈值多少次之后才会发送告警
- 告警内容：填写指标监测的告警内容
设置阈值规则

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

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

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

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

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