迁移 Grafana 配置数据库的核心在于完整同步数据目录和配置文件，但必须严格评估版本跨度。最稳妥的方式是在新服务器安装相同版本后覆盖数据，若涉及大版本升级，需遵循官方升级路径逐步迁移，避免数据库 Schema 不兼容导致服务无法启动。
先说结论：迁移核心在于完整同步 /var/lib/grafana 数据目录和 /etc/grafana/grafana.ini 配置文件，同时需评估版本升级路径以避免数据库结构不兼容。
- 适合场景：服务器硬件更换、Grafana 版本升级、后端数据库迁移（如 SQLite 转 PostgreSQL）。
- 先准备：备份旧服务器数据文件、记录当前版本号、检查插件列表。
- 验收标准：服务正常启动、历史仪表盘数据可查、告警规则无丢失。
前置检查与备份
操作前务必确认当前版本并验证备份完整性，避免迁移后发现数据损坏。
1. 查询版本
在旧服务器执行以下命令记录版本号，新服务器建议先安装相同版本：
grafana-server -v2. 停止服务并备份
停止服务防止数据写入不一致，打包数据目录和配置文件：
sudo systemctl stop grafana-server
sudo tar -czvf grafana_backup_$(date +%F).tar.gz /var/lib/grafana /etc/grafana/grafana.ini3. 验证备份
检查压缩包内容是否包含关键文件，确保备份可用：
tar -tzf grafana_backup_*.tar.gz | grep grafana.db迁移操作命令
以下是基于 Linux 系统的核心操作命令，假设新旧服务器均为 systemd 管理。注意新服务器安装版本应与旧服务器一致，或确认为支持的升级路径。
# 1. 新服务器安装 Grafana（建议通过官方源安装，避免版本过旧）
# 示例：Ubuntu 添加官方源后安装
sudo apt-get install -y apt-transport-https
sudo apt-get update
sudo apt-get install grafana# 2. 停止新服务
sudo systemctl stop grafana-server# 3. 恢复数据与配置（解压到临时目录再移动更安全，此处演示直接覆盖）
# 请先确保备份文件已上传至新服务器
sudo tar -xzvf grafana_backup.tar.gz -C /# 4. 修正权限（关键步骤，否则服务无法启动）
sudo chown -R grafana:grafana /var/lib/grafana
sudo chown grafana:grafana /etc/grafana/grafana.ini# 5. 启动服务
sudo systemctl start grafana-server版本兼容性风险
1. 大版本跨越风险
如果从旧版本（如 6.x）直接迁移到新版本（如 10.x+），直接拷贝 grafana.db 可能导致启动失败。官方建议逐步升级（例如 6->7->8->9->10），或在旧版本先导出 dashboard JSON，新版本重新导入。
2. 配置文件差异
新版本 grafana.ini 可能包含新的必填项或安全配置。直接覆盖旧配置可能导致新特性失效。建议保留新版本的配置文件模板，仅将旧配置中的自定义项（如数据源连接信息、认证配置）合并进去。
3. 插件兼容性
旧版插件可能无法在新版核心上运行。迁移后若面板显示异常，请尝试删除 /var/lib/grafana/plugins 目录并使用 grafana-cli plugins install [plugin-name] 重新安装兼容版本。
验证与排查
1. 服务状态检查
执行 sudo systemctl status grafana-server，确认服务处于 active (running) 状态。
2. 日志观察
查看日志文件 /var/log/grafana/grafana.log，重点排查以下错误：
migration failed：数据库版本不兼容，需检查升级路径。permission denied：目录权限未修正，需执行 chown 命令。plugin error：插件不兼容，需重新安装。
3. 功能验证
登录 Web 界面，检查原有仪表盘是否能正常加载数据，确认数据源连接状态为绿色，告警通知渠道是否正常工作。
参考来源
- Grafana 官方安装文档
- Grafana 官方升级指南
- Grafana 备份与恢复文档
原文链接：https://www.zjcp.cc/ask/11488.html