Skip to content

Commit c2f57ab

Browse files
committed
Update steps
1 parent 71eac21 commit c2f57ab

File tree

3 files changed

+24
-7
lines changed

3 files changed

+24
-7
lines changed

articles/managed-grafana/how-to-bundled-prometheus.md

Lines changed: 24 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -40,27 +40,42 @@ Complete the following steps to connect your Grafana workspace to an Azure Monit
4040

4141
:::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.":::
4242

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:
4445

4546
- **Monitoring Data Reader**: Grants the Grafana instance read access to metrics in the selected Azure Monitor workspace.
4647
- **Monitoring Metrics Publisher**: Allows the Grafana instance to write recording rule results to the Data Collection Rule attached to the Azure Monitor workspace.
4748

4849
1. After enablement completes, the selected Azure Monitor workspace appears in the dropdown menu.
4950
1. To switch to a different Azure Monitor workspace in the future, repeat steps 2 and 3 above.
5051

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.
5255

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:
5457

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
5669

5770
> [!NOTE]
5871
> Bundled Prometheus only supports Grafana-managed recording rules, which you configure directly in the Grafana interface. Data source-managed recording rules aren't supported.
5972
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**.
6176
:::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.":::
6277

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.
6479
1. Define the rule for the bundled-azure-prometheus data source.
6580
:::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":::
6681

@@ -70,6 +85,8 @@ Create a new recording rule from the Grafana UI following the steps below. For d
7085
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
7186
metrics.
7287

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+
7390
## View recorded Prometheus data
7491

7592
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
94111
1. Under **Monitoring Data Reader**, select the row with the name of your Azure Managed Grafana resource. Select **Delete** > **OK**.
95112
1. Go to the overview page of the Azure Monitor workspace and select the **Data collection rules** resource.
96113
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)
98115

99116
> [!NOTE]
100117
> Disabling bundled Prometheus removes the integration but does not delete existing data in your Azure Monitor workspace.
78 KB
Loading
-24.7 KB
Loading

0 commit comments

Comments
 (0)