Skip to content

Commit 28a45c0

Browse files
committed
Changing to text-based per-language instrumentation guidance
1 parent e128279 commit 28a45c0

File tree

6 files changed

+14
-23
lines changed

6 files changed

+14
-23
lines changed

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

Lines changed: 14 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ Application Insights pricing is consumption-based; you pay for only what you use
4848

4949
## How do I instrument an application?
5050

51-
[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 the only way to instrument an application in which you don't have access to the source code.
51+
[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.
5252

5353
You only need to install the Application Insights SDK in the following circumstances:
5454

@@ -58,48 +58,39 @@ You only need to install the Application Insights SDK in the following circumsta
5858

5959
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.
6060

61-
Refer to the decision tree below to see what is available to instrument your app.
62-
6361
### [.NET](#tab/net)
6462

65-
:::image type="content" source="media/app-insights-overview/instrumentation-decision-tree-dotnet.png" alt-text="Diagram of a decision tree providing .NET instrumentation guidance." lightbox="media/app-insights-overview/instrumentation-decision-tree-dotnet.png":::
63+
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), [Azure Functions](../../azure-functions/functions-monitoring.md#monitor-executions-in-azure-functions), and [Azure Virtual Machines](azure-vm-vmss-apps.md).
6664

67-
- [Auto-Instrumentation](codeless-overview.md)
68-
- [Azure Application Insights libraries for .NET](https://docs.microsoft.com/dotnet/api/overview/azure/insights)
69-
- [Deploy the Azure Monitor Application Insights Agent on Azure virtual machines and Azure virtual machine scale sets](azure-vm-vmss-apps.md)
70-
- [Deploy Azure Monitor Application Insights Agent for on-premises servers](status-monitor-v2-overview.md)
65+
[Azure Monitor Application Insights Agent](status-monitor-v2-overview.md) is available for workloads running in on-premises virtual machines.
7166

67+
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).
7268

69+
For other scenarios, the [Application Insights SDK](https://docs.microsoft.com/dotnet/api/overview/azure/insights) is required, or a preview [Open Telemetry](opentelemetry-enable.md?tabs=net) offering is also available.
7370

7471
### [Java](#tab/java)
7572

76-
:::image type="content" source="media/app-insights-overview/instrumentation-decision-tree-java.png" alt-text="Diagram of a decision tree providing Java instrumentation guidance." lightbox="media/app-insights-overview/instrumentation-decision-tree-java.png":::
73+
Auto-instrumentation is available for Java 3.x and above using the [Azure Monitor OpenTelemetry-based auto-instrumentation for Java applications](java-in-process-agent.md).
7774

78-
Links:
79-
- [Azure Monitor OpenTelemetry-based auto-instrumentation for Java applications](java-in-process-agent.md)
75+
Integrated Auto-Instrumentation is available for Java Apps hosted on [Azure App Service](azure-web-apps-java.md) and [Azure Functions](monitor-functions.md#distributed-tracing-for-java-applications-public-preview).
8076

8177
### [Node.js](#tab/nodejs)
8278

83-
:::image type="content" source="media/app-insights-overview/instrumentation-decision-tree-node.png" alt-text="Diagram of a decision tree providing Node instrumentation guidance." lightbox="media/app-insights-overview/instrumentation-decision-tree-node.png":::
79+
Auto-instrumentation is available for [Azure App Service](azure-web-apps-nodejs.md).
8480

85-
Links:
86-
- [Enable Azure Monitor OpenTelemetry Exporter for .NET, Node.js, and Python applications](opentelemetry-enable.md)
87-
- [Monitor your Node.js services and apps with Application Insights](nodejs.md)
81+
The [Application Insights SDK](nodejs.md) is an alternative and we also have a preview [Open Telemetry](opentelemetry-enable.md?tabs=nodejs) offering available.
8882

8983
### [JavaScript](#tab/javascript)
9084

91-
:::image type="content" source="media/app-insights-overview/instrumentation-decision-tree-js.png" alt-text="Diagram of a decision tree providing JavaScript instrumentation guidance." lightbox="media/app-insights-overview/instrumentation-decision-tree-js.png":::
92-
93-
Links:
94-
- [Application Insights for webpages](javascript.md)
85+
JavaScript requires the installation of the [Application Insights SDK](javascript.md).
9586

9687
### [Python](#tab/python)
9788

98-
:::image type="content" source="media/app-insights-overview/instrumentation-decision-tree-python.png" alt-text="Diagram of a decision tree providing Python instrumentation guidance." lightbox="media/app-insights-overview/instrumentation-decision-tree-python.png":::
89+
Python applications can be monitored using [OpenCensus Python SDK via the Azure Monitor exporters](opencensus-python.md).
90+
91+
An extension is available for monitoring [Azure Functions](opencensus-python.md#integrate-with-azure-functions).
9992

100-
Links:
101-
- [Enable Azure Monitor OpenTelemetry Exporter for .NET, Node.js, and Python applications](opentelemetry-enable.md)
102-
- [Set up Azure Monitor for your Python application](opencensus-python.md)
93+
A preview [Open Telemetry](opentelemetry-enable.md?tabs=python) offering is also available.
10394

10495
---
10596

0 commit comments

Comments
 (0)