mirror of https://github.com/grafana/grafana
Docs: Updates Grafana Alerting upgrade topics (#50533)
* Updates Grafana Alerting upgrade topics * Run yarn prettier:write Co-authored-by: Armand Grillet <armand.grillet@outlook.com>pull/50551/head
brendamuir
3 years ago
committed by
GitHub
parent
f376c33903
commit
7e2870b7bb
@ -1,27 +1,31 @@ |
||||
--- |
||||
aliases: |
||||
- /docs/grafana/latest/alerting/migrating-alerts/ |
||||
description: Migrate Grafana alerts |
||||
title: Migrate to Grafana Alerting |
||||
weight: 113 |
||||
description: Upgrade Grafana alerts |
||||
title: Upgrade to Grafana Alerting |
||||
weight: 101 |
||||
--- |
||||
|
||||
# Migrate to Grafana Alerting |
||||
# Upgrade to Grafana Alerting |
||||
|
||||
Grafana Alerting is the default for new Cloud, Enterprise, and OSS installations. The new installations will only show the Grafana Alerting icon in the left navigation panel. |
||||
Grafana Alerting is enabled by default for new installations or existing installations whether or not legacy alerting is configured. |
||||
|
||||
Existing installations that upgrade to v9.0 will have Grafana Alerting enabled by default. |
||||
Existing installations that do not use legacy alerting will have Grafana Alerting enabled by default unless alerting is disabled in the configuration. |
||||
|
||||
| Grafana instance upgraded to v 90 | | |
||||
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |
||||
| Cloud | Existing Cloud installations with legacy dashboard alerting will have two alerting icons in the left navigation panel - the old alerting plugin icon and the new Grafana Alerting icon. During upgrade, existing alerts from the Cloud alerting plugin are migrated to Grafana Alerting. Once migration is complete, you can access aman manage the older alerts from the new alerting Grafana Alerting icon in the navigation panel. The (older) Cloud alerting plugin is uninstalled from your cloud instance. Contact customer support if you **do not wish** to migrate to Grafana Alerting for your Cloud stack. If you choose to use legacy alerting, use the You will see the new Grafana Alerting icon as well as the old Cloud alerting plugin in the left navigation panel. | |
||||
| Enterprise | Existing Enterprise instances using legacy alerting will have both the old (marked as legacy) and the new alerting icons in the navigation panel. During upgrade, existing legacy alerts are migrated to Grafana Alerting. If you wish, you can [opt-out]({{< relref "opt-out/" >}}) of Grafana Alerting and roll back to legacy alerting. In that case, you can manage your legacy alerts from the alerting icon marked as legacy. | |
||||
| OSS | Existing OSS installations with legacy dashboard alerting will have two alerting icons in the left navigation panel - the old alerting icon (marked as legacy) and the new Grafana Alerting icon. During upgrade, existing legacy alerts are migrated to Grafana Alerting. If you wish, you can [opt-out]({{< relref "opt-out/" >}}) of Grafana Alerting and roll back to legacy alerting. In that case, you can manage your legacy alerts from the alerting icon marked as legacy. | |
||||
Likewise, existing installations that use legacy alerting will be automatically upgraded to Grafana Alerting unless you have [opted out]({{< relref "opt-out/" >}})of Grafana Alerting before migration takes place. During the upgrade, legacy alerts are migrated to the new alerts type and no alerts or alerting data are lost. |
||||
|
||||
During migration from legacy alerting to unified alerting, the legacy alerts are updated to the new alerts type, as a result, the user does not lose alerts or alerting data. However, if a user rolls back to legacy alerting after having migrated to unified alerting, they will only get the legacy alerts they had right before migration. |
||||
Once the upgrade has taken place, you still have the option to roll back [roll back]({{< relref "roll-back/" >}}) to legacy alerting. However, we do not recommend choosing this option. If you do choose to roll back, Grafana will restore your alerts to the alerts you had at the point in time when the upgrade took place. All new alerts and changes made exclusively in Grafana Alerting will be deleted. |
||||
|
||||
## Roll back to legacy alerting |
||||
> **Note**: Cloud customers, who do not want to upgrade to Grafana Alerting, should contact customer support. |
||||
|
||||
Although we encourage you to use Grafana Alerting, roll back to legacy alerting is supported in Grafana 9. Rolling back can result in data loss (you will loose all alerts that you created using Grafana Alerting). This is applicable to the fresh installation as well as upgraded setups. |
||||
If you have opted out or rolled back, you can always choose to opt in [opt in]({{< relref "opt-in/" >}}) to Grafana Alerting at a later point in time. |
||||
|
||||
The following table provides details on the upgrade for Cloud, Enterprise, and OSS installations and the new Grafana Alerting UI. |
||||
|
||||
| Grafana instance upgraded to 9.0 | | |
||||
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | |
||||
| Cloud | Existing Cloud installations with legacy dashboard alerting will have two alerting icons in the left navigation panel - the old alerting plugin icon and the new Grafana Alerting icon. During upgrade, existing alerts from the Cloud alerting plugin are migrated to Grafana Alerting. Once migration is complete, you can access and manage the older alerts from the new alerting Grafana Alerting icon in the navigation panel. The (older) Cloud alerting plugin is uninstalled from your cloud instance. Contact customer support if you **do not wish** to migrate to Grafana Alerting for your Cloud stack. If you choose to use legacy alerting, use the You will see the new Grafana Alerting icon as well as the old Cloud alerting plugin in the left navigation panel. | |
||||
| Enterprise | Existing Enterprise instances using legacy alerting will have both the old (marked as legacy) and the new alerting icons in the navigation panel. During upgrade, existing legacy alerts are migrated to Grafana Alerting. If you wish, you can [opt-out]({{< relref "opt-out/" >}}) of Grafana Alerting and roll back to legacy alerting. In that case, you can manage your legacy alerts from the alerting icon marked as legacy. | |
||||
| OSS | Existing OSS installations with legacy dashboard alerting will have two alerting icons in the left navigation panel - the old alerting icon (marked as legacy) and the new Grafana Alerting icon. During upgrade, existing legacy alerts are migrated to Grafana Alerting. If you wish, you can [opt-out]({{< relref "opt-out/" >}}) of Grafana Alerting and roll back to legacy alerting. In that case, you can manage your legacy alerts from the alerting icon marked as legacy. | |
||||
|
||||
> **Note:** Legacy alerting will be deprecated in a future release (v10). |
||||
|
||||
@ -0,0 +1,23 @@ |
||||
--- |
||||
aliases: |
||||
- /docs/grafana/latest/alerting/migrating-alerts/disable-alerting/ |
||||
- /docs/grafana/latest/alerting/disable-alerting/ |
||||
- /docs/grafana/latest/alerting/unified-alerting/disable-alerting/ |
||||
description: Disable alerting in Grafana |
||||
title: Disable alerting in Grafana |
||||
weight: 105 |
||||
--- |
||||
|
||||
# Disable alerting in Grafana |
||||
|
||||
To disable alerting in Grafana entirely (including both legacy and Grafana Alerting), enter the following in your configuration: |
||||
|
||||
``` |
||||
[alerting] |
||||
enabled = false |
||||
|
||||
[unified_alerting] |
||||
enabled = false |
||||
``` |
||||
|
||||
If at any time you want to turn alerting back on, you can opt in. |
||||
@ -0,0 +1,25 @@ |
||||
--- |
||||
aliases: |
||||
- /docs/grafana/latest/alerting/migrating-alerts/opt-in/ |
||||
- /docs/grafana/latest/alerting/opt-in/ |
||||
- /docs/grafana/latest/alerting/unified-alerting/opt-in/ |
||||
description: Opt in to Grafana Alerting |
||||
title: Opt in to Grafana Alerting |
||||
weight: 104 |
||||
--- |
||||
|
||||
# Opt in to Grafana Alerting |
||||
|
||||
If you have previously disabled alerting in Grafana, or opted out of Grafana Alerting and have decided that you would now like to use Grafana Alerting, you can choose to opt in at any time. |
||||
|
||||
If you have been using legacy alerting up until now your existing alerts will be migrated to the new alerts type and no alerts or alerting data are lost. Even if you choose to opt in to Grafana Alerting, you can roll back to legacy alerting at any time. |
||||
|
||||
To opt in to Grafana Alerting, enter the following in your configuration: |
||||
|
||||
``` |
||||
[alerting] |
||||
enabled = false |
||||
|
||||
[unified_alerting] |
||||
enabled = true |
||||
``` |
||||
@ -0,0 +1,29 @@ |
||||
--- |
||||
aliases: |
||||
- /docs/grafana/latest/alerting/migrating-alerts/roll-back/ |
||||
- /docs/grafana/latest/alerting/opt-in/ |
||||
- /docs/grafana/latest/alerting/unified-alerting/roll-back/ |
||||
description: Roll back to legacy alerting |
||||
title: Roll back to legacy alerting |
||||
weight: 103 |
||||
--- |
||||
|
||||
# Roll back to legacy alerting |
||||
|
||||
Once the upgrade has taken place, you still have the option to roll back to legacy alerting. If you choose to roll back, Grafana will restore your alerts to the alerts you had at the point in time when the upgrade took place. |
||||
|
||||
All new alerts and changes made exclusively in Grafana Alerting will be deleted. |
||||
|
||||
To roll back to legacy alerting, enter the following in your configuration: |
||||
|
||||
``` |
||||
force_migration = true |
||||
|
||||
[alerting] |
||||
enabled = true |
||||
|
||||
[unified_alerting] |
||||
enabled = false |
||||
``` |
||||
|
||||
> **Note**: We do not recommend this option. If you choose to roll back, Grafana will restore your alerts to the alerts you had at the point in time when the upgrade took place. All new alerts and changes made exclusively in Grafana Alerting will be deleted. |
||||
Loading…
Reference in new issue