Alerting docs: updates to default and advanced options (#93999)

* Alerting docs: updates to default and advanced options

* feedback sonia
This commit is contained in:
brendamuir 2024-09-30 16:41:44 +02:00 committed by GitHub
parent b7a7f2bd62
commit bb41ff267b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -86,23 +86,23 @@ Multiple alert instances can be created as a result of one alert rule (also know
For Grafana Cloud Free Forever, you can create up to 100 free Grafana-managed alert rules with each alert rule having a maximum of 1000 alert instances.
{{% /admonition %}}
Grafana managed alert rules can only be edited or deleted by users with Edit permissions for the folder storing the rules.
Grafana-managed alert rules can only be edited or deleted by users with Edit permissions for the folder storing the rules.
If you delete an alerting resource created in the UI, you can no longer retrieve it.
If you delete an alert resource created in the UI, you can no longer retrieve it.
To make a backup of your configuration and to be able to restore deleted alerting resources, create your alerting resources using file provisioning, Terraform, or the Alerting API.
## Before you begin
You can use Simple or Advanced modes for Grafana-managed alert rule creation. The Simple mode streamlines rule creation with a cleaner header and a single query and condition. For more complex rules, switch to Advanced mode to add multiple queries and expressions.
You can use default or advanced options for Grafana-managed alert rule creation. The default options streamline rule creation with a cleaner header and a single query and condition. For more complex rules, use advanced options to add multiple queries and expressions.
Simple and advanced modes are enabled by default for Grafana Cloud users and this feature is being rolled out progressively.
Default and advanced options are enabled by default for Grafana Cloud users and this feature is being rolled out progressively.
For OSS users,enable the `alertingQueryAndExpressionsStepMode` feature toggle.
{{% admonition type="note" %}}
Once you have created an alert rule using one of the modes, the system defaults to this mode for the next alert rule you create.
Once you have created an alert rule using one of the options, the system defaults to this option for the next alert rule you create.
You can toggle between the two options. However, if you want to switch from Advanced to Simple mode and you have more than one query or a custom recovery threshold, your data is removed as it's not possible to transform these queries and expressions to the Simple mode.
You can toggle between the two options. However, if you want to switch from advanced options to the default, it may be that your query and expressions cannot be converted. In this case, a warning message checks whether you want to continue to reset to default settings.
{{% /admonition %}}
## Steps
@ -122,7 +122,7 @@ To get started quickly, refer to our [tutorial on getting started with Grafana a
Define a query to get the data you want to measure and a condition that needs to be met before an alert rule fires.
{{< collapse title="Simple mode" >}}
{{< collapse title="Default options" >}}
1. Add a query.
1. Add an alert condition.
@ -132,7 +132,7 @@ Define a query to get the data you want to measure and a condition that needs to
1. Click **Preview** to verify.
{{< /collapse >}}
{{< collapse title="Advanced mode" >}}
{{< collapse title="Advanced options" >}}
1. Select a data source.
1. From the **Options** dropdown, specify a [time range](ref:time-units-and-relative-ranges).