菜单
文档breadcrumb arrow Grafana 文档breadcrumb arrow 升级 Grafanabreadcrumb arrow 升级到 v10.0
Enterprise Open source

升级到 Grafana v10.0

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

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

注意

某些版本可能存在破坏性变更。我们在以下文档中概述了这些变更：

新功能 文档或单独的

破坏性变更文档。

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

如果可以，我们建议您在测试或开发环境中测试 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 Grafana 数据库，请运行以下命令：

MySQL

bash

要备份或恢复 Postgres Grafana 数据库，请运行以下命令：
backup:
> mysqldump -u root -p[root_password] [grafana] > grafana_backup.sql

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

Postgres

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

要备份或恢复 Postgres Grafana 数据库，请运行以下命令：
backup:
> pg_dump grafana > grafana_backup

restore:
> psql grafana < grafana_backup

升级 Grafana

Debian

要升级通过 Debian 软件包 (.deb) 安装的 Grafana，请完成以下步骤：

在您当前的 Grafana 安装中，将您的自定义配置更改保存到名为 <grafana_install_dir>/grafana.ini 的文件中。

  1. 这使您能够在升级 Grafana 时不会丢失您的配置更改。

    下载最新版本的 Grafana。

  2. 运行以下 dpkg -i 命令。

  3. APT 仓库

    要备份或恢复 Postgres Grafana 数据库，请运行以下命令：
    wget <debian package url>
sudo apt-get install -y adduser
sudo dpkg -i grafana_<version>_amd64.deb

要升级通过 Grafana Labs APT 仓库安装的 Grafana，请完成以下步骤：

运行以下命令：

  1. 这使您能够在升级 Grafana 时不会丢失您的配置更改。

    下载最新版本的 Grafana。

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

    要备份或恢复 Postgres Grafana 数据库，请运行以下命令：
    sudo apt-get update
sudo apt-get upgrade

二进制 .tar 文件

要升级通过二进制 .tar.gz 软件包安装的 Grafana，请完成以下步骤：

在您当前的 Grafana 安装中，将您的自定义配置更改保存到自定义配置文件 custom.ini 或 grafana.ini 中。

  1. 下载二进制 .tar.gz 软件包。

    下载最新版本的 Grafana。

  2. 解压下载的软件包并覆盖现有文件。

  3. RPM 或 YUM

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

根据您的安装执行以下步骤之一。

  1. 这使您能够在升级 Grafana 时不会丢失您的配置更改。

    下载最新版本的 Grafana。

  2. 如果您下载了 RPM 软件包来安装 Grafana，请完成在 Red Hat, RHEL 或 Fedora 上安装 Grafana 或在 SUSE 或 openSUSE 上安装 Grafana 文档中的步骤来升级 Grafana。

    • 如果您使用了 Grafana YUM 仓库，请运行以下命令：

    • 如果您在 openSUSE 或 SUSE 上安装了 Grafana，请运行以下命令：

      要备份或恢复 Postgres Grafana 数据库，请运行以下命令：
      sudo yum update grafana

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

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

Docker

使用 Grafana 环境变量保存您的自定义配置；这是推荐的方法。或者，您可以通过访问已部署的容器手动查看您的配置文件。

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

    下载最新版本的 Grafana。

  2. 这是一个示例。您输入的参数取决于您如何配置 Grafana 容器。

    注意

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

    要备份或恢复 Postgres 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

在您当前的 Grafana 安装中，将您的自定义配置更改保存到名为 <grafana_install_dir>/conf/custom.ini 的文件中。

  1. 下载 Windows 二进制软件包。

    下载最新版本的 Grafana。

  2. 将软件包内容解压到您安装 Grafana 的位置。

  3. 当系统提示时，您可以覆盖现有文件和文件夹。

    Mac

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

在您当前的 Grafana 安装中，将您的自定义配置更改保存到自定义配置文件 custom.ini 中。

  1. 下载 Mac 二进制软件包。

    下载最新版本的 Grafana。

  2. 更新 Grafana 插件

  3. 当系统提示时，您可以覆盖现有文件和文件夹。

    Mac

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

运行以下命令更新插件：

技术说明

要备份或恢复 Postgres Grafana 数据库，请运行以下命令：
grafana cli plugins update-all

基于角色的访问控制变更

基于角色的访问控制 (RBAC) 现在始终启用，并且我们已经移除了禁用它的选项。

无需任何操作。

但是，如果出于任何原因您决定降级并禁用 RBAC，则在再次升级之前，您需要按照以下指南进行操作。

上述操作顺序（升级、降级、禁用 RBAC、再次升级）会导致旧版访问控制系统与基于角色的访问控制系统不同步。作为副作用，某些 Grafana 资源的权限（如仪表盘）可能会丢失。为防止这种情况发生，在再次升级 Grafana 之前，请执行以下步骤：

停止 Grafana。

  1. 在您的数据库中，运行以下 SQL 查询：
  2. sql
再次启动 Grafana。
DELETE
FROM builtin_role
where role_id IN (SELECT id
                  FROM role
                  WHERE name LIKE 'managed:%');

DELETE
FROM team_role
where role_id IN (SELECT id
                  FROM role
                  WHERE name LIKE 'managed:%');

DELETE
FROM user_role
where role_id IN (SELECT id
                  FROM role
                  WHERE name LIKE 'managed:%');

DELETE
FROM permission
where role_id IN (SELECT id
                  FROM role
                  WHERE name LIKE 'managed:%');

DELETE
FROM role
WHERE name LIKE 'managed:%';

DELETE
FROM migration_log
WHERE migration_id IN ('teams permissions migration',
                       'dashboard permissions',
                       'dashboard permissions uid scopes',
                       'data source permissions',
                       'data source uid permissions',
                       'managed permissions migration',
                       'managed folder permissions alert actions repeated migration',
                       'managed permissions migration enterprise');
  1. 用户名和电子邮件地址不区分大小写

Grafana 中现在将用户名和电子邮件地址视为不区分大小写。如果您没有使用 MySQL 作为数据库，用户尝试登录时可能会出现潜在的用户身份冲突。我们建议您提前使用Grafana CLI 工具处理用户冲突来解决任何潜在的冲突。

仪表盘预览功能移除

我们已移除在 Grafana 9.0 版本中通过功能标志引入的仪表盘预览功能。

dashboardPreviews 功能标志不再可用，可以安全地从 Grafana 服务器配置中移除。

但是，如果出于任何原因您决定降级并禁用 RBAC，则在再次升级之前，您需要按照以下指南进行操作。

此页面有帮助吗？