HertzBeat项目：使用MySQL替代H2数据库存储元数据指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01054/article/details/148487132

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作为内置数据库存储监控元数据。然而，对于生产环境或需要更高可靠性的场景，使用MySQL这样的专业关系型数据库是更好的选择。本文将详细介绍如何将HertzBeat的元数据存储从H2迁移到MySQL。

MySQL环境准备

版本要求

HertzBeat仅支持MySQL 5.7及以上版本，包括MySQL 8.x系列。使用前请确认您的MySQL版本：

mysql --version

使用Docker安装MySQL（可选）

如果本地没有MySQL环境，可以通过Docker快速搭建：

首先确保已安装Docker环境
执行以下命令启动MySQL容器：

docker run -d --name mysql \
 -p 3306:3306 \
 -v /your/local/path:/var/lib/mysql \
 -e MYSQL_ROOT_PASSWORD=yourpassword \
 --restart=always \
 mysql:5.7

注意事项：

/your/local/path应替换为实际的本地持久化目录
启动后可通过docker ps命令验证容器状态

数据库配置

创建专用数据库

连接到MySQL服务器：
```
mysql -uroot -pyourpassword
```

执行创建数据库命令：

CREATE DATABASE hertzbeat DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_general_ci;

验证数据库是否创建成功：
```
SHOW DATABASES;
```

准备JDBC驱动

下载MySQL JDBC驱动（推荐8.0.x版本）
将下载的mysql-connector-java-x.x.xx.jar文件复制到HertzBeat的ext-lib目录下

修改HertzBeat配置

配置文件位置

根据安装方式不同，配置文件位置有所差异：

安装包方式：hertzbeat/config/application.yml
Docker方式：需要挂载本地的application.yml文件

关键配置修改

将原有的H2数据源配置替换为MySQL配置：

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    username: your_username
    password: your_password
    url: jdbc:mysql://your_mysql_host:3306/hertzbeat?useUnicode=true&characterEncoding=utf-8&allowPublicKeyRetrieval=true&useSSL=false
    hikari:
      max-lifetime: 120000
  jpa:
    show-sql: false
    database-platform: org.eclipse.persistence.platform.database.MySQLPlatform
    database: mysql
    properties:
      eclipselink:
        logging:
          level: SEVERE

重要参数说明：