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
<imgalign="right"src="https://user-images.githubusercontent.com/551402/208212084-1d0c07e2-4135-4c61-b2da-8f2fddbc66ed.png"alt="Bits the dog JavaScript"width="200px"/>
@@ -25,16 +24,16 @@ Most of the documentation for `dd-trace` is available on these webpages:
25
24
26
25
| Release Line | Latest Version | Node.js |[SSI](https://docs.datadoghq.com/tracing/trace_collection/automatic_instrumentation/single-step-apm/?tab=linuxhostorvm)|[K8s Injection](https://docs.datadoghq.com/tracing/trace_collection/library_injection_local/?tab=kubernetes)|Status |Initial Release | End of Life |
|[`v1`](https://github.com/DataDog/dd-trace-js/tree/v1.x)||`>= v12`| NO | NO |**End of Life**| 2021-07-13 | 2022-02-25 |
29
-
|[`v2`](https://github.com/DataDog/dd-trace-js/tree/v2.x)||`>= v12`| NO | NO |**End of Life**| 2022-01-28 | 2023-08-15 |
30
-
|[`v3`](https://github.com/DataDog/dd-trace-js/tree/v3.x)||`>= v14`| NO | YES |**End of Life**| 2022-08-15 | 2024-05-15 |
We currently maintain two release lines, namely `v5`, and `v4`.
37
-
Features and bug fixes that are merged are released to the `v5` line and, if appropriate, also `v4`.
36
+
We currently maintain one release line, namely `v5`.
38
37
39
38
For any new projects it is recommended to use the `v5` release line:
40
39
@@ -43,20 +42,22 @@ $ npm install dd-trace
43
42
$ yarn add dd-trace
44
43
```
45
44
46
-
However, existing projects that already use the `v4` release line, or projects that need to support EOL versions of Node.js, may continue to use these release lines.
45
+
Existing projects that need to use EOL versions of Node.js may continue to use these older release lines.
47
46
This is done by specifying the version when installing the package.
48
47
49
48
```sh
50
-
$ npm install dd-trace@4
51
-
$ yarn add dd-trace@4
49
+
$ npm install dd-trace@4# or whatever version you need
50
+
$ yarn add dd-trace@4# or whatever version you need
52
51
```
53
52
53
+
Note, however, that the end-of-life release lines are no longer maintained and will not receive updates.
54
+
54
55
Any backwards-breaking functionality that is introduced into the library will result in an increase of the major version of the library and therefore a new release line.
55
56
Such releases are kept to a minimum to reduce the pain of upgrading the library.
56
57
57
58
When a new release line is introduced the previous release line then enters maintenance mode where it will receive updates for the next year.
58
59
Once that year is up the release line enters End of Life and will not receive new updates.
59
-
The library also follows the Node.js LTS lifecycle wherein new release lines drop compatibility with Node.js versions that reach end of life (with the maintenance release line still receiving updates for a year).
60
+
The library also follows the Node.js LTS lifecycle wherein new release lines drop compatibility with Node.js versions that reach end-of-life (with the maintenance release line still receiving updates for a year).
60
61
61
62
For more information about library versioning and compatibility, see the [NodeJS Compatibility Requirements](https://docs.datadoghq.com/tracing/trace_collection/compatibility/nodejs/#releases) page.
0 commit comments