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
You can now create charts using Prometheus query language (PromQL) for metrics store in an Azure Monitor workspace. For more information, see [Metrics explorer with PromQL (Preview)](./metrics-explorer.md).
27
+
24
28
## Create a metric chart
25
29
26
30
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**.
Copy file name to clipboardExpand all lines: articles/azure-monitor/essentials/metrics-explorer.md
+28-65Lines changed: 28 additions & 65 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,7 +16,7 @@ ms.reviewer: priyamishra
16
16
17
17
Metrics Explorer with PromQL (Preview) allows you to analyze and visualize platform metrics, and use Prometheus query language (PromQL) to query metrics stored in an Azure Monitor workspace.
18
18
19
-
Metrics explorer with PromQL (Preview) is available from the **Metrics** menu item of any Azure Monitor workspace in the Azure portal, but is not limited to Azure Monitor workspaces. You can query metrics from any Azure resource by selecting the appropriate scope.
19
+
Metrics explorer with PromQL (Preview) is available from the **Metrics** menu item of any Azure Monitor workspace in the Azure portal, but is not limited to Azure Monitor workspaces. You can query metrics from any Azure resource by selecting the appropriate scope.
20
20
21
21
For more information on PromQL, see [Querying Prometheus](https://prometheus.io/docs/prometheus/latest/querying/basics/).
22
22
@@ -27,36 +27,40 @@ The chart pane has two options for charting a metric:
27
27
- Add with builder
28
28
- Add with editor.
29
29
30
+
31
+
### Create a chart with the editor and PromQL
32
+
33
+
To add a metric using the query editor,
34
+
35
+
1. Select **Add metric** and select **Add with editor** from the dropdown.
36
+
37
+
1. Select a **Scope** from the dropdown list. This scope is the Azure Monitor workspace where the metrics are stored.
38
+
1. Enter a PromQL query in the editor field, or select an sinmge metric from **Metric** dropdown.
39
+
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.
40
+
41
+
:::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." :::
42
+
30
43
### Create a chart with the builder
31
44
To add a metric with the builder,
32
45
1. Select **Add metric** and select **Add with builder** from the dropdown.
33
-
1. Select a scope. The scope is the Azure monitor workspace where the metric is stored.
46
+
1. Select a scope. This can be an Azure resource in your subscription.
34
47
1. Select a metric from the drop-down list.
48
+
1. Select the aggregation type from the dropdown list.
35
49
36
50
The metric is displayed by default as a line chart the 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.
37
51
38
52
:::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." :::
39
53
40
-
### Create a chart with the editor and PromQL
41
-
42
-
To add a metric using the editor,
43
-
1. Select **Add metric** and select **Add with editor** from the dropdown.
44
-
1. Select a **Scope** from the dropdown list/
45
-
1. Enter a PromQL query in the editor field. 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.
46
-
47
-
:::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." :::
48
-
49
54
50
55
## Multiple metrics and charts
51
56
Each workspace can host multiple charts with each chart containing multiple metrics.
52
57
53
58
### Add a metric
54
59
55
60
Add multiple metrics to the chart by selecting **Add metric**. Use either the builder or the editor to add metrics to the chart.
56
-
You can add up to <<<<<<<10>>>>>>> metrics to a chart. Each metric and query is plotted on the chart and added to the legend. You can choose a different scope for each metric by selecting the scope dropdown list in the toolbar to compare metrics from different resources.
57
61
58
62
> [!NOTE]
59
-
> Running both the code editor and query builder on the same chart is not supported in this current release and may result in unexpected behavior.
63
+
> Running both the code editor and query builder on the same chart is not supported in the Preview release of Metrics explorer and may result in unexpected behavior.
60
64
61
65
62
66
### Add a new chart
@@ -82,64 +86,23 @@ Time grain refers to the frequency of sampling and display of the data points on
82
86
83
87
:::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." :::
84
88
85
-
## Pan across metrics data
86
-
87
-
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.
88
-
89
-
:::image type="content" source="./media/metrics-explorer/pan-time-axis.gif" lightbox="./media/metrics-explorer/pan-time-axis.gif" alt-text="A screenshot showing panning across the time axis.":::
90
-
91
-
92
-
## Zoom into metrics data
93
-
94
-
Select an area on the chart and the chart to zoom in and show more detail for the selected area based on your granularity settings. If the time grain is set to Automatic, zooming selects a smaller time grain. The new time range applies to all charts in metrics explorer. To zoom back out, select the **Undo zoom** button.
95
-
96
-
97
-
:::image type="content" source="./media/metrics-explorer/zoom-in-time.gif" lightbox="./media/metrics-explorer/zoom-in-time.gif" alt-text="A screenshot showing zooming in on the time axis.":::
98
-
99
-
## Customize the chart
100
-
101
-
Customize the chart by selecting the gear-wheel icon in the toolbar.
102
-
103
-
-**Chart title**: Change the title of the chart.
104
-
-**Chart type**: Change the chart type to line, area, bar, or scatter.
105
-
-**Y-axis range**: Change the minimum and maximum values of the Y-axis. Use these settings to focus on a specific range of values in the chart.
106
-
-**Legends**: Position, show or hide the legend, labels, and hover card for the chart.
107
-
-**Query settings, Scrape interval**: Set the prometheus query settings. The default is 1 minute.
After you configure a chart, you can add it to a dashboard or workbook. By adding a chart to a dashboard or workbook, you can make it accessible to your team. You can also gain insights by viewing it in the context of other monitoring information.
114
-
115
-
- To pin a configured chart to a dashboard, in the upper-right corner of the chart, select Save to dashboard > Pin to dashboard.
116
-
- To save a configured chart to a workbook, in the upper-right corner of the chart, select Save to dashboard > Save to workbook.
117
-
118
-
:::image type="content" source="./media/metrics-explorer/save-chart.png" lightbox="./media/metrics-explorer/save-chart.png" alt-text="A screenshot showing the save menu.":::
119
-
120
-
The Azure Monitor metrics explorer Share menu includes several options for sharing your metric chart.
121
-
122
-
- Use the **Download to Excel** option to immediately download your chart.
123
-
- Select **Copy link** to add a link to your chart to the clipboard.A notification is received when the link is copied successfully.
124
-
-**Send to Workbook** sends your chart to a new or existing workbook.
125
-
- Select **Pin to Grafana** to pin your chart to a new or existing Grafana dashboard.
126
-
127
-
:::image type="content" source="./media/metrics-explorer/share-chart.png" lightbox="./media/metrics-explorer/share-chart.png" alt-text="A screenshot showing the share menu.":::
128
-
129
-
## Supported PromQL functions
130
-
131
-
89
+
## Configure the time range
132
90
133
-
{TBD}
91
+
To set the time range for the chart, use the time range picker in the toolbar. The time range picker allows you to select a predefined time range or set a custom time range. The time range picker also allows you to set the time grain for the chart. The time grain is the frequency of sampling and display of the data points on the chart. The time grain is set to automatic by default. The automatic setting selects the best time grain based on the time range selected.
134
92
93
+
For more information, see [Analyze metrics](aazure/azure-monitor/essentials/analyze-metrics#configure-the-time-range) .
135
94
136
95
96
+
## Chart features
97
+
You can interact with the chart in several ways to gain insights into your metrics data.
137
98
138
-
## Limitations
99
+
This includes the following features:
100
+
- Zoom-in. Select and drag to zoom in on a specific area of the chart.
101
+
- Pan. Shift chart left and right along the time axis.
102
+
- Change chart settings such as chart type, Y-axis range, and legends.
103
+
- Save and share charts
139
104
140
-
The metrics explorer for Azure Monitor workspace is in preview and has some limitations.
141
-
- The metrics explorer supports up to 10 metrics per chart. <<<<<<>>>>>>>
142
-
- The metrics explorer doesn't support running both the code editor and query builder on the same chart.
105
+
For mor information on chart features, see [Analyze metrics](aazure/azure-monitor/essentials/analyze-metrics) .
0 commit comments