Documentation forSolarWinds Observability SaaS

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

2025 updates

15.4.0 - March 18, 2025

Return to top

AWS Lambda layer ARN 

arn:aws:lambda:<region>:851060098468:layer:solarwinds-apm-js-15_4_0:1

Upstream OpenTelemetry versions

  • opentelemetry/api ^1.9.0

  • opentelemetry/core ~1.30.0

  • opentelemetry/instrumentation ~0.57.0

New features and improvements

  • Added generic resource attributes detection for Kubernetes.

Fixes

  • Collect all metrics with the proper aggregation temporality.
  • Cap metrics cardinality.

15.2.0 - February 21, 2025

Return to top

AWS Lambda layer ARN 

arn:aws:lambda:<region>:851060098468:layer:solarwinds-apm-js-15_2_0:1

Upstream OpenTelemetry versions

  • opentelemetry/api ^1.9.0

  • opentelemetry/core ~1.30.0

  • opentelemetry/instrumentation ~0.57.0

New features and improvements

  • Added resource attribute detections for EKS and GCP.

15.1.0 - January 7, 2025

Return to top

AWS Lambda layer ARN 

arn:aws:lambda:<region>:851060098468:layer:solarwinds-apm-js-15_1_0:1

Upstream OpenTelemetry versions

  • opentelemetry/api ^1.9.0

  • opentelemetry/core ~1.30.0

  • opentelemetry/instrumentation ~0.57.0

New features and improvements

  • Added new SW_APM_LOG_STDERR and SW_APM_LOG_NULL flags to redirect logging output.

2024 updates

15.0.0 - December 3, 2024

Return to top

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

Return to top

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

Return to top

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

Return to top

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

Return to top

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

Return to top

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

Return to top

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

Return to top

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

Return to top

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

Return to top

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

Return to top

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.

11.0.0 prerelease - April 29, 2022

Return to top

  • Initial SolarWinds Observability Node.js library release.

Legal notices

Return to top

© 2025 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.