Skip to content

Commit a057fc3

Browse files
authored
Merge pull request #234003 from paulth1/app-articles-batch-22
[AQ] edit pass: App articles batch 22
2 parents e363a4b + b2483d3 commit a057fc3

File tree

5 files changed

+379
-447
lines changed

5 files changed

+379
-447
lines changed

articles/azure-monitor/app/app-insights-overview.md

Lines changed: 57 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -7,94 +7,102 @@ ms.date: 03/22/2023
77

88
# Application Insights overview
99

10-
Application Insights is an extension of [Azure Monitor](../overview.md) and provides Application Performance Monitoring (also known as “APM) features. APM tools are useful to monitor applications from development, through test, and into production in the following ways:
10+
Application Insights is an extension of [Azure Monitor](../overview.md) and provides application performance monitoring (APM) features. APM tools are useful to monitor applications from development, through test, and into production in the following ways:
1111

12-
1. *Proactively* understand how an application is performing.
13-
1. *Reactively* review application execution data to determine the cause of an incident.
12+
- *Proactively* understand how an application is performing.
13+
- *Reactively* review application execution data to determine the cause of an incident.
1414

15-
:::image type="content" source="media/overview-dashboard/0001-dashboard.png" alt-text="Screenshot of Application Insights in the Azure portal." lightbox="media/overview-dashboard/0001-dashboard.png":::
15+
:::image type="content" source="media/overview-dashboard/0001-dashboard.png" alt-text="Screenshot that shows Application Insights in the Azure portal." lightbox="media/overview-dashboard/0001-dashboard.png":::
1616

17-
In addition to collecting [Metrics](standard-metrics.md) and application [Telemetry](data-model-complete.md) data, which describe application activities and health, Application Insights can also be used to collect and store application [trace logging data](asp-net-trace-logs.md).
17+
Along with collecting [metrics](standard-metrics.md) and application [telemetry](data-model-complete.md) data, which describe application activities and health, you can use Application Insights to collect and store application [trace logging data](asp-net-trace-logs.md).
1818

19-
The [log trace](asp-net-trace-logs.md) is associated with other telemetry to give a detailed view of the activity. Adding trace logging to existing apps only requires providing a destination for the logs; the logging framework rarely needs to be changed.
19+
The [log trace](asp-net-trace-logs.md) is associated with other telemetry to give a detailed view of the activity. Adding trace logging to existing apps only requires providing a destination for the logs. You rarely need to change the logging framework.
2020

2121
Application Insights provides other features including, but not limited to:
2222

23-
- [Live Metrics](live-stream.md) – observe activity from your deployed application in real time with no effect on the host environment
24-
- [Availability](availability-overview.md) – also known as “Synthetic Transaction Monitoring”, probe your applications external endpoint(s) to test the overall availability and responsiveness over time
25-
- [GitHub or Azure DevOps integration](work-item-integration.md) – create [GitHub](/training/paths/github-administration-products/) or [Azure DevOps](/azure/devops/) work items in context of Application Insights data
26-
- [Usage](usage-overview.md) – understand which features are popular with users and how users interact and use your application
27-
- [Smart Detection](proactive-diagnostics.md) – automatic failure and anomaly detection through proactive telemetry analysis
23+
- [Live Metrics](live-stream.md): Observe activity from your deployed application in real time with no effect on the host environment.
24+
- [Availability](availability-overview.md): Also known as synthetic transaction monitoring. Probe the external endpoints of your applications to test the overall availability and responsiveness over time.
25+
- [GitHub or Azure DevOps integration](work-item-integration.md): Create [GitHub](/training/paths/github-administration-products/) or [Azure DevOps](/azure/devops/) work items in the context of Application Insights data.
26+
- [Usage](usage-overview.md): Understand which features are popular with users and how users interact and use your application.
27+
- [Smart detection](proactive-diagnostics.md): Detect failures and anomalies automatically through proactive telemetry analysis.
2828

29-
In addition, Application Insights supports [Distributed Tracing](distributed-tracing.md), also known as distributed component correlation. This feature allows [searching for](diagnostic-search.md) and [visualizing](transaction-diagnostics.md) an end-to-end flow of a given execution or transaction. The ability to trace activity end-to-end is increasingly important for applications that have been built as distributed components or [microservices](/azure/architecture/guide/architecture-styles/microservices).
29+
Application Insights supports [distributed tracing](distributed-tracing.md), which is also known as distributed component correlation. This feature allows [searching for](diagnostic-search.md) and [visualizing](transaction-diagnostics.md) an end-to-end flow of a specific execution or transaction. The ability to trace activity from end to end is important for applications that were built as distributed components or [microservices](/azure/architecture/guide/architecture-styles/microservices).
3030

31-
The [Application Map](app-map.md) allows a high level top-down view of the application architecture and at-a-glance visual references to component health and responsiveness.
31+
The [Application Map](app-map.md) allows a high-level, top-down view of the application architecture and at-a-glance visual references to component health and responsiveness.
3232

33-
To understand the number of Application Insights resources required to cover your Application or components across environments, see the [Application Insights deployment planning guide](separate-resources.md).
33+
To understand the number of Application Insights resources required to cover your application or components across environments, see the [Application Insights deployment planning guide](separate-resources.md).
3434

3535
## How do I use Application Insights?
3636

37-
Application Insights is enabled through either [Auto-Instrumentation](codeless-overview.md) (agent) or by adding the [Application Insights SDK](sdk-support-guidance.md) to your application code. [Many languages](platforms.md) are supported and the applications could be on Azure, on-premises, or hosted by another cloud. To figure out which type of instrumentation is best for you, reference [How do I instrument an application?](#how-do-i-instrument-an-application).
37+
Application Insights is enabled through either [autoinstrumentation](codeless-overview.md) (agent) or by adding the [Application Insights SDK](sdk-support-guidance.md) to your application code. [Many languages](platforms.md) are supported. The applications could be on Azure, on-premises, or hosted by another cloud. To figure out which type of instrumentation is best for you, see [How do I instrument an application?](#how-do-i-instrument-an-application).
3838

39-
The Application Insights agent or SDK pre-processes telemetry and metrics before sending the data to Azure where it's ingested and processed further before being stored in Azure Monitor Logs (Log Analytics). For this reason, an Azure account is required to use Application Insights.
39+
The Application Insights agent or SDK preprocesses telemetry and metrics before sending the data to Azure. Then it's ingested and processed further before it's stored in Azure Monitor Logs (Log Analytics). For this reason, an Azure account is required to use Application Insights.
4040

41-
The easiest way to get started consuming Application insights is through the Azure portal and the built-in visual experiences. Advanced users can [query the underlying data](../logs/log-query-overview.md) directly to [build custom visualizations](tutorial-app-dashboards.md) through Azure Monitor [Dashboards](overview-dashboard.md) and [Workbooks](../visualize/workbooks-overview.md).
41+
The easiest way to get started consuming Application insights is through the Azure portal and the built-in visual experiences. Advanced users can [query the underlying data](../logs/log-query-overview.md) directly to [build custom visualizations](tutorial-app-dashboards.md) through Azure Monitor [dashboards](overview-dashboard.md) and [workbooks](../visualize/workbooks-overview.md).
4242

43-
Consider starting with the [Application Map](app-map.md) for a high level view. Use the [Search](diagnostic-search.md) experience to quickly narrow down telemetry and data by type and date-time, or search within data (for example Log Traces) and filter to a given correlated operation of interest.
43+
Consider starting with the [Application Map](app-map.md) for a high-level view. Use the [Search](diagnostic-search.md) experience to quickly narrow down telemetry and data by type and date-time. Or you can search within data (for example, with Log Traces) and filter to a given correlated operation of interest.
4444

45-
Jump into analytics with [Performance view](tutorial-performance.md) – get deep insights into how your Application or API and downstream dependencies are performing and find for a representative sample to [explore end to end](transaction-diagnostics.md). And, be proactive with the [Failure view](tutorial-runtime-exceptions.md) – understand which components or actions are generating failures and triage errors and exceptions. The built-in views are helpful to track application health proactively and for reactive root-cause-analysis.
45+
Two views are especially useful:
4646

47-
[Create Azure Monitor Alerts](tutorial-alert.md) to signal potential issues should your Application or components parts deviate from the established baseline.
47+
- [Performance view](tutorial-performance.md): Get deep insights into how your application or API and downstream dependencies are performing. You can also find a representative sample to [explore end to end](transaction-diagnostics.md).
48+
- [Failure view](tutorial-runtime-exceptions.md): Understand which components or actions are generating failures and triage errors and exceptions. The built-in views are helpful to track application health proactively and for reactive root-cause analysis.
4849

49-
Application Insights pricing is consumption-based; you pay for only what you use. For more information on pricing, see the [Azure Monitor Pricing page](https://azure.microsoft.com/pricing/details/monitor/) and [how to optimize costs](../best-practices-cost.md).
50+
[Create Azure Monitor alerts](tutorial-alert.md) to signal potential issues in case your application or components parts deviate from the established baseline.
51+
52+
Application Insights pricing is based on consumption. You only pay for what you use. For more information on pricing, see:
53+
54+
- [Azure Monitor pricing](https://azure.microsoft.com/pricing/details/monitor/)
55+
- [Optimize costs in Azure Monitor](../best-practices-cost.md)
5056

5157
## How do I instrument an application?
5258

53-
[Auto-Instrumentation](codeless-overview.md) is the preferred instrumentation method. It requires no developer investment and eliminates future overhead related to [updating the SDK](sdk-support-guidance.md). It's also the only way to instrument an application in which you don't have access to the source code.
59+
[Autoinstrumentation](codeless-overview.md) is the preferred instrumentation method. It requires no developer investment and eliminates future overhead related to [updating the SDK](sdk-support-guidance.md). It's also the only way to instrument an application in which you don't have access to the source code.
5460

55-
You only need to install the Application Insights SDK in the following circumstances:
61+
You only need to install the Application Insights SDK if:
5662

57-
- You require [custom events and metrics](api-custom-events-metrics.md)
58-
- You require control over the flow of telemetry
59-
- [Auto-Instrumentation](codeless-overview.md) isn't available (typically due to language or platform limitations)
63+
- You require [custom events and metrics](api-custom-events-metrics.md).
64+
- You require control over the flow of telemetry.
65+
- [Autoinstrumentation](codeless-overview.md) isn't available, typically because of language or platform limitations.
6066

61-
To use the SDK, you install a small instrumentation package in your app and then instrument the web app, any background components, and JavaScript within the web pages. The app and its components don't have to be hosted in Azure. The instrumentation monitors your app and directs the telemetry data to an Application Insights resource by using a unique token. The effect on your app's performance is small; tracking calls are non-blocking and batched to be sent in a separate thread.
67+
To use the SDK, you install a small instrumentation package in your app and then instrument the web app, any background components, and JavaScript within the webpages. The app and its components don't have to be hosted in Azure.
68+
69+
The instrumentation monitors your app and directs the telemetry data to an Application Insights resource by using a unique token. The effect on your app's performance is small. Tracking calls are nonblocking and batched to be sent in a separate thread.
6270

6371
### [.NET](#tab/net)
6472

65-
Integrated Auto-instrumentation is available for [Azure App Service .NET](azure-web-apps-net.md), [Azure App Service .NET Core](azure-web-apps-net-core.md), [Azure Functions](../../azure-functions/functions-monitoring.md), and [Azure Virtual Machines](azure-vm-vmss-apps.md).
73+
Integrated autoinstrumentation is available for [Azure App Service .NET](azure-web-apps-net.md), [Azure App Service .NET Core](azure-web-apps-net-core.md), [Azure Functions](../../azure-functions/functions-monitoring.md), and [Azure Virtual Machines](azure-vm-vmss-apps.md).
6674

67-
[Azure Monitor Application Insights Agent](application-insights-asp-net-agent.md) is available for workloads running in on-premises virtual machines.
75+
The [Azure Monitor Application Insights agent](application-insights-asp-net-agent.md) is available for workloads running in on-premises virtual machines.
6876

69-
A detailed view of all Auto-instrumentation supported environments, languages, and resource providers are available [here](codeless-overview.md#supported-environments-languages-and-resource-providers).
77+
For a detailed view of all autoinstrumentation supported environments, languages, and resource providers, see [What is autoinstrumentation for Azure Monitor Application Insights?](codeless-overview.md#supported-environments-languages-and-resource-providers).
7078

7179
For other scenarios, the [Application Insights SDK](/dotnet/api/overview/azure/insights) is required.
7280

73-
A preview [Open Telemetry](opentelemetry-enable.md?tabs=net) offering is also available.
81+
A preview [OpenTelemetry](opentelemetry-enable.md?tabs=net) offering is also available.
7482

7583
### [Java](#tab/java)
7684

77-
Integrated Auto-Instrumentation is available for Java Apps hosted on [Azure App Service](azure-web-apps-java.md) and [Azure Functions](monitor-functions.md).
85+
Integrated autoinstrumentation is available for Java Apps hosted on [Azure App Service](azure-web-apps-java.md) and [Azure Functions](monitor-functions.md).
7886

79-
Auto-instrumentation is available for any environment using [Azure Monitor OpenTelemetry-based auto-instrumentation for Java applications](opentelemetry-enable.md?tabs=java).
87+
Autoinstrumentation is available for any environment by using [Azure Monitor OpenTelemetry-based autoinstrumentation for Java applications](opentelemetry-enable.md?tabs=java).
8088

8189
### [Node.js](#tab/nodejs)
8290

83-
Auto-instrumentation is available for [Azure App Service](azure-web-apps-nodejs.md).
91+
Autoinstrumentation is available for [Azure App Service](azure-web-apps-nodejs.md).
8492

85-
The [Application Insights SDK](nodejs.md) is an alternative and we also have a preview [Open Telemetry](opentelemetry-enable.md?tabs=nodejs) offering available.
93+
The [Application Insights SDK](nodejs.md) is an alternative. We also have a preview [OpenTelemetry](opentelemetry-enable.md?tabs=nodejs) offering available.
8694

8795
### [JavaScript](#tab/javascript)
8896

8997
JavaScript requires the [Application Insights SDK](javascript.md).
9098

9199
### [Python](#tab/python)
92100

93-
Python applications can be monitored using [OpenCensus Python SDK via the Azure Monitor exporters](opencensus-python.md).
101+
Python applications can be monitored by using [OpenCensus Python SDK via the Azure Monitor exporters](opencensus-python.md).
94102

95103
An extension is available for monitoring [Azure Functions](opencensus-python.md#integrate-with-azure-functions).
96104

97-
A preview [Open Telemetry](opentelemetry-enable.md?tabs=python) offering is also available.
105+
A preview [OpenTelemetry](opentelemetry-enable.md?tabs=python) offering is also available.
98106

99107
---
100108

@@ -120,17 +128,17 @@ This section lists all supported platforms and frameworks.
120128
* [Azure Spring Apps](../../spring-apps/how-to-application-insights.md)
121129
* [Azure Cloud Services](./azure-web-apps-net-core.md), including both web and worker roles
122130

123-
#### Auto-instrumentation (enable without code changes)
124-
* [ASP.NET - for web apps hosted with IIS](./application-insights-asp-net-agent.md)
125-
* [ASP.NET Core - for web apps hosted with IIS](./application-insights-asp-net-agent.md)
131+
#### Autoinstrumentation (enable without code changes)
132+
* [ASP.NET: For web apps hosted with IIS](./application-insights-asp-net-agent.md)
133+
* [ASP.NET Core: For web apps hosted with IIS](./application-insights-asp-net-agent.md)
126134
* [Java](./opentelemetry-enable.md?tabs=java)
127135

128-
#### Manual instrumentation / SDK (some code changes required)
136+
#### Manual instrumentation/SDK (some code changes required)
129137
* [ASP.NET](./asp-net.md)
130138
* [ASP.NET Core](./asp-net-core.md)
131139
* [Node.js](./nodejs.md)
132140
* [Python](./opencensus-python.md)
133-
* [JavaScript - web](./javascript.md)
141+
* [JavaScript: Web](./javascript.md)
134142
* [React](./javascript-framework-extensions.md)
135143
* [React Native](./javascript-framework-extensions.md)
136144
* [Angular](./javascript-framework-extensions.md)
@@ -154,7 +162,9 @@ This section lists all supported platforms and frameworks.
154162
* [Power BI for workspace-based resources](../logs/log-powerbi.md)
155163

156164
### Unsupported SDKs
157-
Several other community-supported Application Insights SDKs exist. However, Azure Monitor only provides support when you use the supported instrumentation options listed on this page. We're constantly assessing opportunities to expand our support for other languages. Follow [Azure Updates for Application Insights](https://azure.microsoft.com/updates/?query=application%20insights) for the latest SDK news.
165+
Several other community-supported Application Insights SDKs exist. Azure Monitor only provides support when you use the supported instrumentation options listed in this article.
166+
167+
We're constantly assessing opportunities to expand our support for other languages. For the latest SDK news, see [Azure updates for Application Insights](https://azure.microsoft.com/updates/?query=application%20insights).
158168

159169
---------------------------
160170

@@ -174,16 +184,16 @@ Post general questions to the Microsoft Q&A [answers forum](/answers/topics/2422
174184

175185
### Stack Overflow
176186

177-
Post coding questions to [Stack Overflow](https://stackoverflow.com/questions/tagged/azure-application-insights) using an Application Insights tag.
187+
Post coding questions to [Stack Overflow](https://stackoverflow.com/questions/tagged/azure-application-insights) by using an Application Insights tag.
178188

179-
### User Voice
189+
### Feedback Community
180190

181-
Leave product feedback for the engineering team on [UserVoice](https://feedback.azure.com/d365community/forum/3887dc70-2025-ec11-b6e6-000d3a4f09d0).
191+
Leave product feedback for the engineering team in the [Feedback Community](https://feedback.azure.com/d365community/forum/3887dc70-2025-ec11-b6e6-000d3a4f09d0).
182192

183193
## Next steps
184194

185195
- [Create a resource](create-workspace-resource.md)
186-
- [Auto-instrumentation overview](codeless-overview.md)
196+
- [Autoinstrumentation overview](codeless-overview.md)
187197
- [Overview dashboard](overview-dashboard.md)
188198
- [Availability overview](availability-overview.md)
189199
- [Application Map](app-map.md)

0 commit comments

Comments
 (0)