HertzBeat 1.6.0 版本升级全面指南

HertzBeat 1.6.0 版本升级全面指南

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 作为一款开源的实时监控系统，在 1.6.0 版本中带来了多项重要更新。本文将详细介绍从 1.5.0 版本升级到 1.6.0 的完整流程，帮助用户顺利完成升级工作。

升级前准备

在开始升级前，请确保：

1. 已备份当前环境的所有重要数据
2. 了解 1.6.0 版本的主要变更点
3. 确认当前版本为 1.5.0（如为更早版本需先升级到 1.5.0）

Java 环境升级

1.6.0 版本要求 Java 17 运行环境，这是与之前版本最大的不同点之一。

环境检查

首先检查当前 Java 版本：

java -version

升级方案

根据服务器环境不同，有以下几种升级方案：

1. 服务器已使用 Java 17

   • 无需额外操作

2. 服务器使用 Java 8/11 且可升级

   • 下载 Java 17 安装包
   • 更新系统环境变量指向新 Java 版本

3. 服务器需保留旧 Java 版本

   • 下载 Java 17 并解压
   • 将文件夹重命名为 java 并复制到 HertzBeat 安装目录下

数据库升级

1.6.0 版本对数据库结构进行了调整，需要执行升级脚本：

1. 根据使用的数据库类型（MySQL/H2等）选择对应的升级脚本
2. 执行 V160__update_column.sql 文件

配置文件更新

1.6.0 版本对配置文件进行了较大调整，建议直接使用新版配置文件再根据需求修改。

application.yml 配置

主要修改数据库连接部分：

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

sureness.yml 配置

主要用于账户认证配置，可按需修改：

account:
  - appId: admin
    credential: hertzbeat
    role: [admin]

数据库驱动补充

由于许可证限制，1.6.0 版本不再内置部分数据库驱动，需要手动添加：

1. 下载对应数据库驱动（MySQL/Oracle等）
2. 将驱动 JAR 文件放入 ext-lib 目录

Docker 环境升级

MySQL 数据库方案

1. 停止旧容器
2. 执行数据库升级脚本
3. 挂载新版配置文件
4. 添加数据库驱动到 ext-lib 目录

H2 数据库方案（不推荐生产使用）

1. 停止旧容器
2. 导出 H2 数据库数据
3. 使用 H2 工具执行升级
4. 挂载新版配置文件

替代升级方案：导出导入

对于不想执行复杂升级流程的用户，可以采用导出导入方式：

1. 部署全新 1.6.0 环境
2. 从旧环境导出监控任务和阈值配置
3. 导入到新环境

升级后验证

升级完成后，建议进行以下验证：

1. 检查所有监控任务是否正常运行
2. 验证告警功能是否正常
3. 确认系统性能指标采集无误

常见问题解决

1. Java 版本不兼容

   • 确认 Java 17 已正确安装并配置

2. 数据库连接失败

   • 检查驱动是否正确放置
   • 验证连接参数是否正确

3. 配置文件格式错误

   • 使用新版配置文件模板
   • 注意 YAML 格式缩进

结语

HertzBeat 1.6.0 版本带来了多项改进和新特性，通过本文的详细升级指南，用户可以顺利完成版本升级。如果在升级过程中遇到任何问题，建议查阅相关文档或寻求社区支持。

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