Java Library Release Notes
These release notes describe the new features, improvements, and fixed issues in the SolarWinds Observability Java Library.
Learn more
- For release notes for all SolarWinds agents, libraries, and collectors, see SolarWinds Observability Summary Release Notes.
- For currently known issues, see Known Issues.
- For information about requirements, see SolarWinds Observability System Requirements.
2023 updates

0.17.4 - October 23, 2023
Bundled OTel agent version
-
Java OTel agent version 1.29.0
New features and improvements
- Custom transaction names are allowed when the trace isn't sampled.
- The value for
resource.service.name
is resolved to the service name defined in the service key whenresource.service.name
is not set. resource.service.name
is exposed in the system properties, allowing it to be accessed by loggers and application code. The service name can be retrieved by reading the keyservice.name
, using system property read API and from loggers using the following:- Log4j2:
resource.service.name=${sys:service.name}
- Logback:
resource.service.name=${service.name}
- Log4j2:
- Introduces the
SW_APM_SQL_TAG_PREPARED
config to allow enabling trace context injection into prepared statements.SW_APM_SQL_TAG
is retained to enable the same for non-prepared statements.
Fixes
- The service key does not leak via process commands and arguments.
- IMDSv2 token request no longer has a bug.
0.17.2 - September 19, 2023
Bundled OTel agent version
-
Java OTel agent version 1.29.0
Fixes
- A Netty bug that was introduced in version 0.17.0 is resolved. This bug likely only affected Netty versions 4.1.80+.
0.17.1 - September 18, 2023
Bundled OTel agent version
-
Java OTel agent version 1.29.0
New features and improvements
- Automatically detect changes to configuration file without restarting application. Configuration properties that take effect after the configuration file is reloaded are listed below. Anything else will require application restart.
agent.configFileWatchPeriod
agent.logging
agent.tracingMode
agent.hostnameAlias
agent.transactionNameSchemes
agent.transactionSettings
agent.hostnameAlias
agent.sqlQueryMaxLength
transaction.prependDomain
agent.triggerTrace
0.17.0 - August 17, 2023
Bundled OTel agent version
-
Java OTel agent version 1.26.0
New features and improvements
- Metrics that are sent to the AppOptics or SolarWinds Observability collectors automatically conform to the formats necessary for the collector.
- Uses REST API when unable to retrieve
UAMSClientID
for the SolarWinds Observability Agent with default methods. - Transaction naming schemes are configurable
Fixes
- HostID Cloud VM retrieval is no longer instrumented.
0.16.2 - July 11, 2023
Bundled OTel agent version
-
Java OTel agent version 1.26.0
New features and improvements
- Gathers k8s metadata.
- Gathers the container ID in different runtimes.
- Adds
otel.scope.name
andotel.scope.version
to spans.
0.16.1 - June 2, 2023
Bundled OTel agent version
-
Java OTel agent version 1.26.0
New features and improvements
- Supports the collector setting in configuration file.
- Ignores empty or null transaction names.
0.16.0 - June 1, 2023
New features and improvements
PreparedStatement
instrumentation is removed.
Breaking changes
- SDK API now returns true when in No-op.
Fixes
- There is no longer a memory leak when there are retained references to statement objects.
Support changes
- Java OTel agent v1.26.0 is supported.
0.15.5 - May 22, 2023
New features and improvements
- AWS and Azure VM metadata is reported for Service and Host correlation.
Breaking changes
- Custom components' names use
solarwinds
instead ofappoptics
.
Fixes
- Non-deterministic requests do not timeout to the collector.
0.15.4 - April 26, 2023
Fixes
X-Trace-Options
is now added to the root span.- Attaching a custom sampler no longer hangs the application.
- Database passwords are no longer inadvertently exposed (fix is implemented with the upgrade to the OTel agent).
Support changes
- Java OTel agent v1.25.0 is supported.
0.15.3 - April 3, 2023
New features
- Filter transactions using
full url
andspan
layer.
Fixes
- Unending trace is fixed.
Support changes
- Bundled OTel agent is upgraded to 1.24.0.
0.15.2 - March 16, 2023
New features
sw.is_error
tag is added to theResponseTime
metric for both error and non-error transactions.
Fixes
- The
ResponseTime
metric is not over-reported.
0.15.1 - March 8, 2023
New features
- AppOptics TLS certficates are bundled with the library, allowing AppOptics endpoints to be used.
Support changes
- The Java Library is updated to use version 7.8.2 of the core library.
0.15.0 - February 23, 2023
New features
- The custom muzzle plugin is replaced with the official plugin.
__Init
message is updated to support Service Instance.
Fixes
- Trace context does not disappear after >11 requests.
- Trace context in JBDC uses the specification format.
- Reports error and info events correctly.
Support changes
- The Java Library is updated to version 1.22.0 of the OTel agent.
2022 updates

0.14.0 - October 27, 2022
New features
- Improved custom transaction name SDK.
- The SDK for the Java Library is published to Maven Central.
0.13.0 - September 22, 2022
New features
- Support for a new unified metrics format with an update to liboboe 10.6.1. See SolarWinds Observability 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.
- Fixed transaction name mismatch for Spring transactions.
- Fixed JDBC span issue for DMLs.
- Disable the library for unsupported JDK versions.
0.11.0 - August 9, 2022
New features
- The library now reports the SolarWinds Observability Agent's client ID so the relationship between the host entity and the services entity is detected and shown in SolarWinds Observability.
- Several configuration options are no longer required in the config file.
- Configuration options can now be set using system properties.
Fixes
- The key name of a key/value pair in the Init message sent to the collector is changed from
Java.AppOptics.Opentelemetry.Version
toJava.SolarWindsAPM.Version
.
0.10.0 - June 10, 2022
New features
- Java Library logs can be redirected to a file.
- The Java Library is now disabled if the Service key is not configured properly.
Fixes
- Fixed a
NullPointerException
when some settings are not available.
0.9.0 - May 25, 2022
New features
- The Java Library now uses the the SolarWinds APM collector's certificate instead of a built-in certificate. See SolarWinds Observability System Requirements for the SolarWinds Observability System Requirements.
- Added the library-ready checker API.
- Upgraded the Java Library to use OpenTelemetry v1.12.1.
- Updated to report data to the latest collector endpoint. See SolarWinds Observability System Requirements for the SolarWinds Observability System Requirements.
- Added a benchmark suite, based on the OpenTelemetry Java agent's benchmark-overhead suite.
- Reduced the artifact file size by half, from roughly 50 MB to 25 MB.
Fixes
- Internal clean-ups and dependency upgrades.
Legal notices
© 2023 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.