You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/managed-grafana/how-to-bundled-prometheus.md
+24-7Lines changed: 24 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,27 +40,42 @@ Complete the following steps to connect your Grafana workspace to an Azure Monit
40
40
41
41
:::image type="content" source="media/bundled-prometheus/select-monitor-workspace.png" alt-text="Screenshot of the Azure platform showing the bundled Prometheus integration pane in Azure Managed Grafana.":::
42
42
43
-
1. In the dropdown menu, select an Azure Monitor workspace, then select **Save**. During enablement, the Grafana-managed recording rules feature is enabled. Azure also automatically creates two role assignments if they don't already exist:
43
+
1. In the dropdown menu, select an Azure Monitor workspace, then select **Save**.
44
+
1. Azure adds a new Prometheus data source called *bundled-azure-prometheus* to Grafana. During enablement, the Grafana-managed recording rules feature is enabled. Azure also automatically creates two role assignments if they don't already exist:
44
45
45
46
-**Monitoring Data Reader**: Grants the Grafana instance read access to metrics in the selected Azure Monitor workspace.
46
47
-**Monitoring Metrics Publisher**: Allows the Grafana instance to write recording rule results to the Data Collection Rule attached to the Azure Monitor workspace.
47
48
48
49
1. After enablement completes, the selected Azure Monitor workspace appears in the dropdown menu.
49
50
1. To switch to a different Azure Monitor workspace in the future, repeat steps 2 and 3 above.
50
51
51
-
## Set up Grafana-managed recording rules
52
+
## Create a Grafana alert rule
53
+
54
+
Alert rules monitor your Prometheus metrics and trigger notifications when specific conditions are met.
52
55
53
-
When you enabled bundled Prometheus in the previous step, Azure added a new Prometheus data source called *bundled-azure-prometheus* to Grafana.
56
+
Follow these steps to create an alert rule:
54
57
55
-
Create a new recording rule from the Grafana UI following the steps below. For detailed configuration options see, [Create Grafana-managed recording rules](https://grafana.com/docs/grafana/latest/alerting/alerting-rules/create-recording-rules/create-grafana-managed-recording-rules).
58
+
1. In the Grafana UI, go to **Alerting** > **Alert rules** and select **New alert rule**.
59
+
:::image type="content" source="media/bundled-prometheus/new-alert-rule.png" alt-text="Screenshot of the Alert rules page in Grafana with the New recording rule button highlighted.":::
60
+
1. Enter an alert rule name that describes what you're monitoring.
61
+
1. Define a query and alert condition: select **bundled-azure-prometheus** from the dropdown and define your query and alert condition.
62
+
1. Set an evaluation behavior: set the evaluation interval and the conditions for firing or resolving the alert.
63
+
1. Set labels and notifications: add labels to help categorize the alert and set up notifications to receive alerts.
64
+
1. Select **Save rule and exit** to create the alert rule.
65
+
66
+
For more details, see [Create Grafana-managed alert rules](https://grafana.com/docs/grafana/latest/alerting/alerting-rules/create-grafana-managed-rule/).
67
+
68
+
## Set up Grafana-managed recording rules
56
69
57
70
> [!NOTE]
58
71
> Bundled Prometheus only supports Grafana-managed recording rules, which you configure directly in the Grafana interface. Data source-managed recording rules aren't supported.
59
72
60
-
1. Go to **Alerting** > **Alert rules** and select **New recording rule**.
73
+
Follow these steps to create a new recording rule:
74
+
75
+
1. On the **Alert rules** page which is open, select **New recording rule**.
61
76
:::image type="content" source="media/bundled-prometheus/new-recording-rule.png" alt-text="Screenshot of the Alert rules page in Grafana with the New recording rule button highlighted.":::
62
77
63
-
1.Enter a name for the recording rule and a metric name.
78
+
1.In the page that opens, enter a name for the recording rule and a metric name.
64
79
1. Define the rule for the bundled-azure-prometheus data source.
65
80
:::image type="content" source="media/bundled-prometheus/define-recording-rule.png" alt-text="Screenshot of configuring recording rule settings with query and labels." lightbox="media/grafana-settings/grafana-settings-tab.png":::
66
81
@@ -70,6 +85,8 @@ Create a new recording rule from the Grafana UI following the steps below. For d
70
85
1. After saving, you can view the details of the recording rule under the folder you selected earlier. Select the **View** icon to view recorded
71
86
metrics.
72
87
88
+
For detailed configuration options see, [Create Grafana-managed recording rules](https://grafana.com/docs/grafana/latest/alerting/alerting-rules/create-recording-rules/create-grafana-managed-recording-rules).
89
+
73
90
## View recorded Prometheus data
74
91
75
92
After you set up the recording rules, you can visualize the recorded Prometheus data in Grafana:
@@ -94,7 +111,7 @@ If you no longer need bundled Prometheus, you can disable it from your Azure Man
94
111
1. Under **Monitoring Data Reader**, select the row with the name of your Azure Managed Grafana resource. Select **Delete** > **OK**.
95
112
1. Go to the overview page of the Azure Monitor workspace and select the **Data collection rules** resource.
96
113
1. Go to **Access Control (IAM)** > **Role Assignments**, and under **Monitoring Metrics Publisher**, select the row with the name of your Azure Managed Grafana resource. Select **Delete** > **OK**.
97
-
1. To continue accessing existing data in the Azure Monitor Workspace, consider [setting up Azure Monitor Workspace integration in Azure Managed Grafana](./how-to-connect-azure-monitor-workspace.md)
114
+
1. To continue accessing existing data in the Azure Monitor workspace, consider [setting up Azure Monitor Workspace integration in Azure Managed Grafana](./how-to-connect-azure-monitor-workspace.md)
98
115
99
116
> [!NOTE]
100
117
> Disabling bundled Prometheus removes the integration but does not delete existing data in your Azure Monitor workspace.
0 commit comments