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
Copy file name to clipboardExpand all lines: articles/azure-monitor/app/app-insights-overview.md
+57-47Lines changed: 57 additions & 47 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,94 +7,102 @@ ms.date: 03/22/2023
7
7
8
8
# Application Insights overview
9
9
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:
11
11
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.
14
14
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":::
16
16
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).
18
18
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.
20
20
21
21
Application Insights provides other features including, but not limited to:
22
22
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.
28
28
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).
30
30
31
-
The [Application Map](app-map.md) allows a highlevel 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.
32
32
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).
34
34
35
35
## How do I use Application Insights?
36
36
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).
38
38
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.
40
40
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).
42
42
43
-
Consider starting with the [Application Map](app-map.md) for a highlevel 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.
44
44
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:
46
46
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.
48
49
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:
-[Optimize costs in Azure Monitor](../best-practices-cost.md)
50
56
51
57
## How do I instrument an application?
52
58
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.
54
60
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:
56
62
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.
60
66
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.
62
70
63
71
### [.NET](#tab/net)
64
72
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).
66
74
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.
68
76
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).
70
78
71
79
For other scenarios, the [Application Insights SDK](/dotnet/api/overview/azure/insights) is required.
72
80
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.
74
82
75
83
### [Java](#tab/java)
76
84
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).
78
86
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).
80
88
81
89
### [Node.js](#tab/nodejs)
82
90
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).
84
92
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.
86
94
87
95
### [JavaScript](#tab/javascript)
88
96
89
97
JavaScript requires the [Application Insights SDK](javascript.md).
90
98
91
99
### [Python](#tab/python)
92
100
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).
94
102
95
103
An extension is available for monitoring [Azure Functions](opencensus-python.md#integrate-with-azure-functions).
96
104
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.
98
106
99
107
---
100
108
@@ -120,17 +128,17 @@ This section lists all supported platforms and frameworks.
120
128
*[Azure Spring Apps](../../spring-apps/how-to-application-insights.md)
121
129
*[Azure Cloud Services](./azure-web-apps-net-core.md), including both web and worker roles
122
130
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)
@@ -154,7 +162,9 @@ This section lists all supported platforms and frameworks.
154
162
*[Power BI for workspace-based resources](../logs/log-powerbi.md)
155
163
156
164
### 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).
158
168
159
169
---------------------------
160
170
@@ -174,16 +184,16 @@ Post general questions to the Microsoft Q&A [answers forum](/answers/topics/2422
174
184
175
185
### Stack Overflow
176
186
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.
178
188
179
-
### User Voice
189
+
### Feedback Community
180
190
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).
182
192
183
193
## Next steps
184
194
185
195
-[Create a resource](create-workspace-resource.md)
0 commit comments