public/grafana
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

alerting docs: update alert state history docs

Browse Source 
Update the Configure Alert State History docs with multi configurations.
This commit is contained in:
Johnny K.
2026-01-12 13:49:53 -06:00
parent 9c7e48997a
commit d4d2cc8d59
1 changed files with 68 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/sources/alerting/set-up/configure-alert-state-history/index.md
+68 -2
View File
@@ -120,9 +120,13 @@ GRAFANA_ALERTS{alertstate='firing'}
## Configure Loki and Prometheus for alert state
You can also configure both Loki and Prometheus to record alert state changes for your Grafana-managed alert rules.
You can configure multiple backends to record alert state changes for your Grafana-managed alert rules. The `primary` backend serves state history queries and must be either `annotations` or `loki`.
Start with the same setup steps as shown in the previous [Loki](#configure-loki-for-alert-state) and [Prometheus](#configure-prometheus-for-alert-state-alerts-metric) sections. Then, adjust your Grafana configuration as follows:
### Loki with Prometheus
You can use Loki as the primary backend for state history queries and write to Prometheus for metrics-based monitoring.
Start with the setup steps from [Loki](#configure-loki-for-alert-state) and [Prometheus](#configure-prometheus-for-alert-state-alerts-metric). Then, adjust your Grafana configuration as follows:
```toml
[unified_alerting.state_history]
@@ -137,4 +141,66 @@ secondaries = prometheus
# Target data source UID for writing alert state changes.
prometheus_target_datasource_uid = <DATA_SOURCE_UID>
[feature_toggles]
enable = alertingCentralAlertHistory
```
### Annotations with Loki
You can use annotations (stored in Grafana's database) as the primary backend and write to Loki for external storage and advanced querying.
Start with the setup steps from [Loki](#configure-loki-for-alert-state). Then, adjust your Grafana configuration as follows:
```toml
[unified_alerting.state_history]
enabled = true
backend = multiple
primary = annotations
secondaries = loki
# URL of the Loki server.
loki_remote_url = http://localhost:3100
```
### Annotations with Prometheus
You can use annotations as the primary backend and write to Prometheus for metrics-based monitoring.
Start with the setup steps from [Prometheus](#configure-prometheus-for-alert-state-alerts-metric). Then, adjust your Grafana configuration as follows:
```toml
[unified_alerting.state_history]
enabled = true
backend = multiple
primary = annotations
secondaries = prometheus
# Target data source UID for writing alert state changes.
prometheus_target_datasource_uid = <DATA_SOURCE_UID>
```
### Loki with multiple secondaries
You can configure Loki as the primary backend with multiple secondary backends for comprehensive redundancy and monitoring.
Start with the setup steps from [Loki](#configure-loki-for-alert-state) and [Prometheus](#configure-prometheus-for-alert-state-alerts-metric). Then, adjust your Grafana configuration as follows:
```toml
[unified_alerting.state_history]
enabled = true
backend = multiple
primary = loki
# URL of the Loki server.
loki_remote_url = http://localhost:3100
# Comma-separated list of secondary backends.
secondaries = annotations,prometheus
# Target data source UID for writing alert state changes.
prometheus_target_datasource_uid = <DATA_SOURCE_UID>
[feature_toggles]
enable = alertingCentralAlertHistory
```