Merge pull request #270752 from EdB-MSFT/new-metrics-explorer

New metrics explorer for AMW

Author: ttorble

articles/azure-monitor/essentials/analyze-metrics.md

@@ -21,6 +21,10 @@ Watch the following video for an overview of creating and working with metrics c
 
 > [!VIDEO https://www.microsoft.com/videoplayer/embed/RE4qO59]
 
+## Create a metric chart using PromQL
+
+You can now create charts using Prometheus query language (PromQL) for metrics stored in an Azure Monitor workspace. For more information, see [Metrics explorer with PromQL (Preview)](./metrics-explorer.md).
+
 ## Create a metric chart
 
 You can open metrics explorer from the **Azure Monitor overview** page, or from the **Monitoring** section of any resource. In the Azure portal, select **Metrics**.
@@ -116,6 +120,8 @@ Use the time picker to change the **Time range** for your data, such as the last
 
 In addition to changing the time range with the time picker, you can pan and zoom by using the controls in the chart area.
 
+## Interactive chart features
+
 ### Pan across metrics data
 
 To pan, select the left and right arrows at the edge of the chart. The arrow control moves the selected time range back and forward by one half of the chart's time span. If you're viewing the past 24 hours, selecting the left arrow causes the time range to shift to span a day and a half to 12 hours ago.

articles/azure-monitor/essentials/media/metrics-explorer/add-metric-with-builder.png

@@ -0,0 +1,119 @@
+---
+title: Azure Monitor metrics explorer with PromQL (Preview)
+description: Learn about Azure Monitor metrics explorer with Prometheus query language support.
+author: EdB-MSFT
+ms.service: azure-monitor
+ms-author: edbaynash
+ms.topic: conceptual
+ms.date: 04/01/2024
+ms.reviewer: priyamishra
+
+# Customer intent: As an Azure Monitor user, I want to learn how to use Azure Monitor metrics explorer with PromQL.
+
+---
+
+# Azure Monitor metrics explorer with PromQL (Preview) 
+
+Azure Monitor metrics explorer with PromQL (Preview) allows you to analyze metrics using Prometheus query language (PromQL) for metrics stored in an Azure Monitor workspace. 
+
+Azure Monitor metrics explorer with PromQL (Preview) is available from the **Metrics** menu item of any Azure Monitor workspace. You can query metrics from form Azure Monitor workspaces using PromQL or any other Azure resource using the query builder.
+
+> [!NOTE]
+> You must have the *Monitoring Reader* role at the subscription level to visualize metrics across multiple resources, resource groups, or a subscription. For more information, see [Assign Azure roles in the Azure portal](/azure/role-based-access-control/role-assignments-portal).
+
+
+## Create a chart
+
+The chart pane has two options for charting a metric:
+-  Add with editor.
+-  Add with builder.
+
+Adding a chart with the editor allows you to enter a PromQL query to retrieve metrics data. The editor provides syntax highlighting and intellisense for PromQL queries. Currently, queries are limited to the metrics stored in an Azure Monitor workspace. For more information on PromQL, see [Querying Prometheus](https://prometheus.io/docs/prometheus/latest/querying/basics/).
+
+
+Adding a chart with the builder allows you to select metrics from any of your Azure resources. The builder provides a list of metrics available in the selected scope. Select the metric, aggregation type, and chart type from the builder. The builder can't be used to chart metrics stored in an Azure Monitor workspace.
+
+
+### Create a chart with the editor and PromQL
+
+To add a metric using the query editor:
+
+1. Select **Add metric** and select **Add with editor** from the dropdown. 
+
+1. Select a **Scope** from the dropdown list. This scope is the Azure Monitor workspace where the metrics are stored.
+1. Enter a PromQL query in the editor field, or select a single metric from **Metric** dropdown.
+1. Select **Run** to run the query and display the results in the chart. You can customize the chart by selecting the gear-wheel icon. You can change the chart title, add annotations, and set the time range for the chart. 
+
+:::image type="content" source="./media/metrics-explorer/add-metric-with-editor.png"  lightbox="./media/metrics-explorer/add-metric-with-editor.png"  alt-text="A screenshot showing adding a metric using the editor." :::
+
+### Create a chart with the builder
+
+To add a metric with the builder:
+
+1. Select **Add metric** and select **Add with builder** from the dropdown. 
+
+1. Select a **Scope**. The scope can be any Azure resource in your subscription.
+1. Select a **Metric Namespace** from the dropdown list. The metrics namespace is the category of the metric.
+1. Select a **Metric** from the dropdown list.
+1. Select the **Aggregation** type from the dropdown list. 
+
+ For more information on the selecting scope, metrics, and aggregation, see [Analyze metrics](/azure/azure-monitor/essentials/analyze-metrics#set-the-resource-scope).
+
+:::image type="content" source="./media/metrics-explorer/add-metric-with-builder.png" lightbox="./media/metrics-explorer/add-metric-with-builder.png"  alt-text="A screenshot showing adding a metric using the builder in the metrics explorer." :::
+
+Metrics are displayed by default as a line chart. Select your preferred chart type from the dropdown list in the toolbar. Customize the chart by selecting the gear-wheel icon. You can change the chart title, add annotations, and set the time range for the chart.
+
+## Multiple metrics and charts 
+Each workspace can host multiple charts. Each chart can contain multiple metrics.
+
+### Add a metric
+
+Add multiple metrics to the chart by selecting **Add metric**. Use either the builder or the editor to add metrics to the chart. 
+
+> [!NOTE]
+> Using both the code editor and query builder on the same chart is not supported in the Preview release of Azure Monitor metrics explorer and may result in unexpected behavior.
+
+
+### Add a new chart
+
+Create additional charts by selecting **New chart**. Each chart can have multiple metrics and different chart types and settings. 
+
+Time range and granularity are applied to all the charts in the workspace.
+
+:::image type="content" source="./media/metrics-explorer/create-multiple-charts.png" lightbox="./media/metrics-explorer/create-multiple-charts.png" alt-text="A screenshot showing multiple charts.":::
+
+### Remove a chart
+
+To remove a chart, select the ellipsis (**...**) options icon and select **Remove**.
+
+## Configure time range and granularity
+
+Configure the time range and granularity for your metric chart to view data that's relevant to your monitoring scenario. By default, the chart shows the most recent 24 hours of metrics data.
+
+Set the time range for the chart by selecting the time picker in the toolbar. Select a predefined time range, or set a custom time range.
+
+
+Time grain is the frequency of sampling and display of the data points on the chart. Select the time granularity by using the time picker in the metrics explorer. If the data is stored at a lower or more frequent granularity than selected, the metric values displayed are aggregated to the level of granularity selected. The time grain is set to automatic by default. The automatic setting selects the best time grain based on the time range selected.
+
+For more information on configuring time range and granularity, see [Analyze metrics](/azure/azure-monitor/essentials/analyze-metrics#configure-the-time-range).
+
+:::image type="content" source="./media/metrics-explorer/time-picker.png" lightbox="./media/metrics-explorer/time-picker.png"  alt-text="A screenshot showing time range picker." :::
+
+## Chart features
+
+Interact with the charts to gain deeper insights into your metrics data.
+Interactive features include the following:
+
+- Zoom-in. Select and drag to zoom in on a specific area of the chart. 
+- Pan. Shift chart left and right along the time axis.
+- Change chart settings such as chart type, Y-axis range, and legends.
+- Save and share charts
+
+For more information on chart features, see [Interactive chart features](/azure/azure-monitor/essentials/analyze-metrics#interactive-chart-features).
+
+
+## Next steps
+
+- [Azure Monitor managed service for Prometheus](/azure/azure-monitor/essentials/prometheus-metrics-overview)
+- [Azure Monitor workspace overview](/azure/azure-monitor/essentials/azure-monitor-workspace-overview)
+- [Understanding metrics aggregation](/azure/azure-monitor/essentials/metrics-aggregation-explained)

articles/azure-monitor/essentials/media/metrics-explorer/add-metric-with-editor.png

@@ -10,7 +10,7 @@ ms.date: 01/25/2024
 
 # Azure Monitor managed service for Prometheus
 
-Azure Monitor managed service for Prometheus is a component of [Azure Monitor Metrics](data-platform-metrics.md), providing more flexibility in the types of metric data that you can collect and analyze with Azure Monitor. Prometheus metrics share some features with platform and custom metrics, but use some different features to better support open source tools such as [PromQL](https://aka.ms/azureprometheus-promio-promql) and [Grafana](../../managed-grafana/overview.md).
+Azure Monitor managed service for Prometheus is a component of [Azure Monitor Metrics](data-platform-metrics.md), providing more flexibility in the types of metric data that you can collect and analyze with Azure Monitor. Prometheus metrics are supported by analysis tool like  [Azure Monitor Metrics Explorer with PromQL](./metrics-explorer.md) and open source tools such as [PromQL](https://aka.ms/azureprometheus-promio-promql) and [Grafana](../../managed-grafana/overview.md).
 
 Azure Monitor managed service for Prometheus allows you to collect and analyze metrics at scale using a Prometheus-compatible monitoring solution, based on the [Prometheus](https://aka.ms/azureprometheus-promio) project from the Cloud Native Computing Foundation. This fully managed service allows you to use the [Prometheus query language (PromQL)](https://aka.ms/azureprometheus-promio-promql) to analyze and alert on the performance of monitored infrastructure and workloads without having to operate the underlying infrastructure.
 
@@ -23,14 +23,20 @@ Azure Monitor managed service for Prometheus can currently collect data from any
 - Azure Kubernetes service (AKS)
 - Azure Arc-enabled Kubernetes
 - Any server or Kubernetes cluster running self-managed Prometheus using [remote-write](./remote-write-prometheus.md).
+- Virtual Machines and Virtual Machine Scale Sets configured for remote write to a Prometheus server.
 
 ## Enable
 The only requirement to enable Azure Monitor managed service for Prometheus is to create an [Azure Monitor workspace](azure-monitor-workspace-overview.md), which is where Prometheus metrics are stored. Once this workspace is created, you can onboard services that collect Prometheus metrics.
 
 - To collect Prometheus metrics from your Kubernetes cluster, see [Enable monitoring for Kubernetes clusters](../containers/kubernetes-monitoring-enable.md#enable-prometheus-and-grafana).
 - To configure remote-write to collect data from your self-managed Prometheus server, see [Azure Monitor managed service for Prometheus remote write](./remote-write-prometheus.md).
 
+## Azure Monitor Metrics Explorer with PromQL
+
+Metrics Explorer with PromQL allows you to analyze and visualize platform metrics, and use Prometheus query language (PromQL) to query Prometheus and other metrics stored in an Azure Monitor workspace. Metrics Explorer with PromQL is available from the **Metrics** menu item of any Azure Monitor workspace in the Azure portal. See [Metrics Explorer with PromQL](./metrics-explorer.md) for more information.
+
 ## Grafana integration
+
 The primary method for visualizing Prometheus metrics is [Azure Managed Grafana](../../managed-grafana/overview.md). [Connect your Azure Monitor workspace to a Grafana workspace](./azure-monitor-workspace-manage.md#link-a-grafana-workspace) so that it can be used as a data source in a Grafana dashboard. You then have access to multiple prebuilt dashboards that use Prometheus metrics and the ability to create any number of custom dashboards.
 
 ## Rules and alerts

articles/azure-monitor/essentials/media/metrics-explorer/create-multiple-charts.png

@@ -1,11 +1,11 @@
 ---
 ms.service: azure-monitor
 ms.topic: include
-ms.date: 10/31/2023
+ms.date: 4/08/2024
 ms.author: edbaynash
 author: EdB-MSFT
 ---
 
 ### Can I view my Prometheus metrics in Azure Monitor metrics explorer?
 
-Metrics explorer in Azure Monitor doesn't currently support visualizing Prometheus metric data. Consider using [Azure Managed Grafana](../../managed-grafana/index.yml) to visualize your Prometheus metrics.
+Metrics explorer with PromQL supports visualizing Prometheus metrics data using PromQL. To use the Metrics Explorer with PromQL support, select the **Metrics** menu item from any Azure Monitor workspace in the Azure portal. For more information, see [Metrics explorer with PromQL (Preview)](../essentials/metrics-explorer.md).

articles/azure-monitor/essentials/media/metrics-explorer/time-picker.png

@@ -1171,6 +1171,9 @@ items:
     items:
       - name: Analyze metrics
         href: essentials/analyze-metrics.md
+      - name: Metrics explorer with PromQL
+        displayName: Prometheus, metrics explorer
+        href: essentials/metrics-explorer.md  
       - name: Understanding metrics aggregation
         href: essentials/metrics-aggregation-explained.md
       - name: Examples of metric charts