|
2 | 2 | title: Monitor your apps without code changes - auto-instrumentation for Azure Monitor Application Insights | Microsoft Docs |
3 | 3 | description: Overview of auto-instrumentation for Azure Monitor Application Insights - codeless application performance management |
4 | 4 | ms.topic: conceptual |
5 | | -ms.date: 08/31/2021 |
| 5 | +ms.date: 10/19/2022 |
6 | 6 | ms.reviewer: abinetabate |
7 | 7 | --- |
8 | 8 |
|
9 | | -# What is auto-instrumentation for Azure Monitor application insights? |
| 9 | +# What is auto-instrumentation for Azure Monitor Application Insights? |
10 | 10 |
|
11 | | -Auto-instrumentation allows you to enable application monitoring with Application Insights without changing your code. |
12 | | - |
13 | | -Application Insights is integrated with various resource providers and works on different environments. In essence, all you have to do is enable and - in some cases - configure the agent, which will collect the telemetry automatically. In no time, you'll see the metrics, requests, and dependencies in your Application Insights resource. This telemetry will allow you to spot the source of potential problems before they occur, and analyze the root cause with end-to-end transaction view. |
14 | | - |
15 | | -> [!NOTE] |
16 | | -> Auto-instrumentation used to be known as "codeless attach" before October 2021. |
| 11 | +Auto-instrumentation collects [Application Insights](app-insights-overview.md) [telemetry](data-model.md). |
17 | 12 |
|
| 13 | +> [!div class="checklist"] |
| 14 | +> - No code changes required |
| 15 | +> - [SDK update](sdk-support-guidance.md) overhead is eliminated |
| 16 | +> - Recommended when available |
18 | 17 |
|
19 | 18 | ## Supported environments, languages, and resource providers |
20 | 19 |
|
21 | | -As we're adding new integrations, the auto-instrumentation capability matrix becomes complex. The table below shows you the current state of the matter as far as support for various resource providers, languages, and environments go. |
22 | | - |
23 | | -|Environment/Resource Provider | .NET | .NET Core | Java | Node.js | Python | |
24 | | -|---------------------------------------|-----------------|-----------------|-----------------|-----------------|-----------------| |
25 | | -|Azure App Service on Windows - Publish as Code | GA, OnBD* | GA | GA | GA, OnBD* | Not supported | |
26 | | -|Azure App Service on Windows - Publish as Docker | Public Preview | Public Preview | Public Preview | Not supported | Not supported | |
27 | | -|Azure App Service on Linux | N/A | Public Preview | GA | GA | Not supported | |
28 | | -|Azure Functions - basic | GA, OnBD* | GA, OnBD* | GA, OnBD* | GA, OnBD* | GA, OnBD* | |
29 | | -|Azure Functions - dependencies | Not supported | Not supported | Public Preview | Not supported | Through [extension](monitor-functions.md#distributed-tracing-for-python-function-apps) | |
30 | | -|Azure Spring Cloud | Not supported | Not supported | GA | Not supported | Not supported | |
31 | | -|Azure Kubernetes Service (AKS) | N/A | Not supported | Through agent | Not supported | Not supported | |
32 | | -|Azure VMs Windows | Public Preview | Public Preview | Through agent | Not supported | Not supported | |
33 | | -|On-Premises VMs Windows | GA, opt-in | Public Preview | Through agent | Not supported | Not supported | |
34 | | -|Standalone agent - any env. | Not supported | Not supported | GA | Not supported | Not supported | |
35 | | - |
36 | | -*OnBD is short for On by Default - the Application Insights will be enabled automatically once you deploy your app in supported environments. |
37 | | - |
38 | | -## Azure App Service |
39 | | - |
40 | | -### Windows |
41 | | - |
42 | | -Application monitoring on Azure App Service on Windows is available for **[ASP.NET](./azure-web-apps-net.md)** (enabled by default), **[ASP.NET Core](./azure-web-apps-net-core.md)**, **[Java](./azure-web-apps-java.md)** (in public preview), and **[Node.js](./azure-web-apps-nodejs.md)** applications. To monitor a Python app, add the [SDK](./opencensus-python.md) to your code. |
43 | | - |
44 | | -> [!NOTE] |
45 | | -> Application monitoring for apps on Windows Containers on App Service [is in public preview for .NET Core, .NET Framework, and Java](https://azure.github.io/AppService/2022/04/11/windows-containers-app-insights-preview.html). |
| 20 | +The table below displays the current state of auto-instrumentation availability. |
46 | 21 |
|
47 | | -### Linux |
48 | | -You can enable monitoring for **[Java](./azure-web-apps-java.md?)**, **[Node.js](./azure-web-apps-nodejs.md?tabs=linux)**, and **[ASP.NET Core](./azure-web-apps-net-core.md?tabs=linux)(Preview)** apps running on Linux in App Service through the portal. |
| 22 | +Links are provided to additional information for each supported scenario. |
49 | 23 |
|
50 | | -For [Python](./opencensus-python.md), use the SDK. |
| 24 | +|Environment/Resource Provider | .NET Framework | .NET Core / .NET | Java | Node.js | Python | |
| 25 | +|-------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------| |
| 26 | +|Azure App Service on Windows - Publish as Code | [ :white_check_mark: :link: ](azure-web-apps-net.md) <sup>[1](#OnBD)</sup> | [ :white_check_mark: :link: ](azure-web-apps-net-core.md) <sup>[1](#OnBD)</sup> | [ :white_check_mark: :link: ](azure-web-apps-java.md) | [ :white_check_mark: :link: ](azure-web-apps-nodejs.md) <sup>[1](#OnBD)</sup> | :x: | |
| 27 | +|Azure App Service on Windows - Publish as Docker | [ :white_check_mark: ](https://azure.github.io/AppService/2022/04/11/windows-containers-app-insights-preview.html) <sup>[2](#Preview)</sup> | [ :white_check_mark: ](https://azure.github.io/AppService/2022/04/11/windows-containers-app-insights-preview.html) <sup>[2](#Preview)</sup> | [ :white_check_mark: ](https://azure.github.io/AppService/2022/04/11/windows-containers-app-insights-preview.html) <sup>[2](#Preview)</sup> | :x: | :x: | |
| 28 | +|Azure App Service on Linux | :x: | [ :white_check_mark: :link: ](azure-web-apps-net-core.md?tabs=linux) <sup>[2](#Preview)</sup> | [ :white_check_mark: :link: ](azure-web-apps-java.md) | [ :white_check_mark: :link: ](azure-web-apps-nodejs.md?tabs=linux) | :x: | |
| 29 | +|Azure Functions - basic | [ :white_check_mark: :link: ](monitor-functions.md) <sup>[1](#OnBD)</sup> | [ :white_check_mark: :link: ](monitor-functions.md) <sup>[1](#OnBD)</sup> | [ :white_check_mark: :link: ](monitor-functions.md) <sup>[1](#OnBD)</sup> | [ :white_check_mark: :link: ](monitor-functions.md) <sup>[1](#OnBD)</sup> | [ :white_check_mark: :link: ](monitor-functions.md) <sup>[1](#OnBD)</sup> | |
| 30 | +|Azure Functions - dependencies | :x: | :x: | [ :white_check_mark: :link: ](monitor-functions.md) <sup>[2](#Preview)</sup> | :x: | [ :white_check_mark: :link: ](monitor-functions.md#distributed-tracing-for-python-function-apps) | |
| 31 | +|Azure Spring Cloud | :x: | :x: | [ :white_check_mark: :link: ](azure-web-apps-java.md) | :x: | :x: | |
| 32 | +|Azure Kubernetes Service (AKS) | :x: | :x: | [ :white_check_mark: :link: ](java-in-process-agent.md) | :x: | :x: | |
| 33 | +|Azure VMs Windows | [ :white_check_mark: :link: ](azure-vm-vmss-apps.md) <sup>[2](#Preview)</sup> <sup>[3](#Agent)</sup> | [ :white_check_mark: :link: ](azure-vm-vmss-apps.md) <sup>[2](#Preview)</sup> <sup>[3](#Agent)</sup> | [ :white_check_mark: :link: ](java-in-process-agent.md) | :x: | :x: | |
| 34 | +|On-premises VMs Windows | [ :white_check_mark: :link: ](status-monitor-v2-overview.md) <sup>[3](#Agent)</sup> | [ :white_check_mark: :link: ](status-monitor-v2-overview.md) <sup>[2](#Preview)</sup> <sup>[3](#Agent)</sup> | [ :white_check_mark: :link: ](java-in-process-agent.md) | :x: | :x: | |
| 35 | +|Standalone agent - any environment | :x: | :x: | [ :white_check_mark: :link: ](java-in-process-agent.md) | :x: | :x: | |
51 | 36 |
|
52 | | -## Azure Functions |
| 37 | +**Footnotes** |
| 38 | +- <a name="OnBD">1</a>: Application Insights is on by default and enabled automatically. |
| 39 | +- <a name="Preview">2</a>: This feature is in public preview. [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) |
| 40 | +- <a name="Agent">3</a>: An agent must be deployed and configured. |
53 | 41 |
|
54 | | -The basic monitoring for Azure Functions is enabled by default to collect log, performance, error data, and HTTP requests. For Java applications, you can enable richer monitoring with distributed tracing and get the end-to-end transaction details. This functionality for Java is in public preview for Windows and you can [enable it in Azure portal](./monitor-functions.md). |
55 | | - |
56 | | -## Azure Spring Cloud |
57 | | - |
58 | | -### Java |
59 | | -Application monitoring for Java apps running in Azure Spring Cloud is integrated into the portal, you can enable Application Insights directly from the Azure portal, both for the existing and newly created Azure Spring Cloud resources. |
60 | | - |
61 | | -## Azure Kubernetes Service (AKS) |
62 | | - |
63 | | -Codeless instrumentation of Azure Kubernetes Service (AKS) is currently available for Java applications through the [standalone agent](./java-in-process-agent.md). |
64 | | - |
65 | | -## Azure Windows VMs and virtual machine scale set |
66 | | - |
67 | | -Auto-instrumentation for Azure VMs and virtual machine scale set is available for [.NET](./azure-vm-vmss-apps.md) and [Java](./java-in-process-agent.md) - this experience isn't integrated into the portal. The monitoring is enabled through a few steps with a stand-alone solution and doesn't require any code changes. |
68 | | - |
69 | | -## On-premises servers |
70 | | -You can easily enable monitoring for your [on-premises Windows servers for .NET applications](./status-monitor-v2-overview.md) and for [Java apps](./java-in-process-agent.md). |
71 | | - |
72 | | -## Other environments |
73 | | -The versatile Java standalone agent works on any environment, there's no need to instrument your code. [Follow the guide](./java-in-process-agent.md) to enable Application Insights and read about the amazing capabilities of the Java agent. The agent is in public preview and available on all regions. |
| 42 | +> [!NOTE] |
| 43 | +> Auto-instrumentation was known as "codeless attach" before October 2021. |
74 | 44 |
|
75 | 45 | ## Next steps |
76 | 46 |
|
77 | | -* [Application Insights Overview](./app-insights-overview.md) |
78 | | -* [Application map](./app-map.md) |
79 | | -* [End-to-end performance monitoring](../app/tutorial-performance.md) |
| 47 | +* [Application Insights Overview](app-insights-overview.md) |
| 48 | +* [Application Insights Overview dashboard](overview-dashboard.md) |
| 49 | +* [Application map](app-map.md) |
0 commit comments