Skip to content

Commit e948a72

Browse files
authored
Merge pull request #206831 from paulth1/metrics-getting-started
edit pass: metrics-getting-started
2 parents 1b21200 + 829a6e2 commit e948a72

File tree

1 file changed

+39
-33
lines changed

1 file changed

+39
-33
lines changed
Lines changed: 39 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Getting started with Azure metrics explorer
3-
description: Learn how to create your first metric chart with Azure metrics explorer.
2+
title: Get started with Azure Monitor metrics explorer
3+
description: Learn how to create your first metric chart with Azure Monitor metrics explorer.
44
author: vgorbenko
55
services: azure-monitor
66
ms.topic: conceptual
@@ -9,84 +9,90 @@ ms.author: vitalyg
99
ms.reviewer: vitalyg
1010
---
1111

12-
# Getting started with Azure Metrics Explorer
12+
# Get started with metrics explorer
1313

14-
## Where do I start
15-
Azure Monitor metrics explorer is a component of the Microsoft Azure portal that allows plotting charts, visually correlating trends, and investigating spikes and dips in metrics' values. Use the metrics explorer to investigate the health and utilization of your resources. Start in the following order:
14+
Azure Monitor metrics explorer is a component of the Azure portal that you can use to plot charts, visually correlate trends, and investigate spikes and dips in metrics' values. Use metrics explorer to investigate the health and utilization of your resources.
1615

17-
1. [Pick a resource and a metric](#create-your-first-metric-chart) and you see a basic chart. Then [select a time range](#select-a-time-range) that is relevant for your investigation.
16+
## Where do I start?
17+
18+
Start in the following order:
19+
20+
1. [Pick a resource and a metric](#create-your-first-metric-chart) and you see a basic chart. Then [select a time range](#select-a-time-range) that's relevant for your investigation.
1821

1922
1. Try [applying dimension filters and splitting](#apply-dimension-filters-and-splitting). The filters and splitting allow you to analyze which segments of the metric contribute to the overall metric value and identify possible outliers.
2023

21-
1. Use [advanced settings](#advanced-chart-settings) to customize the chart before pinning to dashboards. [Configure alerts](../alerts/alerts-metric-overview.md) to receive notifications when the metric value exceeds or drops below a threshold.
24+
1. Use [advanced settings](#advanced-chart-settings) to customize the chart before you pin it to dashboards. [Configure alerts](../alerts/alerts-metric-overview.md) to receive notifications when the metric value exceeds or drops below a threshold.
2225

2326
## Create your first metric chart
2427

2528
To create a metric chart, from your resource, resource group, subscription, or Azure Monitor view, open the **Metrics** tab and follow these steps:
2629

27-
1. Select the "Select a scope" button to open the resource scope picker. This allows you to select the resource(s) you want to see metrics for. The resource should already be populated if you opened metrics explorer from the resource's menu. To learn how to view metrics across multiple resources, [read this article](./metrics-dynamic-scope.md).
28-
> ![Select a resource](./media/metrics-getting-started/scope-picker.png)
30+
1. Select the **Select a scope** button to open the resource scope picker. You can use the picker to select the resources you want to see metrics for. The resource should already be populated if you opened metrics explorer from the resource's menu. To learn how to view metrics across multiple resources, see [View multiple resources in Azure Monitor metrics explorer](./metrics-dynamic-scope.md).
2931

30-
1. For some resources, you must pick a namespace. The namespace is just a way to organize metrics so that you can easily find them. For example, storage accounts have separate namespaces for storing Files, Tables, Blobs, and Queues metrics. Many resource types only have one namespace.
32+
> ![Screenshot that shows selecting a resource.](./media/metrics-getting-started/scope-picker.png)
33+
34+
1. For some resources, you must pick a namespace. The namespace is a way to organize metrics so that you can easily find them. For example, storage accounts have separate namespaces for storing metrics for files, tables, blobs, and queues. Many resource types have only one namespace.
3135

3236
1. Select a metric from a list of available metrics.
3337

34-
> ![Select a metric](./media/metrics-getting-started/metrics-dropdown.png)
38+
> ![Screenshot that shows selecting a metric.](./media/metrics-getting-started/metrics-dropdown.png)
3539
3640
1. Optionally, you can [change the metric aggregation](../essentials/metrics-charts.md#aggregation). For example, you might want your chart to show minimum, maximum, or average values of the metric.
3741

3842
> [!TIP]
39-
> Use the **Add metric** button and repeat these steps if you want to see multiple metrics plotted in the same chart. For multiple charts in one view, select the **Add chart** button on top.
43+
> Select **Add metric** and repeat these steps to see multiple metrics plotted in the same chart. For multiple charts in one view, select **Add chart**.
4044
4145
## Select a time range
4246

4347
> [!WARNING]
44-
> [Most metrics in Azure are stored for 93 days](../essentials/data-platform-metrics.md#retention-of-metrics). However, you can query no more than 30 days worth of data on any single chart. You can [pan](metrics-charts.md#pan) the chart to view the full retention. The 30 day limitation doesn't apply to [log-based metrics](../app/pre-aggregated-metrics-log-metrics.md#log-based-metrics).
48+
> [Most metrics in Azure are stored for 93 days](../essentials/data-platform-metrics.md#retention-of-metrics). You can query no more than 30 days' worth of data on any single chart. You can [pan](metrics-charts.md#pan) the chart to view the full retention. The 30-day limitation doesn't apply to [log-based metrics](../app/pre-aggregated-metrics-log-metrics.md#log-based-metrics).
4549
46-
By default, the chart shows the most recent 24 hours of metrics data. Use the **time picker** panel to change the time range, zoom in, or zoom out on your chart.
50+
By default, the chart shows the most recent 24 hours of metrics data. Use the **time picker** panel to change the time range, zoom in, or zoom out on your chart.
4751

48-
![Change time range panel](./media/metrics-getting-started/time.png)
52+
![Screenshot that shows changing the time range panel.](./media/metrics-getting-started/time.png)
4953

5054
> [!TIP]
51-
> Use the **time brush** to investigate an interesting area of the chart (spike or a dip). Put the mouse pointer at the beginning of the area, click and hold the left mouse button, drag to the other side of area and then release the button. The chart will zoom in on that time range.
55+
> Use the **time brush** to investigate an interesting area of the chart like a spike or a dip. Position the mouse pointer at the beginning of the area, select and hold the left mouse button, drag to the other side of the area, and then release the button. The chart will zoom in on that time range.
5256
5357
## Apply dimension filters and splitting
5458

55-
[Filtering](../essentials/metrics-charts.md#filters) and [splitting](../essentials/metrics-charts.md#apply-splitting) are powerful diagnostic tools for the metrics that have dimensions. These features show how various metric segments ("dimension values") impact the overall value of the metric, and allow you to identify possible outliers.
56-
57-
- **Filtering** lets you choose which dimension values are included in the chart. For example, you might want to show successful requests when charting the *server response time* metric. You would need to apply the filter on the *success of request* dimension.
59+
[Filtering](../essentials/metrics-charts.md#filters) and [splitting](../essentials/metrics-charts.md#apply-splitting) are powerful diagnostic tools for the metrics that have dimensions. These features show how various metric segments ("dimension values") affect the overall value of the metric. You can use them to identify possible outliers.
5860

59-
- **Splitting** controls whether the chart displays separate lines for each value of a dimension, or aggregates the values into a single line. For example, you can see one line for an average response time across all server instances, or see separate lines for each server. You would need to apply splitting on the *server instance* dimension to see separate lines.
61+
- **Filtering** lets you choose which dimension values are included in the chart. For example, you might want to show successful requests when you chart the *server response time* metric. You apply the filter on the *success of request* dimension.
62+
- **Splitting** controls whether the chart displays separate lines for each value of a dimension or aggregates the values into a single line. For example, you can see one line for an average response time across all server instances. Or you can see separate lines for each server. You apply splitting on the *server instance* dimension to see separate lines.
6063

61-
See [examples of the charts](../essentials/metric-chart-samples.md) that have filtering and splitting applied. The article shows the steps were used to configure the charts.
64+
For examples that have filtering and splitting applied, see [Metric chart examples](../essentials/metric-chart-samples.md). The article shows the steps that were used to configure the charts.
6265

6366
## Share your metric chart
64-
There are three ways to share your metric chart. See the instructions below on how to share information from your metrics charts using Excel, a link and a workbook.
65-
67+
68+
There are three ways to share your metric chart. See the following instructions on how to share information from your metric charts by using Excel, a link, or a workbook.
69+
6670
### Download to Excel
67-
Select "Share" and "Download to Excel". Your download should start immediately.
6871

69-
:::image type="content" source="media/metrics-getting-started/share-excel.png" alt-text="screenshot how to share metric chart using excel":::
72+
Select **Share** > **Download to Excel**. Your download should start immediately.
73+
74+
:::image type="content" source="media/metrics-getting-started/share-excel.png" alt-text="Screenshot that shows how to share a metric chart by using Excel.":::
7075

7176
### Share a link
72-
Select "Share" and "Copy link". You should get a notification that the link was copied successfully.
7377

74-
:::image type="content" source="media/metrics-getting-started/share-link.png" alt-text="screenshot how to share metric chart using a link":::
78+
Select **Share** > **Copy link**. You should get a notification that the link was copied successfully.
79+
80+
:::image type="content" source="media/metrics-getting-started/share-link.png" alt-text="Screenshot that shows how to share a metric chart by using a link.":::
7581

7682
### Send to workbook
77-
Select "Share" and "Send to Workbook". The **Send to Workbook** window opens for you to send the metric chart to a new or existing workbook.
7883

79-
:::image type="content" source="media/metrics-getting-started/share-workbook.png" alt-text="screenshot how to share metric chart to a workbook":::
84+
Select **Share** > **Send to Workbook**. In the **Send to Workbook** window, you can send the metric chart to a new or existing workbook.
8085

86+
:::image type="content" source="media/metrics-getting-started/share-workbook.png" alt-text="Screenshot that shows how to share a metric chart to a workbook.":::
8187

8288
## Advanced chart settings
8389

84-
You can customize chart style, title, and modify advanced chart settings. When done with customization, pin it to a dashboard or save to a workbook to save your work. You can also configure metrics alerts. Follow [product documentation](../essentials/metrics-charts.md) to learn about these and other advanced features of Azure Monitor metrics explorer.
90+
You can customize the chart style and title, and modify advanced chart settings. When you're finished with customization, pin the chart to a dashboard or save it to a workbook. You can also configure metrics alerts. Follow [product documentation](../essentials/metrics-charts.md) to learn about these and other advanced features of Azure Monitor metrics explorer.
8591

8692
## Next steps
8793

88-
* [Learn about advanced features of Metrics Explorer](../essentials/metrics-charts.md)
89-
* [Viewing multiple resources in Metrics Explorer](./metrics-dynamic-scope.md)
90-
* [Troubleshooting Metrics Explorer](metrics-troubleshoot.md)
94+
* [Learn about advanced features of metrics explorer](../essentials/metrics-charts.md)
95+
* [Viewing multiple resources in metrics explorer](./metrics-dynamic-scope.md)
96+
* [Troubleshooting metrics explorer](metrics-troubleshoot.md)
9197
* [See a list of available metrics for Azure services](./metrics-supported.md)
9298
* [See examples of configured charts](../essentials/metric-chart-samples.md)

0 commit comments

Comments
 (0)