mirror of
https://github.com/grafana/grafana.git
synced 2026-01-07 22:41:10 +08:00
Docs: Updating cloud migration docs ahead of G12 (#103835)
Co-authored-by: Michael Mandrus <41969079+mmandrus@users.noreply.github.com>
This commit is contained in:
Jacob Valdez
GitHub
@@ -11,7 +11,7 @@ weight: 400
|
||||
|
||||
# Grafana Cloud Migration Assistant
|
||||
|
||||
The Grafana Cloud Migration Assistant is available in Grafana 11.2+ as a [public preview feature](https://grafana.com/docs/release-life-cycle/#public-preview) that automatically migrates resources from your Grafana OSS/Enterprise instance to Grafana Cloud. It provides the following functionalities:
|
||||
The Grafana Cloud Migration Assistant, generally available from Grafana v12.0, automatically migrates resources from your Grafana OSS/Enterprise instance to Grafana Cloud. It provides the following functionality:
|
||||
|
||||
- Securely connect your self-managed instance to a Grafana Cloud instance.
|
||||
- Seamlessly migrate resources such as dashboards, data sources, and folders to your cloud instance in a few easy steps.
|
||||
@@ -82,9 +82,6 @@ You can use the migration assistant to generate a migration token on your Grafan
|
||||
|
||||
1. Navigate to **Home** > **Administration** > **General** > **Migrate to Grafana Cloud** in the cloud instance where you intend to migrate your resources.
|
||||
1. Click on the **Generate a migration token** button.
|
||||
|
||||
|
||||
|
||||
1. Make a copy of the migration token by copying to clipboard. The token is required to authenticate your self-managed instance with the Grafana Cloud Stack.
|
||||
|
||||
### Connect your self-managed Grafana instance to the Grafana Cloud Stack
|
||||
@@ -93,33 +90,50 @@ You can use the migration assistant to generate a migration token on your Grafan
|
||||
|
||||
1. Click the **Migrate this instance to Cloud** button.
|
||||
|
||||
|
||||
|
||||
1. Enter your token and click **Connect to this Stack**.
|
||||
|
||||
|
||||
1. Enter your token in the **Migration token** field and click **Connect to this Stack**.
|
||||
|
||||
### Build a snapshot
|
||||
|
||||
After connecting to the cloud stack, this is the empty state of the migration assistant. You need to create a snapshot of the self-managed Grafana instance to upload it to the cloud stack.
|
||||
|
||||
- Click **Build snapshot**
|
||||
1. Select the checkbox next to each resource you want to migrate to your cloud stack.
|
||||
{{< admonition type="note" >}}
|
||||
Some resources can't be uploaded to your cloud stack alone because they rely on other resources:
|
||||
| Desired resource | Requires |
|
||||
| :---- | :---- |
|
||||
| Dashboards | <ul><li>Library Elements</li> <li>Data Sources</li> <li>Plugins</li> <li>Folders</li></ul> |
|
||||
| Library Elements | Folders |
|
||||
| Data Sources | Plugins |
|
||||
| Plugins | Nothing else |
|
||||
| Folders | Nothing else |
|
||||
| All Alert rule groups | All other resources |
|
||||
| Alert Rules | <ul><li>Dashboards</li> <li>Library Elements</li> <li>Data Sources</li> <li>Plugins</li> <li>Folders</li> <li>Notification Policies</li> <li>Notification Templates</li> <li>Contact Points</li> <li>Mute Timings</li></ul> |
|
||||
| Notification Policies | <ul><li>Notification Templates</li> <li>Contact Points</li></ul> |
|
||||
| Notification Templates | Nothing else |
|
||||
| Contact Points | Notification Templates |
|
||||
| Mute Timings | Nothing else |
|
||||
{{< /admonition >}}
|
||||
1. Click **Build snapshot**
|
||||
|
||||
|
||||
|
||||
|
||||
### Upload resources to the cloud
|
||||
|
||||
After a snapshot is created, a list of resources appears with resource Type and Status populated with **Not yet uploaded**.
|
||||
|
||||
|
||||
1. Click on **Upload snapshot** to copy the resources to the Grafana Cloud instance.
|
||||
|
||||
1. Click on **Upload snapshot** to copy the resources to the Grafana Cloud instance. This also updates statuses for the list of resources. The status changes to 'Uploaded to cloud' for resources successfully copied to the cloud.
|
||||
1. Use the assistant's real-time progress tracking to monitor the migration. The status changes to 'Uploaded to cloud' for resources successfully copied to the cloud.
|
||||
|
||||
You can group and sort resources during and after the migration:
|
||||
|
||||
- Click **Name** to sort resources alphabetically.
|
||||
- Click **Type** to group and sort by resource type.
|
||||
- Click **Status** to group and sort by upload status (pending upload, uploaded successfully, or experienced errors).
|
||||
|
||||
The Snapshot information also updates to inform the user of total resources, errors, and total number of successfully migrated resources.
|
||||
|
||||
|
||||
|
||||
1. Use the assistant's real-time progress tracking to monitor the migration.
|
||||
|
||||
|
||||
1. Review error details for any issues that need manual resolution.
|
||||
|
||||
|
||||
@@ -17,6 +17,10 @@ This migration guide is designed to assist Grafana OSS/Enterprise users in seaml
|
||||
There isn't yet a standard method for importing existing data into Grafana Cloud from self-managed databases.
|
||||
{{< /admonition >}}
|
||||
|
||||
{{< admonition type="tip" >}}
|
||||
You can use the [Grafana Cloud Migration Assistant](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/administration/migration-guide/cloud-migration-assistant/), generally available in Grafana v12, to automatically migrate your resources to Grafana Cloud.
|
||||
{{< /admonition >}}
|
||||
|
||||
## Plan and perform a manual migration
|
||||
|
||||
If you need to migrate resources beyond what is supported by the Grafana Cloud Migration Assistant, you can migrate them manually with this guide. Moving your team from Grafana OSS/Enterprise to Grafana Cloud manually involves some coordination and communication in addition to the technical migration in the following documentation.
|
||||
@@ -29,13 +33,13 @@ You may choose to test Grafana Cloud for some time before migrating your entire
|
||||
|
||||
When you decide to migrate, set aside a day of cutover during which users should not create new dashboards or alerts. Migrate any newly-created resources, turn on your production Alerting contact points and notification policies in Cloud and turn them off in Grafana OSS/Enterprise, and notify your users. You may also choose to redirect the Grafana OSS/Enterprise URL to your Grafana Cloud URL.
|
||||
|
||||
| Component | Migration Effort | Notes |
|
||||
| ------------ | ---------------- | -------------------------------------------------------------------------- |
|
||||
| Folders | Low | |
|
||||
| Dashboards | Low | Data source references might need to be renamed |
|
||||
| Alerts | Medium | Data source based alerts might need to be adapted |
|
||||
| Plugins | Medium | Depends on the feature set of the plugin |
|
||||
| Data sources | High | If the data sources references any secrets, you need to provide them again |
|
||||
| Component | Migration Effort | Notes |
|
||||
| ------------ | ---------------- | ------------------------------------------------------------------------- |
|
||||
| Folders | Low | |
|
||||
| Dashboards | Low | Data source references might need to be renamed |
|
||||
| Alerts | Medium | Data source based alerts might need to be adapted |
|
||||
| Plugins | Medium | Depends on the feature set of the plugin |
|
||||
| Data sources | High | If the data sources reference any secrets, you need to provide them again |
|
||||
|
||||
## Before you begin
|
||||
|
||||
|
||||
Reference in New Issue
Block a user