Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana/latest/alerting/set-up/provision-alerting-resources.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana/latest/alerting/set-up/provision-alerting-resources/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
Provision Alerting resources
Alerting infrastructure is often complex, with many pieces of the pipeline that often live in different places. Scaling this across multiple teams and organizations is an especially challenging task. Importing and exporting (or provisioning) your alerting resources in Grafana Alerting makes this process easier by enabling you to create, manage, and maintain your alerting data in a way that best suits your organization.
You can import alert rules, contact points, notification policies, mute timings, and templates.
You cannot edit imported alerting resources in the Grafana UI in the same way as alerting resources that were not imported. You can only edit imported contact points, notification policies, templates, and mute timings in the source where they were created. For example, if you manage your alerting resources using files from disk, you cannot edit the data in Terraform or from within Grafana.
Import alerting resources
Choose from the options below to import (or provision) your Grafana Alerting resources.
Use configuration files to provision your alerting resources, such as alert rules and contact points, through files on disk.
Note
- You cannot edit provisioned resources from files in the Grafana UI.
- Provisioning with configuration files is not available in Grafana Cloud.
Use
gcxto provision or to manage individual alerting resources from the command line.Note
- Resources provisioned with
gcx resources pushcannot be edited in the Grafana UI. - Resources that you write with
gcx alertare editable in the Grafana UI by default.
- Resources provisioned with
Use the new HTTP APIs (
/apis) or the legacy Alerting provisioning HTTP API to manage alerting resources.
Export alerting resources
You can export both manually created and provisioned alerting resources. You can also edit and export an alert rule without applying the changes.
You can also export resources from the command line with
gcx.
For detailed instructions on the various export options, refer to Export alerting resources.
View provisioned alerting resources
To view your provisioned resources in Grafana, complete the following steps.
- Open your Grafana instance.
- Navigate to Alerting.
- Click an alerting resource folder, for example, Alert rules.
Provisioned resources are labeled Provisioned, so that it is clear that they were not created manually.
Was this page helpful?
Related resources from Grafana Labs


