Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Documentation Grafana documentation Alerting Set up Provision Alerting resources

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.

1. Use configuration files to provision your alerting resources, such as alert rules and contact points, through files on disk.

   Note

   File provisioning is not available in Grafana Cloud instances.

2. Use Terraform to provision alerting resources.

3. Use the Alerting provisioning HTTP API to manage alerting resources.

   Note

   The JSON output from the majority of Alerting HTTP endpoints isn’t compatible for provisioning via configuration files. Instead, use the Export Alerting endpoints to return or download the alerting resources in provisioning format.

Export alerting resources

You can export both manually created and provisioned alerting resources. For more information, refer to Export alerting resources.

To modify imported alert rules, you can use the Modify export feature to edit and then export.

View provisioned alerting resources

To view your provisioned resources in Grafana, complete the following steps.

1. Open your Grafana instance.
2. Navigate to Alerting.
3. 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.

Useful Links:

Grafana provisioning