升级到 v8.3

Enterprise Open source

升级到 Grafana v8.3

我们建议您经常升级 Grafana，以保持与最新修复和增强功能的同步。由于 Grafana 升级是向后兼容的，所以升级过程很简单，并且仪表盘和图表不会改变。

除了所有 Grafana 版本都应该完成的常见任务外，对于某些版本可能还需要完成额外的升级任务。

注意
在某些发布版本中可能存在破坏性更改。我们通常会在大多数发布版本的新功能文档中概述这些更改，对于包含许多破坏性更改的发布版本，则会发布单独的破坏性更改文档。
对于大多数版本，提供更新内容文档；对于包含大量重大变更的版本，则提供一份单独的
重大变更文档。

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

如果可用，我们会在变更日志 (Changelog) 中列出所有更改，并附带指向拉取请求或问题的链接。

注意
如果可能，我们建议您在测试或开发环境中测试 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 文件参数指定。

备份插件数据

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

Grafana 插件文件位于以下目录中

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

备份 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 文件参数指定。

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

技术说明

本节描述了与此 Grafana 版本相关的技术更改。

仪表盘引用

在 8.3 中，Grafana 仪表盘现在使用一个包含 uid 和 type 属性的对象引用数据源，而不是数据源名称属性。当现有仪表盘打开时，会应用模式迁移。如果您将仪表盘配置到多个 Grafana 实例，我们建议您也配置数据源。您可以指定不同实例的数据源使用相同的 uid。如果您需要找到在 UI 中创建的数据源的 uid，请检查数据源设置页面的 URL。URL 遵循模式 /data source/edit/${uid}，这意味着最后一部分就是 uid。