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
* Evaluate [Add, modify, and filter OpenTelemetry](opentelemetry-add-modify.md?tabs=nodejs).
32
32
33
-
1. Uninstall the `applicationinsights` dependency from your project.
33
+
2. Uninstall the `applicationinsights` dependency from your project.
34
34
35
-
```shell
36
-
npm uninstall applicationinsights
37
-
```
35
+
```shell
36
+
npm uninstall applicationinsights
37
+
```
38
38
39
-
1. Remove 2.X SDK implementation from your code.
39
+
3. Remove 2.X SDK implementation from your code.
40
40
41
-
Remove all Application Insights instrumentation from your code. You must delete any sections where the Application Insights client initializes, modifies, or calls.
41
+
Remove all Application Insights instrumentation from your code. You must delete any sections where the Application Insights client initializes, modifies, or calls.
42
42
43
-
1. Enable Application Insights with the Azure Monitor OpenTelemetry Distro.
43
+
4. Enable Application Insights with the Azure Monitor OpenTelemetry Distro.
44
44
45
-
Follow [getting started](opentelemetry-enable.md?tabs=nodejs) to onboard to the Azure Monitor OpenTelemetry Distro.
45
+
Follow [getting started](opentelemetry-enable.md?tabs=nodejs) to onboard to the Azure Monitor OpenTelemetry Distro.
46
46
47
-
### Changes and limitations of the Azure Monitor OpenTelemetry Distro
47
+
#### Changes and limitations of the Azure Monitor OpenTelemetry Distro
48
48
49
49
The APIs from the Application Insights 2.X SDK aren't available in the Azure Monitor OpenTelemetry Distro. You can access these APIs through a nonbreaking upgrade path in the Application Insights 3.X SDK.
50
50
51
51
## [Upgrade](#tab/upgrade)
52
52
53
53
1. Upgrade the `applicationinsights` package dependency.
54
54
55
-
```shell
56
-
npm update applicationinsights
57
-
```
55
+
```shell
56
+
npm update applicationinsights
57
+
```
58
58
59
-
1. Rebuild your application.
59
+
2. Rebuild your application.
60
60
61
-
1. Test your application.
61
+
3. Test your application.
62
62
63
-
To avoid using unsupported configuration options in the Application Insights 3.X SDK, see [Unsupported Properties](https://github.com/microsoft/ApplicationInsights-node.js/tree/beta?tab=readme-ov-file#applicationinsights-shim-unsupported-properties).
63
+
To avoid using unsupported configuration options in the Application Insights 3.X SDK, see [Unsupported Properties](https://github.com/microsoft/ApplicationInsights-node.js/tree/beta?tab=readme-ov-file#applicationinsights-shim-unsupported-properties).
64
64
65
-
If the SDK logs warnings about unsupported API usage after a major version bump, and you need the related functionality, continue using the Application Insights 2.X SDK.
65
+
If the SDK logs warnings about unsupported API usage after a major version bump, and you need the related functionality, continue using the Application Insights 2.X SDK.
66
66
67
67
---
68
68
69
-
## Changes and limitations
69
+
#### Changes and limitations
70
70
71
71
The following changes and limitations apply to both upgrade paths.
72
72
73
-
* Node < 14 support
73
+
##### Node < 14 support
74
74
75
75
OpenTelemetry JavaScript's monitoring solutions officially support only Node version 14+. Check the [OpenTelemetry supported runtimes](https://github.com/open-telemetry/opentelemetry-js#supported-runtimes) for the latest updates. Users on older versions like Node 8, previously supported by the ApplicationInsights SDK, can still use OpenTelemetry solutions but can experience unexpected or breaking behavior.
76
76
77
-
* Configuration options
77
+
##### Configuration options
78
78
79
79
The ApplicationInsights SDK version 2.X offers configuration options that aren't available in the Azure Monitor OpenTelemetry Distro or in the major version upgrade to Application Insights 3.X SDK. To find these changes, along with the options we still support, see [SDK configuration documentation](https://github.com/microsoft/ApplicationInsights-node.js/tree/beta?tab=readme-ov-file#applicationinsights-shim-unsupported-properties).
80
80
81
-
* Extended metrics
81
+
##### Extended metrics
82
82
83
83
Extended metrics are supported in the Application Insights 2.X SDK; however, support for these metrics ends in both version 3.X of the ApplicationInsights SDK and the Azure Monitor OpenTelemetry Distro.
84
84
85
-
* Telemetry Processors
85
+
##### Telemetry Processors
86
86
87
87
While the Azure Monitor OpenTelemetry Distro and Application Insights 3.X SDK don't support TelemetryProcessors, they do allow you to pass span and log record processors. For more information on how, see [Azure Monitor OpenTelemetry Distro project](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/monitor/monitor-opentelemetry#modify-telemetry).
88
88
@@ -105,7 +105,6 @@ function addCustomProperty(envelope: EnvelopeTelemetry) {
105
105
106
106
This example shows how to modify an Azure Monitor OpenTelemetry Distro implementation to pass a SpanProcessor to the configuration of the distro.
107
107
108
-
109
108
```typescript
110
109
import { Context, Span} from "@opentelemetry/api";
111
110
import { ReadableSpan, SpanProcessor } from "@opentelemetry/sdk-trace-base";
0 commit comments