Skip to content

Commit 133c467

Browse files
committed
Changing structure/headers
1 parent 4bb2759 commit 133c467

File tree

1 file changed

+22
-28
lines changed

1 file changed

+22
-28
lines changed

articles/azure-monitor/app/opentelemetry-enable.md

Lines changed: 22 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,14 @@ ms.reviewer: mmcc
1111

1212
# Enable Azure Monitor OpenTelemetry for .NET, Node.js, Python, and Java applications
1313

14-
This article describes how to enable and configure OpenTelemetry-based data collection within [Application Insights](app-insights-overview.md#application-insights-overview).
14+
This article describes how to enable and configure OpenTelemetry-based data collection within [Application Insights](app-insights-overview.md#application-insights-overview). The Azure Monitor OpenTelemetry Distro:
1515

16-
The Azure Monitor OpenTelemetry Distro:
16+
* provides an [OpenTelemetry distribution](https://opentelemetry.io/docs/concepts/distributions/#what-is-a-distribution) which includes support for features specific to Azure Monitor,
17+
* enables [automatic](opentelemetry-add-modify.md#automatic-data-collection) telemetry by including OpenTelemetry instrumentation libraries for collecting traces, metrics, logs, and exceptions,
18+
* allows collecting [custom](opentelemetry-add-modify.md#collect-custom-telemetry) telemetry, and
19+
* supports [Live Metrics](live-stream.md) to monitor and collect more telemetry from live, in-production web applications.
1720

18-
* Provides an [OpenTelemetry distribution](https://opentelemetry.io/docs/concepts/distributions/#what-is-a-distribution) that includes support for features specific to Azure Monitor.
19-
* Enables [automatic](opentelemetry-add-modify.md#automatic-data-collection) telemetry by including OpenTelemetry instrumentation libraries for collecting traces, metrics, logs, and exceptions.
20-
* Allows collecting [custom](opentelemetry-add-modify.md#collect-custom-telemetry) telemetry.
21-
* Supports [Live Metrics](live-stream.md) to monitor and collect more telemetry from live, in-production web applications.
22-
23-
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).
2422

2523
To learn more about collecting data using OpenTelemetry, see [Data Collection Basics](opentelemetry-overview.md) or [OpenTelemetry FAQ](#frequently-asked-questions).
2624

@@ -29,63 +27,61 @@ To learn more about collecting data using OpenTelemetry, see [Data Collection Ba
2927
OpenTelemetry offerings are available for .NET, Node.js, Python, and Java applications.
3028

3129
> [!NOTE]
32-
> * For a feature-by-feature release status, see the [FAQ](#whats-the-current-release-state-of-features-within-the-azure-monitor-opentelemetry-distro).
30+
> For a feature-by-feature release status, see the [FAQ](#whats-the-current-release-state-of-features-within-the-azure-monitor-opentelemetry-distro).
3331
32+
## Enable OpenTelemetry with Application Insights
3433

34+
Follow the steps in this section to instrument your application with OpenTelemetry. Select a tab for langauge-specific instructions.
3535

36-
## Prerequisites
36+
### Prerequisites
3737

3838
> [!div class="checklist"]
3939
> * Azure subscription: [Create an Azure subscription for free](https://azure.microsoft.com/free/)
4040
> * Application Insights resource: [Create an Application Insights resource](create-workspace-resource.md#create-a-workspace-based-resource)
4141
4242
<!---NOTE TO CONTRIBUTORS: PLEASE DO NOT SEPARATE OUT JAVASCRIPT AND TYPESCRIPT INTO DIFFERENT TABS.--->
4343

44-
## Get started
45-
46-
Follow the steps in this section to instrument your application with OpenTelemetry. Select a tab for langauge-specific instructions.
47-
48-
> [!NOTE]
49-
> The .NET covers multiple scenarios, including classic ASP.NET, console apps, Windows Forms (WinForms), etc.
50-
51-
### [ASP.NET Core](#tab/aspnetcore)
44+
#### [ASP.NET Core](#tab/aspnetcore)
5245

5346
> [!div class="checklist"]
5447
> * [ASP.NET Core Application](/aspnet/core/introduction-to-aspnet-core) using an officially supported version of [.NET](https://dotnet.microsoft.com/download/dotnet)
5548
5649
> [!Tip]
5750
> If you're migrating from the Application Insights Classic API, see our [migration documentation](./opentelemetry-dotnet-migrate.md).
5851
59-
### [.NET](#tab/net)
52+
#### [.NET](#tab/net)
6053

6154
> [!div class="checklist"]
6255
> * 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.
6356
57+
> [!NOTE]
58+
> .NET covers multiple scenarios, including classic ASP.NET, console apps, Windows Forms (WinForms), etc.
59+
6460
> [!Tip]
6561
> If you're migrating from the Application Insights Classic API, see our [migration documentation](./opentelemetry-dotnet-migrate.md).
6662
67-
### [Java](#tab/java)
63+
#### [Java](#tab/java)
6864

6965
> [!div class="checklist"]
7066
> * A Java application using Java 8+
7167
72-
### [Java native](#tab/java-native)
68+
#### [Java native](#tab/java-native)
7369

7470
> [!div class="checklist"]
7571
> * A Java application using GraalVM 17+
7672
77-
### [Node.js](#tab/nodejs)
78-
79-
> [!NOTE]
80-
> 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.
73+
#### [Node.js](#tab/nodejs)
8174

8275
> [!div class="checklist"]
8376
> * 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)
8477
78+
> [!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.
80+
8581
> [!Tip]
8682
> If you're migrating from the Application Insights Classic API, see our [migration documentation](./opentelemetry-nodejs-migrate.md).
8783
88-
### [Python](#tab/python)
84+
#### [Python](#tab/python)
8985

9086
> [!div class="checklist"]
9187
> * Python Application using Python 3.8+
@@ -172,8 +168,6 @@ pip install azure-monitor-opentelemetry
172168

173169
---
174170

175-
## Enable OpenTelemetry with Application Insights
176-
177171
### Modify your application
178172

179173
#### [ASP.NET Core](#tab/aspnetcore)

0 commit comments

Comments
 (0)