Skip to content

Commit a194101

Browse files
committed
Editing text
1 parent 3465fa8 commit a194101

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

articles/azure-monitor/app/tutorial-asp-net-custom-metrics.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.reviewer: casocha
1111

1212
In this article, you'll learn how to capture custom metrics with Application Insights in .NET and .NET Core apps.
1313

14-
Insert a few lines of code in your application to find out what users are doing with it or to help diagnose issues. You can send telemetry from device apps, desktop apps, web clients, and web servers. Use the [Application Insights](./app-insights-overview.md) core telemetry API to send custom events and metrics and your own versions of standard telemetry. This API is the same API that the standard Application Insights data collectors use.
14+
Insert a few lines of code in your application to find out what users are doing with it or to help diagnose issues. You can send telemetry from device and desktop apps, web clients, and web servers. Use the [Application Insights](./app-insights-overview.md) core telemetry API to send custom events and metrics and your own versions of standard telemetry. This API is the same API that the standard Application Insights data collectors use.
1515

1616
## ASP.NET Core applications
1717

@@ -34,9 +34,9 @@ The Application Insights .NET and .NET Core SDKs have two different methods for
3434

3535
#### Pre-aggregating vs non pre-aggregating API
3636

37-
`TrackMetric()` sends raw telemetry that denotes a metric. `TrackMetric()` is inefficient because it sends a single telemetry item for each value. `TrackMetric()` is also inefficient in terms of performance since every `TrackMetric(item)` goes through the full SDK pipeline of telemetry initializers and processors.
37+
`TrackMetric()` sends raw telemetry that denotes a metric. `TrackMetric()` is inefficient because it sends a single telemetry item for each value. `TrackMetric()` is also inefficient in terms of performance because every `TrackMetric(item)` goes through the full SDK pipeline of telemetry initializers and processors.
3838

39-
Unlike `TrackMetric()`, `GetMetric()` handles local pre-aggregation for you and then only submits an aggregated summary metric at a fixed interval of one minute. If you need to closely monitor some custom metric at the second or even millisecond level, you can use `GetMetric()` to do so while only incurring the storage and network traffic cost of only monitoring every minute. This behavior also greatly reduces the risk of throttling from occurring because the total number of telemetry items that need to be sent for an aggregated metric are greatly reduced.
39+
Unlike `TrackMetric()`, `GetMetric()` handles local pre-aggregation for you and then only submits an aggregated summary metric at a fixed interval of one minute. If you need to closely monitor some custom metric at the second or even millisecond level, you can use `GetMetric()` to do so while only incurring the storage and network traffic cost of only monitoring every minute. This behavior also greatly reduces the risk of throttling occurring because the total number of telemetry items that need to be sent for an aggregated metric are greatly reduced.
4040

4141
In Application Insights, custom metrics collected via `TrackMetric()` and `GetMetric()` aren't subject to [sampling](./sampling.md). Sampling important metrics can lead to scenarios where the alerting you may have built around these metrics could become unreliable. By never sampling your custom metrics, you can generally be confident that when your alert thresholds are breached, an alert will fire. Because custom metrics aren't sampled, there are some potential concerns, which are described below.
4242

@@ -249,7 +249,13 @@ By default, multi-dimensional metrics within the Metric explorer experience aren
249249
250250
### Enable multi-dimensional metrics
251251
252-
To enable multi-dimensional metrics for an Application Insights resource, Select **Usage and estimated costs** > **Custom Metrics** > **Send custom metrics to Azure Metric Store (With dimensions)** > **OK**.
252+
This section walks through enabling multi-dimensional metrics for an Application Insights resource.
253+
254+
1. In the [Azure portal](https://portal.azure.com), select the **Application Insights** resource.
255+
1. Select **Usage and estimated costs**.
256+
1. Select **Custom Metrics**.
257+
1. Select **Send custom metrics to Azure Metric Store (With dimensions)**.
258+
1. Select **OK**.
253259
254260
After you enable multi-dimensional metrics for an Application Insights resource and send new multi-dimensional telemetry, you can split a metric by dimension.
255261
@@ -344,7 +350,7 @@ After you enable multi-dimensional metrics for an Application Insights resource
344350

345351
The results display the rating value present in your review and the aggregated values.
346352

347-
6. To extract the **IncludesPhoto** dimension into a separate variable (column) to better observe it, use the following query.
353+
6. To extract the **IncludesPhoto** dimension into a separate variable (column) to better observe the dimension, use the following query.
348354

349355
```kql
350356
customMetrics

0 commit comments

Comments
 (0)