This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Documentation Grafana documentation Alerting Configure alert rules Create recording rules Migrate recorded queries

Migrate recorded queries

Users can transpose their now-depreciated recorded queries into Grafana-managed recording rules in a few easy steps. The query PromQL for each recorded query has been exposed on the recorded queries list along with the existing datasource, time range, and interval values to simplify the migration process.

Migrate your recorded queries to Grafana-managed alert rules

1. Navigate to Administration > Plugins and Data > Recorded queries.

2. Note the data source, query PromQL, interval, and time range, and copy them somewhere accessible.

3. Now navigate to Alerting > Alert rules.

4. In the Grafana-managed section of the Alert rules page, click + New recording.

   Add a name for your Recording Rule and a name for the new metric that the recording rule generates.

5. Select your data source and paste your ratio query PromQL into the query builder.

   Click Options and validate that the Time Range is the same as your recorded query.

6. Select the Folder you would like the rule to be created in.

7. Add any labels to the rule.

8. Select or create an evaluation group. Set your evaluation group’s evaluation interval to the interval of your recorded query.

9. Review your rule and click Save rule and exit when you are finished.

10. Update any areas where the recorded query was referenced to use the new Grafana-managed recording rule.