文档

Grafana 文档

升级 Grafana

升级到 v9.5

Enterprise 开源

升级到 Grafana v9.5

我们建议你经常升级 Grafana，以获取最新的修复和增强功能。由于 Grafana 升级向后兼容，升级过程很简单，仪表盘和图表不会改变。

除了适用于所有 Grafana 版本的常见任务外，特定版本可能还需要完成额外的升级任务。

注意
某些版本可能存在破坏性变更。我们在
大多数版本的“新特性”文档中或独立的
“破坏性变更”文档中概述了这些变更，特别是在有许多破坏性变更的版本中。

对于 v9.2 之前的 Grafana 版本，我们在发行说明中发布了附加信息。

如有可用，我们在更新日志中列出了所有变更，并附带指向 Pull Request 或 Issue 的链接。

注意
如有可能，我们建议你在测试或开发环境中测试 Grafana 升级过程。

备份 Grafana

本主题解释了如何备份本地 Grafana 部署，包括配置、插件数据和 Grafana 数据库。

备份 Grafana 配置文件

将你可能在 Grafana 部署中修改过的 Grafana 配置文件复制到备份目录。

Grafana 配置文件位于以下目录

默认配置: $WORKING_DIR/defaults.ini (请勿修改此文件)
自定义配置: $WORKING_DIR/custom.ini

有关查找配置文件的更多信息，请参阅配置文件位置。

注意
如果你使用 deb 或 rpm 包安装了 Grafana，则你的配置文件位于 /etc/grafana/grafana.ini。此路径在 Grafana init.d 脚本中通过 --config file 参数指定。

备份插件数据

在 Grafana 中安装插件会为每个插件创建一个包含其相关文件和数据的文件夹。将此位置的所有文件和文件夹递归复制到你的备份仓库。

Grafana 插件文件位于以下目录

二进制或源码安装中插件的默认位置: $WORKING_DIR/data/plugins
deb 或 rpm 包中插件的默认位置: /var/lib/grafana/plugins。此路径在 Grafana init.d 脚本中通过 --config file 参数指定。

备份 Grafana 数据库

我们建议你备份 Grafana 数据库，以便在需要时可以回滚到以前的版本。

SQLite

默认的 Grafana 数据库是 SQLite，它将数据存储在磁盘上的一个文件中。要备份此文件，请将其复制到你的备份仓库。

注意
为确保数据完整性，在备份 SQLite 数据库之前，请关闭 Grafana 服务。

SQLite 数据库文件位于以下目录之一

二进制或源码安装中 SQLite 数据的默认位置: $WORKING_DIR/data/grafana.db
deb 或 rpm 包中 SQLite 数据的默认位置: /var/lib/grafana/grafana.db。此路径在 Grafana init.d 脚本中通过 --config file 参数指定。

MySQL

要备份或恢复 MySQL Grafana 数据库，请运行以下命令

backup:
> mysqldump -u root -p[root_password] [grafana] > grafana_backup.sql

restore:
> mysql -u root -p grafana < grafana_backup.sql

Postgres

要备份或恢复 Postgres Grafana 数据库，请运行以下命令

backup:
> pg_dump grafana > grafana_backup

restore:
> psql grafana < grafana_backup

升级 Grafana

以下部分提供了根据你的安装方法升级 Grafana 的说明。有关查找配置文件的更多信息，请参阅配置文件位置。

Debian

要从 Debian 包 (.deb) 安装的 Grafana 进行升级，请完成以下步骤

在你当前的 Grafana 安装中，将你的自定义配置更改保存到名为 <grafana_install_dir>/grafana.ini 的文件中。
这使你能够在不丢失配置更改的情况下升级 Grafana。
下载最新版本的 Grafana。

运行以下 dpkg -i 命令。

wget <debian package url>
sudo apt-get install -y adduser
sudo dpkg -i grafana_<version>_amd64.deb

APT 仓库

要从 Grafana Labs APT 仓库安装的 Grafana 进行升级，请完成以下步骤

在你当前的 Grafana 安装中，将你的自定义配置更改保存到名为 <grafana_install_dir>/grafana.ini 的文件中。
这使你能够在不丢失配置更改的情况下升级 Grafana。

运行以下命令

sudo apt-get update
sudo apt-get upgrade

当你运行 apt-get upgrade 时，Grafana 会自动更新。

二进制 .tar 文件

要从二进制 .tar.gz 包安装的 Grafana 进行升级，请完成以下步骤

在你当前的 Grafana 安装中，将你的自定义配置更改保存到自定义配置文件 custom.ini 或 grafana.ini 中。
这使你能够在不丢失配置更改的情况下升级 Grafana。
下载二进制 .tar.gz 包。
解压下载的软件包并覆盖现有文件。

RPM 或 YUM

要使用 RPM 或 YUM 安装的 Grafana 进行升级，请完成以下步骤

在你当前的 Grafana 安装中，将你的自定义配置更改保存到名为 <grafana_install_dir>/grafana.ini 的文件中。
这使你能够在不丢失配置更改的情况下升级 Grafana。
根据你的安装方式执行以下其中一个步骤。
- 如果你下载了 RPM 包来安装 Grafana，则按照在 Red Hat, RHEL, 或 Fedora 上安装 Grafana 或在 SUSE 或 openSUSE 上安装 Grafana 中记载的步骤升级 Grafana。
- 如果你使用了 Grafana YUM 仓库，请运行以下命令
  bash
```
sudo yum update grafana
```
- 如果你在 openSUSE 或 SUSE 上安装了 Grafana，请运行以下命令
  bash
```
sudo zypper update
```

Docker

要升级在 Docker 容器中运行的 Grafana，请完成以下步骤

使用 Grafana 环境变量来保存你的自定义配置；这是推荐的方法。另外，你也可以通过访问已部署的容器手动查看你的配置文件。
这使你能够在不丢失配置更改的情况下升级 Grafana。

运行类似于以下命令的命令。

注意
这是一个示例。你输入的参数取决于你如何配置 Grafana 容器。

docker pull grafana/grafana
docker stop my-grafana-container
docker rm my-grafana-container
docker run -d --name=my-grafana-container --restart=always -v /var/lib/grafana:/var/lib/grafana grafana/grafana

Windows

要升级在 Windows 上安装的 Grafana，请完成以下步骤

在你当前的 Grafana 安装中，将你的自定义配置更改保存到名为 <grafana_install_dir>/conf/custom.ini 的文件中。
这使你能够在不丢失配置更改的情况下升级 Grafana。
下载 Windows 二进制包。
将包的内容解压到你安装 Grafana 的位置。
当出现提示时，你可以覆盖现有文件和文件夹。

Mac

要升级在 Mac 上安装的 Grafana，请完成以下步骤

在你当前的 Grafana 安装中，将你的自定义配置更改保存到自定义配置文件 custom.ini 中。
这使你能够在不丢失配置更改的情况下升级 Grafana。
下载 Mac 二进制包。
将包的内容解压到你安装 Grafana 的位置。
当出现提示时，你可以覆盖现有文件和文件夹。

更新 Grafana 插件

升级 Grafana 后，我们建议你更新所有插件，因为新版本的 Grafana 可能会导致旧插件无法正常工作。

运行以下命令更新插件

grafana cli plugins update-all

技术说明

InfluxDB 配置变更

从 v9.5 开始，InfluxDB 数据源弃用配置文件中的 database 字段。jsonData 下的 dbName 字段必须用于存储数据库信息。更多信息和示例，请参阅InfluxDB 配置。

仪表盘预览弃用通知

我们正在弃用仪表盘预览功能，并将在 Grafana v10 中移除它。我们已开始探索使用 Scenes 框架添加视觉预览的其他方式，未来我们将分享更多相关信息。

将你的 API 密钥迁移到服务账号

我们正在将 Grafana API 密钥升级为服务账号。服务账号是 API 密钥的超集，包含令牌轮换和与基于角色的访问控制的兼容性。在未来版本中，我们将自动将所有现有 API 密钥迁移到服务账号。你所有现有令牌将继续工作；它们将被简单地迁移到服务账号。你可以使用 Grafana 的 UI 或 API 将现有 API 密钥迁移到服务账号来抢先完成此更改。请在API 密钥文档中了解如何操作。