Node.js Library release notes
These release notes describe the new features, improvements, and fixed issues in the SolarWinds Observability Node.js Library.
Learn more
- For release notes for all SolarWinds agents, libraries, and collectors, see SolarWinds Observability SaaS summary release notes.
- For currently known issues, see Known issues.
- For information about requirements, see SolarWinds Observability SaaS System Requirements.
2024 updates
15.0.0 - December 3, 2024
AWS Lambda layer ARN
arn:aws:lambda:<region>:851060098468:layer:solarwinds-apm-js-15_0_0:1
Upstream OpenTelemetry versions
-
opentelemetry/api ^1.9.0
-
opentelemetry/core ~1.28.0
-
opentelemetry/instrumentation ~0.55.0
Breaking changes
-
@opentelemetry/api
dependency upgraded to^1.9.0
. -
Removed support for initialization via
--require
and--loader
flags. The only supported initialization method is now--import
. -
Removed support for Node.js 16. The supported versions are now 18 (
^18.19.0
), 20 (^20.8.0
), 22 and future LTS releases. -
waitUntilReady
changed to return a promise.
New features and improvements
- Added support for exporting logs.
- Added support for non-Linux platforms (Windows, macOS, etc).
14.1.0 - November 20, 2024
AWS Lambda layer ARN
arn:aws:lambda:<region>:851060098468:layer:solarwinds-apm-js-14_1_0:1
Upstream OpenTelemetry versions
-
opentelemetry/api ^1.3.0
-
opentelemetry/core ~1.28.0
New features and improvements
-
Support ESM handlers in AWS Lambda.
Fixes
-
Do not insert invalid trace context in prepared PostgreSQL statements.
-
Properly handle custom gauge metrics.
14.0.4 - November 4, 2024
AWS Lambda layer ARN
arn:aws:lambda:<region>:851060098468:layer:solarwinds-apm-js-14_0_4:1
Upstream OpenTelemetry versions
-
opentelemetry/api ^1.3.0
-
opentelemetry/core ~1.25.1
New features and improvements
-
Updated dependencies to get latest features and bug fixes.
Fixes
-
Some edge cases with ESM code no longer fail to instrument.
14.0.3 - July 22, 2024
AWS Lambda layer ARN
arn:aws:lambda:<region>:851060098468:layer:solarwinds-apm-js-14_0_3:1
Upstream OpenTelemetry versions
-
opentelemetry/api ^1.3.0
-
opentelemetry/core ~1.23.0
Fixes
- User-provided
@opentelemetry/api
is properly supported in Lambda.
14.0.2 - April 9, 2024
AWS Lambda layer ARN
arn:aws:lambda:<region>:851060098468:layer:solarwinds-apm-js-14_0_2:1
Upstream OpenTelemetry versions
-
opentelemetry/api ^1.3.0
-
opentelemetry/core ~1.23.0
Breaking changes
- This is a completely new version of the instrumentation library built upon OpenTelemetry.
- The library now requires the
@opentelemetry/api
package to be installed alongside it, with the version range^1.3.0
. - The public API surface of the library has been greatly reduced. The
@opentelemetry/api
package can instead be used for all custom instrumentation needs. - The configuration file name has changed and some options have been renamed or altered. See the configuration guide for details.
- The list of instrumented libraries has changed because the library now uses OpenTelemetry instrumentation. Custom instrumentations can now also be provided by the user. See the updated list of bundled instrumentations for details.
New features and improvements
- ESM is now supported by default, with the exception of Lambda. The recommended way to load the Node.js library is now to use the
--import
flag instead of the--require
flag. The--require
flag is deprecated and will be unsupported in a future release. - The new library is written in TypeScript and will always provide up to date and accurate type declarations.
- The new library supports all LTS Node.js versions up to one year after their End of Life. Support for older versions is not provided because they should not be used.
Common APM library updates: Update to liboboe 14.1.0
- Added exception handling in HttpAsyncClient class.
14.0.0 (prerelease) - February 8, 2024
This is a new version built using OpenTelemetry.
New features and improvements
- ESM is now supported by default, with the exception of Lambda. The recommended way to load the Node.js library is now to use the
--import
flag instead of the--require
flag, even though the latter is still supported. - The new library is written in TypeScript and will always provide up to date and accurate type declarations.
- The new library supports all LTS Node.js versions up to one year after their End of Life. Support for older versions is not provided because they should not be used.
Breaking changes
- The public API surface of the library has been greatly reduced. The
@opentelemetry/api
package can instead be used for all custom instrumentation needs. - The configuration file name has changed and some options have been renamed or altered. See the configuration guide for details.
- The list of instrumented libraries has changed because the library now uses OpenTelemetry instrumentation. Custom instrumentations can now also be provided by the user. See the updated list of bundled instrumentations for details.
Support changes
-
The library now requires the
@opentelemetry/api
package to be installed alongside it, with the version range^1.3.0
.
2023 updates
13.1.0 - August 24, 2023
Common APM library updates: Update to liboboe 13.0.0
- Sampling roll dice logic no longer results in a bug for edge cases.
k8s.pod.name
is sent only when the library is running in Kubernetes.
Support changes
- Bumped
semver
dependency version.
13.0.0 - May 9, 2022
New features and improvements
- Node.js 20 support is added.
Breaking changes
- Node.js 14 is no longer supported.
Common APM library updates: update to liboboe 12.2.0
- AWS and Azure VM metadata is reported for Service and Host correlation.
Support changes
- Node.js 20 support is added.
- Node.js 14 is no longer supported.
12.0.0 - March 13, 2022
New features
- The init message is updated to latest specification.
- Native bindings is updated to the latest version.
Breaking changes
- Support for RHEL/CentOS 7, Debian Stretch, and Ubuntu 16.04 is removed. The minimum
glibc
is now 2.27. - Partial, undocumented support for non-LTS Node.js releases is removed.
Support changes
- Support for RHEL/CentOS 7, Debian Stretch, and Ubuntu 16.04 is removed. The minimum
glibc
is now 2.27. - Support for arm64 (also known as armv8 or aarch64) is added.
2022 updates
11.2.0 - November 16, 2022
Changes:
- Provided TypeScript definitions for most of the API surface
- Updated to liboboe 11.0.0 to support using the AppOptics endpoint with default certificates.
11.1.0 - October 13, 2022
New features:
- Support for a new unified metrics format with an update to liboboe 10.6.1. See SolarWinds Observability SaaS October 2022 release notes for details of the unified metrics, why you should upgrade your library, and follow up actions that may be necessary after upgrading your library.
Legal notices
© 2024 SolarWinds Worldwide, LLC. All rights reserved.
This document may not be reproduced by any means nor modified, decompiled, disassembled, published or distributed, in whole or in part, or translated to any electronic medium or other means without the prior written consent of SolarWinds. All right, title, and interest in and to the software, services, and documentation are and shall remain the exclusive property of SolarWinds, its affiliates, and/or its respective licensors.
SOLARWINDS DISCLAIMS ALL WARRANTIES, CONDITIONS, OR OTHER TERMS, EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE, ON THE DOCUMENTATION, INCLUDING WITHOUT LIMITATION NONINFRINGEMENT, ACCURACY, COMPLETENESS, OR USEFULNESS OF ANY INFORMATION CONTAINED HEREIN. IN NO EVENT SHALL SOLARWINDS, ITS SUPPLIERS, NOR ITS LICENSORS BE LIABLE FOR ANY DAMAGES, WHETHER ARISING IN TORT, CONTRACT OR ANY OTHER LEGAL THEORY, EVEN IF SOLARWINDS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
The SolarWinds, SolarWinds & Design, Orion, and THWACK trademarks are the exclusive property of SolarWinds Worldwide, LLC or its affiliates, are registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other SolarWinds trademarks, service marks, and logos may be common law marks or are registered or pending registration. All other trademarks mentioned herein are used for identification purposes only and are trademarks of (and may be registered trademarks) of their respective companies.