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/opentelemetry-enable.md
+13-14Lines changed: 13 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,21 +18,21 @@ This article describes how to enable and configure OpenTelemetry-based data coll
18
18
* allows collecting [custom](opentelemetry-add-modify.md#collect-custom-telemetry) telemetry, and
19
19
* supports [Live Metrics](live-stream.md) to monitor and collect more telemetry from live, in-production web applications.
20
20
21
-
For more information about the advantages of using the Azure Monitor OpenTelemetry Distro, see [Why should I use the Azure Monitor OpenTelemetry Distro?](#why-should-i-use-the-azure-monitor-opentelemetry-distro).
21
+
For more information about the advantages of using the Azure Monitor OpenTelemetry Distro, see [Why should I use the Azure Monitor OpenTelemetry Distro](#why-should-i-use-the-azure-monitor-opentelemetry-distro).
22
22
23
23
To learn more about collecting data using OpenTelemetry, see [Data Collection Basics](opentelemetry-overview.md) or [OpenTelemetry FAQ](#frequently-asked-questions).
24
24
25
25
## OpenTelemetry release status
26
26
27
-
OpenTelemetry offerings are available for .NET, Node.js, Python, and Java applications.
28
-
29
-
> [!NOTE]
30
-
> For a feature-by-feature release status, see the [FAQ](#whats-the-current-release-state-of-features-within-the-azure-monitor-opentelemetry-distro).
27
+
OpenTelemetry offerings are available for .NET, Node.js, Python, and Java applications. For a feature-by-feature release status, see the [FAQ](#whats-the-current-release-state-of-features-within-the-azure-monitor-opentelemetry-distro).
31
28
32
29
## Enable OpenTelemetry with Application Insights
33
30
34
31
Follow the steps in this section to instrument your application with OpenTelemetry. Select a tab for langauge-specific instructions.
35
32
33
+
> [!NOTE]
34
+
> .NET covers multiple scenarios, including classic ASP.NET, console apps, Windows Forms (WinForms), etc.
35
+
36
36
### Prerequisites
37
37
38
38
> [!div class="checklist"]
@@ -54,9 +54,6 @@ Follow the steps in this section to instrument your application with OpenTelemet
54
54
> [!div class="checklist"]
55
55
> * Application using a [supported version](https://dotnet.microsoft.com/platform/support/policy) of [.NET](https://dotnet.microsoft.com/download/dotnet) or [.NET Framework](https://dotnet.microsoft.com/download/dotnet-framework) 4.6.2 and later.
56
56
57
-
> [!NOTE]
58
-
> .NET covers multiple scenarios, including classic ASP.NET, console apps, Windows Forms (WinForms), etc.
59
-
60
57
> [!Tip]
61
58
> If you're migrating from the Application Insights Classic API, see our [migration documentation](./opentelemetry-dotnet-migrate.md).
62
59
@@ -76,7 +73,9 @@ Follow the steps in this section to instrument your application with OpenTelemet
76
73
> * Application using an officially [supported version](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/monitor/monitor-opentelemetry-exporter#currently-supported-environments) of Node.js runtime:<br>• [OpenTelemetry supported runtimes](https://github.com/open-telemetry/opentelemetry-js#supported-runtimes)<br>• [Azure Monitor OpenTelemetry Exporter supported runtimes](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/monitor/monitor-opentelemetry-exporter#currently-supported-environments)
77
74
78
75
> [!NOTE]
79
-
> If you rely on any properties in the [not-supported table](https://github.com/microsoft/ApplicationInsights-node.js/blob/beta/README.md#ApplicationInsights-Shim-Unsupported-Properties), use the distro, and we'll provide a migration guide soon. If not, the App Insights shim is your easiest path forward when it's out of beta.
76
+
> If you don't rely on any properties listed in the [not-supported table](https://github.com/microsoft/ApplicationInsights-node.js/blob/beta/README.md#ApplicationInsights-Shim-Unsupported-Properties), the *ApplicationInsights shim* will be your easiest path forward once out of beta.
77
+
>
78
+
> If you rely on any those properties, proceed with the Azure Monitor OpenTelemetry Distro. We'll provide a migration guide soon.
80
79
81
80
> [!Tip]
82
81
> If you're migrating from the Application Insights Classic API, see our [migration documentation](./opentelemetry-nodejs-migrate.md).
@@ -124,13 +123,13 @@ Download the [applicationinsights-agent-3.5.4.jar](https://github.com/microsoft/
124
123
125
124
#### [Java native](#tab/java-native)
126
125
127
-
For Spring Boot native applications:
126
+
**For Spring Boot native applications:**
128
127
129
128
*[Import the OpenTelemetry Bills of Materials (BOM)](https://opentelemetry.io/docs/zero-code/java/spring-boot-starter/getting-started/).
130
129
* Add the [Spring Cloud Azure Starter Monitor](https://central.sonatype.com/artifact/com.azure.spring/spring-cloud-azure-starter-monitor) dependency.
131
130
* Follow [these instructions](/azure//developer/java/spring-framework/developer-guide-overview#configuring-spring-boot-3) for the Azure SDK JAR (Java Archive) files.
132
131
133
-
For Quarkus native applications:
132
+
**For Quarkus native applications:**
134
133
135
134
* Add the [Quarkus OpenTelemetry Exporter for Azure](https://mvnrepository.com/artifact/io.quarkiverse.opentelemetry.exporter/quarkus-opentelemetry-exporter-azure) dependency.
136
135
@@ -224,7 +223,7 @@ Java autoinstrumentation is enabled through configuration changes; no code chang
224
223
225
224
Point the Java virtual machine (JVM) to the jar file by adding `-javaagent:"path/to/applicationinsights-agent-3.5.4.jar"` to your application's JVM args.
226
225
227
-
> [!TIP]
226
+
> [!NOTE]
228
227
> Sampling is enabled by default at a rate of 5 requests per second, aiding in cost management. Telemetry data may be missing in scenarios exceeding this rate. For more information on modifying sampling configuration, see [sampling overrides](./java-standalone-sampling-overrides.md).
229
228
230
229
> [!TIP]
@@ -267,10 +266,10 @@ configure_azure_monitor()
267
266
268
267
### Copy the connection string from your Application Insights resource
269
268
270
-
The connection string is unique and specifies where the distro sends the telemetry it collects.
269
+
The connection string is unique and specifies where the Azure Monitor OpenTelemetry Distro sends the telemetry it collects.
271
270
272
271
> [!TIP]
273
-
> If you don't already have one, [create an Application Insights resource](create-workspace-resource.md#create-a-workspace-based-resource). We recommend you create a new one [rather than using an existing Application Insights resource](create-workspace-resource.md#when-to-use-a-single-application-insights-resource).
272
+
> If you don't already have an Application Insights resource, create one following [this guide](create-workspace-resource.md#create-a-workspace-based-resource). We recommend you create a new resource rather than [using an existing one](create-workspace-resource.md#when-to-use-a-single-application-insights-resource).
0 commit comments