Grafana Cloud 迁移助手
Grafana Cloud 迁移助手从 Grafana v12.0 起正式发布,它可以自动将资源从您的 Grafana OSS/Enterprise 实例迁移到 Grafana Cloud。它提供以下功能:
- 安全地将您的自行管理实例连接到 Grafana Cloud 实例。
- 通过几个简单的步骤将仪表盘、数据源和文件夹等资源无缝迁移到您的 Cloud 实例。
- 实时查看资源的迁移状态。
迁移助手的优点包括:
- 易于使用
- 按照 UI 提供的步骤,无需使用 Grafana API 或脚本,即可轻松将所有资源迁移到 Grafana Cloud。
- 安全
- 加密并安全地将资源迁移到您连接的 Grafana Cloud 实例。
- 快速
- 在几分钟内迁移您的所有资源,加速您向 Grafana Cloud 的过渡。
支持的资源
迁移助手支持以下资源:
- 仪表盘
- 文件夹
- 数据源
- 应用插件
- 面板插件
- 库面板
- Grafana 告警资源
开始之前
要使用 Grafana 迁移助手,您需要:
- Grafana v11.2 或更高版本,并启用
onPremToCloudMigrations
功能开关。在 Grafana 11.5 中,此功能默认启用。有关如何启用功能开关的更多信息,请参阅配置功能开关。 - Grafana Cloud Stack,您打算将资源迁移到其中。
Admin
访问权限到 Grafana Cloud Stack。要检查您的访问级别,请访问https://grafana.org.cn/orgs/<YOUR-ORG-NAME>/members
。- Grafana 服务器管理员访问权限到您现有的 Grafana OSS/Enterprise 实例。要检查您的访问级别,请访问
https://<GRAFANA-ONPREM-URL>/admin/users
。 - 从您现有的 Grafana OSS/Enterprise 实例访问互联网。
访问迁移助手
在 Grafana OSS 中,对迁移助手的访问仅限于服务器管理员。
在 Grafana Enterprise 版中,服务器管理员默认拥有迁移助手的访问权限。还可以使用基于角色的访问控制 (RBAC) 角色授予其他管理员访问权限,该角色允许 Grafana 实例上的其他管理员查看、构建快照并将资源上传到 Grafana Cloud。
在 Grafana Enterprise 版中授予访问权限
重要
在授予其他管理员访问 Grafana 迁移助手的权限之前,您必须配置 RBAC。
要在 Grafana Enterprise 版中授予其他管理员访问迁移助手的权限:
以服务器管理员身份登录 Grafana。
在 Grafana 侧边栏中导航到 Home > Administration > Users and access > Users。
单击一个管理员。
在 Organizations 部分,单击 Change role。
在 Migration Assistant 下的角色选择菜单中选择 Organization resource migrator。
单击 Apply。
使用迁移助手
您可以使用迁移助手在 Grafana Cloud 实例上生成迁移令牌,使用该令牌将自行管理的 Grafana 实例连接到 Grafana Cloud 实例,构建自行管理的 Grafana 实例的快照,并将这些快照上传到 Grafana Cloud。
在目标 Cloud 实例上生成迁移令牌
- 在您打算迁移资源的 Cloud 实例中,导航到 Home > Administration > General > Migrate to Grafana Cloud。
- 单击 Generate a migration token 按钮。
- 通过复制到剪贴板来复制迁移令牌。此令牌用于验证您的自行管理实例与 Grafana Cloud Stack 的身份。
将您的自行管理 Grafana 实例连接到 Grafana Cloud Stack
在您的自行管理 Grafana 实例上,导航到 Home > Administration > General > Migrate to Grafana Cloud。
单击 Migrate this instance to Cloud 按钮。
在 Migration token 字段中输入您的令牌,然后单击 Connect to this Stack。
构建快照
连接到 Cloud Stack 后,这是迁移助手的初始状态。您需要创建自行管理 Grafana 实例的快照,以便将其上传到 Cloud Stack。
从 Grafana v12.0 起,选择您想要迁移到 Cloud Stack 的每个资源旁边的复选框。
注意
某些资源无法单独上传到您的 Cloud Stack,因为它们依赖于其他资源
期望的资源 需要 仪表盘 - 库元素
- 数据源
- 插件
- 文件夹
库元素 文件夹 数据源 插件 插件 其他都不需要 文件夹 其他都不需要 所有告警规则组 所有其他资源 告警规则 - 仪表盘
- 库元素
- 数据源
- 插件
- 文件夹
- 通知策略
- 通知模板
- 联系点
- 静默时间
通知策略 - 通知模板
- 联系点
通知模板 其他都不需要 联系点 通知模板 静默时间 其他都不需要 在 Grafana v11.2 至 v11.6 中,您无法选择快照中包含的特定资源,例如只选择仪表盘。所有支持的资源默认包含在内。
单击 Build snapshot
上传资源到 Cloud
快照创建后,会显示一个资源列表,其中资源类型和状态都填充为 Not yet uploaded。
单击 Upload snapshot 将资源复制到 Grafana Cloud 实例。
使用助手的实时进度跟踪来监控迁移。成功复制到 Cloud 的资源状态将更改为“Uploaded to cloud”。
从 Grafana v12.0 起,您可以在迁移期间和之后对资源进行分组和排序
- 单击 Name 按字母顺序排序资源。
- 单击 Type 按资源类型分组和排序。
- 单击 Status 按上传状态分组和排序(待上传、成功上传或出现错误)。
快照信息也会更新,告知用户总资源数、错误数和成功迁移的资源总数。
查看错误详情以了解需要手动解决的任何问题。
迁移助手创建的快照
迁移助手目前仅支持 Grafana 中所有资源的一部分。有关更多详细信息,请参阅支持的资源。
当您创建快照时,迁移助手会复制您选择的所有资源并将其保存在快照中。快照反映了构建时资源的当前状态,并存储在您的实例本地,准备在最后阶段上传。
注意
在 Grafana v11.2 至 v11.6 中,您无法选择快照中包含的特定资源,例如只选择仪表盘。所有支持的资源默认包含在内。
快照中保存的资源严格限于组织内存储的资源。如果您的 Grafana 实例使用多个组织,这一点很重要。如果您想迁移多个组织,请参阅迁移多个组织以获取更多信息和指导。
资源迁移详情
在迁移过程中,资源 UID 会被保留,允许您关联本地和 Cloud 资源。如果您多次执行相同的迁移,您 Grafana Cloud Stack 中之前迁移过的资源将得到更新。助手绝不会修改您的自行管理资源或非快照来源的 Cloud 资源。
仪表盘和文件夹
仪表盘名称和 UID 以及对数据源的引用都会被保留。文件夹层次结构也会被保留,因此您可以找到保存在相同文件夹位置的仪表盘和其他资源。
数据源
您的数据源,包括凭据,都会安全无缝地迁移到您的 Grafana Cloud 实例,因此您无需再次查找并输入所有数据源凭据。
插件
迁移助手支持插件目录中的任何插件。只要插件经过签名或是由 Grafana 内置的核心插件,就可以迁移。出于安全原因,Grafana Cloud 不支持未签名插件。如果您正在使用任何未签名的私有插件,Grafana 建议您从目录中寻找替代插件,或制定策略以弃用自行管理实例中的某些功能。
在使用迁移助手之前,请升级您打算迁移的任何插件,因为迁移后的插件将在 Grafana Cloud 实例上配置为该插件的最新版本。
注意
如果您想迁移 Enterprise 版插件,请检查您的 Grafana Cloud 实例属于哪种计划,以及此计划是否需要 Enterprise 版插件附加项。
Grafana 告警资源
迁移助手可以将大部分 Grafana 告警资源迁移到您的 Grafana Cloud 实例。这包括:
- 告警规则
- 通知
- 联系点
- 静默时间
- 通知策略树
- 通知模板
这足以使您的告警配置在 Grafana Cloud 中正常运行,且只需最少的努力。
迁移助手不支持迁移静默,需要手动配置。告警历史也无法迁移。
成功将告警资源迁移到 Grafana Cloud 实例可能会导致生成两套通知:
来自您的 OSS/Enterprise 实例
来自 Grafana Cloud 实例中新迁移的告警
为了避免双重通知,custom.ini
或 grafana.ini
文件中的新配置选项 alert_rules_state
控制告警规则迁移到 Grafana Cloud 实例时的状态,默认为 paused
,这样您可以在 Grafana Cloud 实例中审查和测试告警资源,而不会收到重复通知。
alert_rule_state
的可用选项包括:
paused
- 在 Cloud 实例上创建所有告警规则时处于暂停状态。这有助于避免双重通知。
unchanged
- 告警规则保持其来自源实例的原始状态。
当您准备好开始使用 Grafana Cloud 实例中的告警规则和通知时,使用 alert_rules_state = unchanged
再次运行迁移。
资源权限
由于迁移助手目前尚不支持迁移团队或 RBAC 权限,您的资源将以默认权限迁移。请确保在迁移后根据需要在 Cloud Stack 中重新配置权限。有关更多信息,请参阅Grafana Cloud 用户角色和权限。
迁移多个组织
如果您在 Grafana 实例上使用了组织功能并打算迁移到 Grafana Cloud,您需要仔细规划这一迁移方面。
Grafana Cloud 不支持组织功能,但可以使用文件夹和 RBAC 来保护和授予资源权限。推荐的路径是将多个组织迁移到单个 Cloud Stack。这是最简单的选项,并提供最佳用户体验。
迁移助手根据特定组织内的资源创建和上传快照。无法一次性迁移包含多个组织的整个 Grafana 实例。对于您想迁移的每个组织,您都需要运行一次迁移过程。
Grafana 服务器管理员默认拥有迁移助手的访问权限。服务器管理员可以通过切换组织并每次运行迁移助手来执行迁移。Grafana 服务器管理员还可以使用 RBAC 角色 Migration Assistant:Organization resource migrator 将迁移助手的访问权限授予作为成员的组织管理员。这允许这些组织管理员运行其各自组织的迁移过程。
Cloud 实例中的访问控制和资源管理
最初设置组织的主要动机是资源隔离。为了在 Grafana Cloud 中实现这一点,您可以将资源组织到文件夹中,并设置与您的组织相对应的团队和权限。
有关配置团队和权限的更多信息,请参阅配置 Grafana 团队。