Merge pull request #224249 from EdB-MSFT/prometheus-workbooks

Prometheus workbooks

Author: v-dirichards

articles/azure-monitor/essentials/media/prometheus-workbooks/prometheus-explorer.png

@@ -0,0 +1,71 @@
+---
+title: Query Prometheus metrics using Azure workbooks (preview)
+description: Query Prometheus metrics in the portal using Azure Workbooks.
+author: EdB-MSFT
+ms.topic: conceptual
+ms.date: 01/18/2023
+ms.author: edbaynash
+---
+
+# Query Prometheus metrics using Azure workbooks (preview)
+
+Create dashboards powered by Azure Monitor managed service for Prometheus using [Azure Workbooks](../visualize/workbooks-overview.md).
+This article introduces workbooks for Azure Monitor workspaces and shows you how to query Prometheus metrics using Azure workbooks and PromQL query language.
+
+## Pre-requisites
+To query Prometheus metrics from an Azure Monitor workspace you need the following:
+-	An Azure Monitor workspace. To create an Azure Monitor workspace see [Create an Azure Monitor Workspace](./azure-monitor-workspace-overview.md?tabs=azure-portal.md).
+-	Your Azure Monitor workspace must be [collecting Prometheus metrics](./prometheus-metrics-enable.md) from an AKS cluster.
+-	You have the **Monitoring Data Reader** role assigned for the Azure Monitor workspace.
+
+> [!NOTE]
+> Querying data from an Azure Monitor workspace is a data plane operation. Even if you are an owner or have elevated control plane access, you still need to assign the Monitoring Data Reader role. For more information, see [Azure control and data plane](../../azure-resource-manager/management/control-plane-and-data-plane.md).
+
+## Prometheus Explorer workbook
+Azure Monitor workspaces include an exploration workbook to query your Prometheus metrics. 
+
+1. From the Azure Monitor workspace overview page, select **Workbooks** 
+
+1. In the Azure Monitor workspace gallery, select the **Prometheus Explorer** workbook tile.
+
+![Screenshot that shows Azure Monitor workspace gallery.](./media/prometheus-workbooks/prometheus-gallery.png)
+
+A workbook has the following input options:
+-	**Time Range**. Select the period of time that you want to include in your query. Select **Custom** to set a start and end time.
+-	**PromQL**. Enter the PromQL query to retrieve your data. For more information about PromQL, see [Querying Prometheus](https://prometheus.io/docs/prometheus/latest/querying/basics/#querying-prometheus).
+-	**Graph**, **Grid**, and **Dimensions** tabs. Switch between a graphic, tabular and dimensional view of the query output.
+
+![Screenshot that shows PromQL explorer.](./media/prometheus-workbooks/prometheus-explorer.png)
+
+## Create a Prometheus workbook
+
+Workbooks supports many visualizations and Azure integrations. For more information about Azure Workbooks, see [Creating an Azure Workbook](../visualize/workbooks-create-workbook.md).  
+
+
+
+1.	From your Azure Monitor workspace select **Workbooks**.
+
+1.  Select **New**.
+1.	In the new workbook, select **Add**, and select **Add query** from the dropdown.
+:::image type="content" source="./media/prometheus-workbooks/prometheus-workspace-add-query.png" alt-text="A screenshot showing the add content dropdown in a blank workspace.":::    
+1. Azure Workbooks use [data sources](../visualize/workbooks-data-sources.md#prometheus-preview) to set the source scope the data they present. To query Prometheus metrics, select the  **Data source** dropdown, and choose **Prometheus (preview)** .
+1.	From the **Azure Monitor workspace** dropdown, select your workspace.
+1.	Select your query type from **Prometheus query type** dropdown.
+1.	Write your PromQL query in the **Prometheus Query** field. 
+1.	Select **Run Query** button.
+1.	Select the **Done Editing** at the bottom of the section and save your work
+
+![Screenshot that shows sample PromQL query.](./media/prometheus-workbooks/prometheus-query.png)
+
+## Troubleshooting
+
+If your workbook query does not return data:
+
+-	Check that you have Monitoring Data Reader role permissions assigned through Access Control (IAM) in your Azure Monitor workspace
+-	Verify that you have turned on metrics collection in the Monitored clusters blade of your Azure Monitor workspace.
+
+
+## Next steps
+* [Collect Prometheus metrics from AKS cluster (preview)](./prometheus-metrics-enable.md)
+* [Azure Monitor workspace (preview)](./azure-monitor-workspace-overview.md)
+* [Use Azure Monitor managed service for Prometheus (preview) as data source for Grafana using managed system identity](./prometheus-grafana.md)

articles/azure-monitor/essentials/media/prometheus-workbooks/prometheus-gallery.png

@@ -405,6 +405,9 @@ items:
       - name: Rule groups
         displayName: Prometheus
         href: essentials/prometheus-rule-groups.md
+      - name: Query Prometheus metrics in workbooks
+        displayName: Prometheus
+        href: essentials/prometheus-workbooks.md
       - name: Remote-write
         items:
         - name: Overview

articles/azure-monitor/essentials/media/prometheus-workbooks/prometheus-query.png

@@ -25,6 +25,7 @@ Workbooks can extract data from these data sources:
  - [Azure resource health](#azure-resource-health)
  - [Azure RBAC](#azure-rbac)
  - [Change Analysis (preview)](#change-analysis-preview)
+ - [Prometheus (preview)](#prometheus-preview)
 
 ## Logs
 
@@ -173,6 +174,16 @@ To make a query control that uses [Application Change Analysis](../app/change-an
 > [!div class="mx-imgBorder"]
 > ![A screenshot that shows a workbook with Change Analysis.](./media/workbooks-data-sources/change-analysis-data-source.png)
 
+
+## Prometheus (preview)
+
+With [Azure Monitor managed service for Prometheus](../essentials/prometheus-metrics-overview.md), you can collect Prometheus metrics for your Kubernetes clusters. To query Prometheus metrics, select **Prometheus** from the data source dropdown, followed by where the metrics are stored in [Azure Monitor workspace](../essentials/azure-monitor-workspace-overview.md) and the [Prometheus query type](https://prometheus.io/docs/prometheus/latest/querying/api/) for the PromQL query.
+![Screenshot that shows sample PromQL query.](./media/workbooks-data-sources/prometheus-query.png)
+
+> [!NOTE]
+> Querying from an Azure Monitor workspace is a data plane action and requires an explicit role assignment of Monitoring Data Reader, which is not assigned by default
+> Learn more about [Azure control and data plane](../../azure-resource-manager/management/control-plane-and-data-plane.md) 
+
 ## Next steps
 
  - [Get started with Azure Workbooks](workbooks-getting-started.md)