HertzBeat监控系统：使用MySQL替代H2数据库存储元数据指南

HertzBeat监控系统：使用MySQL替代H2数据库存储元数据指南

hertzbeat An open source, real-time monitoring system with custom-monitoring, high performance cluster, prometheus-like and agentless. 项目地址: https://gitcode.com/gh_mirrors/he/hertzbeat

前言

HertzBeat作为一款开源实时监控系统，默认使用内置的H2数据库存储监控元数据。但在生产环境中，H2数据库存在性能瓶颈和可靠性问题。本文将详细介绍如何将HertzBeat的元数据存储从H2迁移至更可靠的MySQL数据库。

MySQL环境准备

版本要求

HertzBeat要求MySQL版本为5.7或8.0+。执行以下命令验证版本：

mysql --version

Docker安装MySQL（可选）

对于没有MySQL环境的用户，推荐使用Docker快速部署：

docker run -d --name mysql \
 -p 3306:3306 \
-v /opt/data:/var/lib/mysql \
-e MYSQL_ROOT_PASSWORD=123456 \
--restart=always \
mysql:5.7

关键参数说明：

• -v：数据持久化目录映射
• -e：设置root用户密码
• --restart：容器自动重启策略

数据库配置

创建专用数据库

1. 连接MySQL服务器：

mysql -uroot -p123456

2. 创建UTF8MB4编码的数据库：

CREATE DATABASE hertzbeat 
DEFAULT CHARACTER SET utf8mb4 
COLLATE utf8mb4_general_ci;

注意：使用utf8mb4编码可确保完整支持所有Unicode字符，包括emoji表情符号。

驱动准备

获取MySQL JDBC驱动

1. 下载对应版本的MySQL Connector/J
2. 将jar包（如mysql-connector-java-8.0.25.jar）放置到：

hertzbeat/ext-lib/

提示：驱动版本应与MySQL服务器版本兼容，避免出现兼容性问题。

配置文件修改

关键配置项

修改hertzbeat/config/application.yml文件，替换数据源配置：

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: root
    password: 123456
    url: jdbc:mysql://mysql:3306/hertzbeat?useUnicode=true&characterEncoding=utf-8&allowPublicKeyRetrieval=true&useSSL=false

配置说明

1. 连接池配置：

   • max-lifetime：连接最大存活时间（毫秒）
   • 生产环境建议根据实际情况调整连接池参数

2. JPA配置：

   • database-platform：指定MySQL方言
   • show-sql：生产环境建议关闭SQL日志

3. URL参数：

   • useSSL=false：禁用SSL（内网环境）
   • allowPublicKeyRetrieval=true：兼容MySQL 8.0+认证方式

注意事项

1. 容器化部署：

   • 确保MySQL服务地址可从HertzBeat容器访问
   • 推荐使用Docker网络别名或实际IP地址

2. 性能优化：

   • 生产环境建议单独部署MySQL服务器
   • 根据监控规模调整MySQL配置参数

3. 数据迁移：

   • 首次切换会创建所有表结构
   • 如需保留H2数据，需手动导出导入

验证部署

启动HertzBeat后，可通过以下方式验证：

1. 检查启动日志是否有数据库连接错误
2. 登录MySQL查看hertzbeat库中的表是否创建成功
3. 通过Web界面(默认1157端口)验证功能正常

总结

将HertzBeat的元数据存储迁移到MySQL可显著提升系统的可靠性和扩展性。本文详细介绍了从环境准备到配置修改的全过程，帮助用户顺利完成数据库切换。对于大规模监控场景，建议进一步优化MySQL配置参数以获得最佳性能。

hertzbeat An open source, real-time monitoring system with custom-monitoring, high performance cluster, prometheus-like and agentless. 项目地址: https://gitcode.com/gh_mirrors/he/hertzbeat