From 9a093bda84b88e1be60e3fff2354fc8210448e09 Mon Sep 17 00:00:00 2001 From: JamieDanielson Date: Wed, 19 Mar 2025 14:42:24 -0400 Subject: [PATCH 01/15] blog[js]: Add post announcing JS SDK 2.0 --- content/en/blog/2025/otel-js-sdk-2-0.md | 56 +++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 content/en/blog/2025/otel-js-sdk-2-0.md diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md new file mode 100644 index 000000000000..b7cf4da7c335 --- /dev/null +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -0,0 +1,56 @@ +--- +title: Announcing the OpenTelemetry JavaScript SDK 2.0 +linkTitle: OTel JS SDK 2.0 +date: 2025-02-21 +author: > + [Jamie Danielson](https://github.com/JamieDanielson) (Honeycomb) +sig: OpenTelemetry JS +--- + +Exciting news! [OpenTelemetry JavaScript](https://github.com/open-telemetry/opentelemetry-js) has released [SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases)! + +There is a [migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md) in the repo detailing breaking changes and steps for users to take to upgrade to the latest versions. + +## What is JS SDK 2.x? + +"JS SDK 2.x" encompasses new releases of the `@opentelemetry/*` JavaScript packages published from the [`opentelemetry-js` repository](https://github.com/open-telemetry/opentelemetry-js), except the API and semantic-conventions packages. The package versions for this new major will be `>=2.0.0` for the stable and `>=0.200.0` for the unstable packages. Details on the full list of packages can be found in the [migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#what-is-js-sdk-2x). + +## What has changed? + +### Summary + +- The **minimum supported Node.js has been raised to `^18.19.0 || >=20.6.0`**. This means that support for Node.js 14 and 16 has been dropped. +- The **minimum supported TypeScript version has been raised to 5.0.4**. +- The **compilation target for transpiled TypeScript has been raised to ES2022** (from ES2017). +- The **public interface has changed** + - for notes on migrating to 2.x / 0.200.x see [the upgrade guide](https://github.com/open-telemetry/opentelemetry-js/tree/main/doc/upgrade-to-2.x.md) + +### Details + +- [Node.js supported versions](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-nodejs-supported-versions) +- [TypeScript supported versions](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-typescript-supported-versions) +- [ES2022 compilation target](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-es2022-compilation-target) +- [Drop `window.OTEL_*` support in browsers](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-drop-windowotel_-support-in-browsers) +- [`@opentelemetry/resources` API changes](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetryresources-api-changes) +- [`@opentelemetry/core` API changes](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetrycore-api-changes) +- [Tracing SDK API changes](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-tracing-sdk-api-changes) +- [`@opentelemetry/sdk-metrics` API changes](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetrysdk-metrics-api-changes) +- [`@opentelemetry/resources` changes for *implementors* of Resource Detectors](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetryresources-changes-for-implementors-of-resource-detectors) +- [Other changes](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-other-changes) + +## Why was this done? + +Some of the details for why this 2.0 was done can be found [in this issue](https://github.com/open-telemetry/opentelemetry-js/issues/4083). We knew we would gain the greatest benefit by allowing breaking changes to improve things related to: + +- Optimization: removing classes and namespaces to allow better minification and tree-shaking. +- Better Tooling and Support: dropping old runtimes and tool versions to take advantage of enhanced ESM support and simplify documentation. +- Velocity: reducing code complexity and removing deprecated fields for faster feature and maintenance work. + +This also begins our goal of releasing a new major release every year. + +## How can I get involved? + +- Try out the [v2.0.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0) and [v0.200.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0) releases and provide feedback +- Review our [contributing guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/CONTRIBUTING.md) for details on contributing +- Attend our [SIG meetings](https://groups.google.com/a/opentelemetry.io/g/calendar-js) +- Collaborate on [Slack](https://cloud-native.slack.com/archives/C01NL1GRPQR) From 518de45ab3300b506882da323d9946d274405cd0 Mon Sep 17 00:00:00 2001 From: JamieDanielson Date: Wed, 19 Mar 2025 14:45:14 -0400 Subject: [PATCH 02/15] fixins --- content/en/blog/2025/otel-js-sdk-2-0.md | 56 ++++++++++++++++++------- 1 file changed, 42 insertions(+), 14 deletions(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index b7cf4da7c335..a3a1e8b5323a 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -7,23 +7,38 @@ author: > sig: OpenTelemetry JS --- -Exciting news! [OpenTelemetry JavaScript](https://github.com/open-telemetry/opentelemetry-js) has released [SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases)! +Exciting news! +[OpenTelemetry JavaScript](https://github.com/open-telemetry/opentelemetry-js) +has released +[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases)! -There is a [migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md) in the repo detailing breaking changes and steps for users to take to upgrade to the latest versions. +There is a +[migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md) +in the repository detailing breaking changes and steps for users to take to upgrade to +the latest versions. ## What is JS SDK 2.x? -"JS SDK 2.x" encompasses new releases of the `@opentelemetry/*` JavaScript packages published from the [`opentelemetry-js` repository](https://github.com/open-telemetry/opentelemetry-js), except the API and semantic-conventions packages. The package versions for this new major will be `>=2.0.0` for the stable and `>=0.200.0` for the unstable packages. Details on the full list of packages can be found in the [migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#what-is-js-sdk-2x). +"JS SDK 2.x" encompasses new releases of the `@opentelemetry/*` JavaScript +packages published from the +[`opentelemetry-js` repository](https://github.com/open-telemetry/opentelemetry-js), +except the API and semantic-conventions packages. The package versions for this +new major will be `>=2.0.0` for the stable and `>=0.200.0` for the unstable +packages. Details on the full list of packages can be found in the +[migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#what-is-js-sdk-2x). ## What has changed? ### Summary -- The **minimum supported Node.js has been raised to `^18.19.0 || >=20.6.0`**. This means that support for Node.js 14 and 16 has been dropped. +- The **minimum supported Node.js has been raised to `^18.19.0 || >=20.6.0`**. + This means that support for Node.js 14 and 16 has been dropped. - The **minimum supported TypeScript version has been raised to 5.0.4**. -- The **compilation target for transpiled TypeScript has been raised to ES2022** (from ES2017). +- The **compilation target for transpiled TypeScript has been raised to ES2022** + (from ES2017). - The **public interface has changed** - - for notes on migrating to 2.x / 0.200.x see [the upgrade guide](https://github.com/open-telemetry/opentelemetry-js/tree/main/doc/upgrade-to-2.x.md) + - for notes on migrating to 2.x / 0.200.x see + [the upgrade guide](https://github.com/open-telemetry/opentelemetry-js/tree/main/doc/upgrade-to-2.x.md) ### Details @@ -35,22 +50,35 @@ There is a [migration guide](https://github.com/open-telemetry/opentelemetry-js/ - [`@opentelemetry/core` API changes](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetrycore-api-changes) - [Tracing SDK API changes](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-tracing-sdk-api-changes) - [`@opentelemetry/sdk-metrics` API changes](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetrysdk-metrics-api-changes) -- [`@opentelemetry/resources` changes for *implementors* of Resource Detectors](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetryresources-changes-for-implementors-of-resource-detectors) +- [`@opentelemetry/resources` changes for _implementors_ of Resource Detectors](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetryresources-changes-for-implementors-of-resource-detectors) - [Other changes](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-other-changes) ## Why was this done? -Some of the details for why this 2.0 was done can be found [in this issue](https://github.com/open-telemetry/opentelemetry-js/issues/4083). We knew we would gain the greatest benefit by allowing breaking changes to improve things related to: +Some of the details for why this 2.0 was done can be found +[in this issue](https://github.com/open-telemetry/opentelemetry-js/issues/4083). +We knew we would gain the greatest benefit by allowing breaking changes to +improve things related to: -- Optimization: removing classes and namespaces to allow better minification and tree-shaking. -- Better Tooling and Support: dropping old runtimes and tool versions to take advantage of enhanced ESM support and simplify documentation. -- Velocity: reducing code complexity and removing deprecated fields for faster feature and maintenance work. +- Optimization: removing classes and namespaces to allow better minification and + tree-shaking. +- Better Tooling and Support: dropping old runtimes and tool versions to take + advantage of enhanced ESM support and simplify documentation. +- Velocity: reducing code complexity and removing deprecated fields for faster + feature and maintenance work. This also begins our goal of releasing a new major release every year. ## How can I get involved? -- Try out the [v2.0.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0) and [v0.200.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0) releases and provide feedback -- Review our [contributing guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/CONTRIBUTING.md) for details on contributing -- Attend our [SIG meetings](https://groups.google.com/a/opentelemetry.io/g/calendar-js) +- Try out the + [v2.0.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0) + and + [v0.200.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0) + releases and provide feedback +- Review our + [contributing guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/CONTRIBUTING.md) + for details on contributing +- Attend our + [SIG meetings](https://groups.google.com/a/opentelemetry.io/g/calendar-js) - Collaborate on [Slack](https://cloud-native.slack.com/archives/C01NL1GRPQR) From ab1f5ce274e5e55c2c7f9b55aca236bf71d7940c Mon Sep 17 00:00:00 2001 From: JamieDanielson Date: Wed, 19 Mar 2025 14:52:19 -0400 Subject: [PATCH 03/15] ignore me --- content/en/blog/2025/otel-js-sdk-2-0.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index a3a1e8b5323a..25f96fba3c8d 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -5,6 +5,7 @@ date: 2025-02-21 author: > [Jamie Danielson](https://github.com/JamieDanielson) (Honeycomb) sig: OpenTelemetry JS +cSpell:ignore: Danielson --- Exciting news! From a12b6c6360ddb4784552a3d683d14a504758f5be Mon Sep 17 00:00:00 2001 From: JamieDanielson Date: Wed, 19 Mar 2025 15:01:43 -0400 Subject: [PATCH 04/15] another fix it seems --- content/en/blog/2025/otel-js-sdk-2-0.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index 25f96fba3c8d..fc268ecef17f 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -15,8 +15,8 @@ has released There is a [migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md) -in the repository detailing breaking changes and steps for users to take to upgrade to -the latest versions. +in the repository detailing breaking changes and steps for users to take to +upgrade to the latest versions. ## What is JS SDK 2.x? From 3e4a719535971f808e6fb785f6925ee97ff0429f Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Thu, 20 Mar 2025 05:45:35 -0400 Subject: [PATCH 05/15] Set draft status --- content/en/blog/2025/otel-js-sdk-2-0.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index fc268ecef17f..ab85eccae25d 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -2,6 +2,7 @@ title: Announcing the OpenTelemetry JavaScript SDK 2.0 linkTitle: OTel JS SDK 2.0 date: 2025-02-21 +draft: true author: > [Jamie Danielson](https://github.com/JamieDanielson) (Honeycomb) sig: OpenTelemetry JS From 5c3ac2413eaaea8278392e5bcf80d675b7811b6d Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Thu, 20 Mar 2025 05:51:52 -0400 Subject: [PATCH 06/15] Fix date --- content/en/blog/2025/otel-js-sdk-2-0.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index ab85eccae25d..41937374afef 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -1,8 +1,7 @@ --- title: Announcing the OpenTelemetry JavaScript SDK 2.0 linkTitle: OTel JS SDK 2.0 -date: 2025-02-21 -draft: true +date: 2025-03-21 author: > [Jamie Danielson](https://github.com/JamieDanielson) (Honeycomb) sig: OpenTelemetry JS From dbce1c7320964a8072cfc36977b93bfa3b25385c Mon Sep 17 00:00:00 2001 From: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Date: Thu, 20 Mar 2025 10:16:18 +0000 Subject: [PATCH 07/15] Results from /fix:refcache --- static/refcache.json | 72 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) diff --git a/static/refcache.json b/static/refcache.json index b756d1321094..33588d9cff22 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -303,6 +303,10 @@ "StatusCode": 200, "LastSeen": "2025-02-02T10:59:14.907548-05:00" }, + "https://cloud-native.slack.com/archives/C01NL1GRPQR": { + "StatusCode": 200, + "LastSeen": "2025-03-20T10:14:45.444428061Z" + }, "https://cloud-native.slack.com/archives/C01NP3BV26R": { "StatusCode": 200, "LastSeen": "2024-12-18T05:52:49.606187-05:00" @@ -8683,10 +8687,62 @@ "StatusCode": 206, "LastSeen": "2025-01-16T11:37:42.172729-05:00" }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:13:41.886468706Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-drop-windowotel_-support-in-browsers": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:05.826276468Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-es2022-compilation-target": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:01.473606522Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-nodejs-supported-versions": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:13:54.514932507Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetrycore-api-changes": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:11.949279247Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetryresources-api-changes": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:09.243229009Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetryresources-changes-for-implementors-of-resource-detectors": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:23.176428015Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-opentelemetrysdk-metrics-api-changes": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:19.596391096Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-other-changes": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:25.673601051Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-tracing-sdk-api-changes": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:16.442116351Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-typescript-supported-versions": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:13:58.466804234Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#what-is-js-sdk-2x": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:13:44.541686095Z" + }, "https://github.com/open-telemetry/opentelemetry-js/discussions": { "StatusCode": 206, "LastSeen": "2025-01-13T12:10:34.858443-05:00" }, + "https://github.com/open-telemetry/opentelemetry-js/issues/4083": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:29.294035439Z" + }, "https://github.com/open-telemetry/opentelemetry-js/issues/4551": { "StatusCode": 206, "LastSeen": "2025-02-01T06:58:03.438269-05:00" @@ -8703,6 +8759,18 @@ "StatusCode": 206, "LastSeen": "2025-01-07T10:31:44.055855-05:00" }, + "https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:38.07150847Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:14:33.420944891Z" + }, + "https://github.com/open-telemetry/opentelemetry-js/tree/main/doc/upgrade-to-2.x.md": { + "StatusCode": 206, + "LastSeen": "2025-03-20T10:13:48.375113273Z" + }, "https://github.com/open-telemetry/opentelemetry-js/tree/main/examples/opentelemetry-web": { "StatusCode": 206, "LastSeen": "2025-01-16T11:37:42.389939-05:00" @@ -13475,6 +13543,10 @@ "StatusCode": 200, "LastSeen": "2025-01-17T12:58:38.699931Z" }, + "https://groups.google.com/a/opentelemetry.io/g/calendar-js": { + "StatusCode": 200, + "LastSeen": "2025-03-20T10:14:41.765468714Z" + }, "https://groups.google.com/a/opentelemetry.io/g/calendar-maintainer-meeting": { "StatusCode": 200, "LastSeen": "2025-02-01T07:12:03.939344-05:00" From e09db90d4b27e3d33df4c9ca6f35aa2dac55ca56 Mon Sep 17 00:00:00 2001 From: Jamie Danielson Date: Fri, 21 Mar 2025 15:18:07 -0400 Subject: [PATCH 08/15] Apply suggestions from code review Co-authored-by: Patrice Chalin --- content/en/blog/2025/otel-js-sdk-2-0.md | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index 41937374afef..d6343523f065 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -8,25 +8,30 @@ sig: OpenTelemetry JS cSpell:ignore: Danielson --- -Exciting news! -[OpenTelemetry JavaScript](https://github.com/open-telemetry/opentelemetry-js) +Exciting news: +[OpenTelemetry JavaScript](/docs/languages/js/) has released -[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases)! +[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)! -There is a -[migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md) -in the repository detailing breaking changes and steps for users to take to -upgrade to the latest versions. +{{% alert-md title="Migration guide" color="info" %}} + +For a detailed description of breaking changes, see the **migration guide** +[Upgrade to OpenTelemetry JS SDK 2.x][migration guide]. + +[migration guide]: + https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md + +{{% /alert-md %}} ## What is JS SDK 2.x? -"JS SDK 2.x" encompasses new releases of the `@opentelemetry/*` JavaScript +JS SDK 2.x encompasses new releases of the `@opentelemetry/*` JavaScript packages published from the [`opentelemetry-js` repository](https://github.com/open-telemetry/opentelemetry-js), except the API and semantic-conventions packages. The package versions for this new major will be `>=2.0.0` for the stable and `>=0.200.0` for the unstable packages. Details on the full list of packages can be found in the -[migration guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#what-is-js-sdk-2x). +[migration guide][]. ## What has changed? From bcc6a275b189cd0f5912328d513b90918b5b9459 Mon Sep 17 00:00:00 2001 From: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Date: Fri, 21 Mar 2025 19:28:28 +0000 Subject: [PATCH 09/15] Results from /fix:all --- content/en/blog/2025/otel-js-sdk-2-0.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index d6343523f065..b26cfffc3708 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -8,9 +8,7 @@ sig: OpenTelemetry JS cSpell:ignore: Danielson --- -Exciting news: -[OpenTelemetry JavaScript](/docs/languages/js/) -has released +Exciting news: [OpenTelemetry JavaScript](/docs/languages/js/) has released [SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)! {{% alert-md title="Migration guide" color="info" %}} @@ -30,8 +28,8 @@ packages published from the [`opentelemetry-js` repository](https://github.com/open-telemetry/opentelemetry-js), except the API and semantic-conventions packages. The package versions for this new major will be `>=2.0.0` for the stable and `>=0.200.0` for the unstable -packages. Details on the full list of packages can be found in the -[migration guide][]. +packages. Details on the full list of packages can be found in the [migration +guide][]. ## What has changed? From bcc87a216f6379a2bb7f1f0aeeee0bd7e77b35be Mon Sep 17 00:00:00 2001 From: Jamie Danielson Date: Wed, 26 Mar 2025 10:46:08 -0400 Subject: [PATCH 10/15] Apply suggestions from code review Co-authored-by: Patrice Chalin --- content/en/blog/2025/otel-js-sdk-2-0.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index b26cfffc3708..bdd2c81e4197 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -33,7 +33,7 @@ guide][]. ## What has changed? -### Summary +In summary: - The **minimum supported Node.js has been raised to `^18.19.0 || >=20.6.0`**. This means that support for Node.js 14 and 16 has been dropped. @@ -44,7 +44,7 @@ guide][]. - for notes on migrating to 2.x / 0.200.x see [the upgrade guide](https://github.com/open-telemetry/opentelemetry-js/tree/main/doc/upgrade-to-2.x.md) -### Details +Details: - [Node.js supported versions](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-nodejs-supported-versions) - [TypeScript supported versions](https://github.com/open-telemetry/opentelemetry-js/blob/main/doc/upgrade-to-2.x.md#-typescript-supported-versions) From 033f70c4fe7e09848dfdc23fc619c2b5a8bb6b9a Mon Sep 17 00:00:00 2001 From: Jamie Danielson Date: Wed, 26 Mar 2025 10:46:32 -0400 Subject: [PATCH 11/15] Update content/en/blog/2025/otel-js-sdk-2-0.md Co-authored-by: Patrice Chalin --- content/en/blog/2025/otel-js-sdk-2-0.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index bdd2c81e4197..04f81949eb8b 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -59,8 +59,6 @@ Details: ## Why was this done? -Some of the details for why this 2.0 was done can be found -[in this issue](https://github.com/open-telemetry/opentelemetry-js/issues/4083). We knew we would gain the greatest benefit by allowing breaking changes to improve things related to: @@ -73,6 +71,10 @@ improve things related to: This also begins our goal of releasing a new major release every year. +For a more detailed explanation of why 2.0, see issue [#4083]. + +[#4083]: https://github.com/open-telemetry/opentelemetry-js/issues/4083 + ## How can I get involved? - Try out the From ceb9e9d7f9dbb7e7f6098ebd38729496404ab438 Mon Sep 17 00:00:00 2001 From: Jamie Danielson Date: Wed, 26 Mar 2025 10:46:59 -0400 Subject: [PATCH 12/15] Apply suggestions from code review Co-authored-by: Patrice Chalin --- content/en/blog/2025/otel-js-sdk-2-0.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index 04f81949eb8b..037bf527c411 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -8,8 +8,10 @@ sig: OpenTelemetry JS cSpell:ignore: Danielson --- -Exciting news: [OpenTelemetry JavaScript](/docs/languages/js/) has released -[SDK 2.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0)! +Exciting news: [OpenTelemetry JavaScript](/docs/languages/js/) has released [SDK +2.0][v2.0.0]! + +[v2.0.0]: https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0 {{% alert-md title="Migration guide" color="info" %}} @@ -77,11 +79,10 @@ For a more detailed explanation of why 2.0, see issue [#4083]. ## How can I get involved? -- Try out the - [v2.0.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v2.0.0) - and - [v0.200.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0) - releases and provide feedback +[v0.200.0]: + https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0 + +- Try out the [v2.0.0] and [v0.200.0] releases and provide feedback - Review our [contributing guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/CONTRIBUTING.md) for details on contributing From ae6456b6be0ffd60da65d858544d7273147a5f6d Mon Sep 17 00:00:00 2001 From: Jamie Danielson Date: Wed, 26 Mar 2025 10:47:12 -0400 Subject: [PATCH 13/15] Update content/en/blog/2025/otel-js-sdk-2-0.md Co-authored-by: Chengzhong Wu --- content/en/blog/2025/otel-js-sdk-2-0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index 037bf527c411..a422d11adfc2 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -71,7 +71,7 @@ improve things related to: - Velocity: reducing code complexity and removing deprecated fields for faster feature and maintenance work. -This also begins our goal of releasing a new major release every year. +This also begins our goal of releasing a new SDK major release every year. For a more detailed explanation of why 2.0, see issue [#4083]. From e68298a0bb8b19b3ac370f40afb4a12012e5994b Mon Sep 17 00:00:00 2001 From: Jamie Danielson Date: Wed, 26 Mar 2025 10:47:58 -0400 Subject: [PATCH 14/15] Update content/en/blog/2025/otel-js-sdk-2-0.md --- content/en/blog/2025/otel-js-sdk-2-0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index a422d11adfc2..1798d922501d 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -1,7 +1,7 @@ --- title: Announcing the OpenTelemetry JavaScript SDK 2.0 linkTitle: OTel JS SDK 2.0 -date: 2025-03-21 +date: 2025-03-26 author: > [Jamie Danielson](https://github.com/JamieDanielson) (Honeycomb) sig: OpenTelemetry JS From cefac15db169129fefb5290ef17c549d7a47edd1 Mon Sep 17 00:00:00 2001 From: Tiffany Hrabusa <30397949+tiffany76@users.noreply.github.com> Date: Wed, 26 Mar 2025 14:04:12 -0700 Subject: [PATCH 15/15] Apply suggestions from code review --- content/en/blog/2025/otel-js-sdk-2-0.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/content/en/blog/2025/otel-js-sdk-2-0.md b/content/en/blog/2025/otel-js-sdk-2-0.md index 1798d922501d..6db6f8007647 100644 --- a/content/en/blog/2025/otel-js-sdk-2-0.md +++ b/content/en/blog/2025/otel-js-sdk-2-0.md @@ -15,7 +15,7 @@ Exciting news: [OpenTelemetry JavaScript](/docs/languages/js/) has released [SDK {{% alert-md title="Migration guide" color="info" %}} -For a detailed description of breaking changes, see the **migration guide** +For a detailed description of breaking changes, see the **migration guide**: [Upgrade to OpenTelemetry JS SDK 2.x][migration guide]. [migration guide]: @@ -42,9 +42,9 @@ In summary: - The **minimum supported TypeScript version has been raised to 5.0.4**. - The **compilation target for transpiled TypeScript has been raised to ES2022** (from ES2017). -- The **public interface has changed** - - for notes on migrating to 2.x / 0.200.x see - [the upgrade guide](https://github.com/open-telemetry/opentelemetry-js/tree/main/doc/upgrade-to-2.x.md) +- The **public interface has changed**. + - For notes on migrating to 2.x / 0.200.x, see + [the upgrade guide](https://github.com/open-telemetry/opentelemetry-js/tree/main/doc/upgrade-to-2.x.md). Details: @@ -66,7 +66,7 @@ improve things related to: - Optimization: removing classes and namespaces to allow better minification and tree-shaking. -- Better Tooling and Support: dropping old runtimes and tool versions to take +- Better tooling and support: dropping old runtimes and tool versions to take advantage of enhanced ESM support and simplify documentation. - Velocity: reducing code complexity and removing deprecated fields for faster feature and maintenance work. @@ -82,10 +82,10 @@ For a more detailed explanation of why 2.0, see issue [#4083]. [v0.200.0]: https://github.com/open-telemetry/opentelemetry-js/releases/tag/experimental%2Fv0.200.0 -- Try out the [v2.0.0] and [v0.200.0] releases and provide feedback +- Try out the [v2.0.0] and [v0.200.0] releases and provide feedback. - Review our [contributing guide](https://github.com/open-telemetry/opentelemetry-js/blob/main/CONTRIBUTING.md) - for details on contributing + for details on contributing. - Attend our - [SIG meetings](https://groups.google.com/a/opentelemetry.io/g/calendar-js) -- Collaborate on [Slack](https://cloud-native.slack.com/archives/C01NL1GRPQR) + [SIG meetings](https://groups.google.com/a/opentelemetry.io/g/calendar-js). +- Collaborate on [Slack](https://cloud-native.slack.com/archives/C01NL1GRPQR).