Documentation forSolarWinds Observability SaaS

.NET Library release notes

These release notes describe the new features, improvements, and fixed issues in the SolarWinds Observability .NET Library.

Learn more

2024 updates

5.3.7 - October 15, 2024

Return to top

Fixes

  • The LogLevel option no longer needs to be set to enable the instrumentation of .NET Framework Applications.

5.3.6 - September 23, 2024

Return to top

New features and improvements

  • Enhanced error detection in diagnostic tools.
  • New script to confirm the AppOptics .NET Agent was uninstalled successfully.

5.3.5 - March 18, 2024

Return to top

New features and improvements

  • Changes were made to reduce confusion about database configuration options. The InsertSqlTagDatabases option has been added, and the description of the InsertSqlTag option is updated.

Fixes

  • Fixed issue with detecting .NET Core Runtime version.
  • Fixed issue with auto-instrumentation of MySql.Data client library.

5.3.4 - January 29, 2024

Return to top

New features and improvements

  • The Code Signing certificate is updated.

Fixes

  • Fixed issue in the Common APM library with locks used when reading sample rate settings from the APM collector.

5.3.3 - January 2, 2024

Return to top

New features and improvements

  • Includes an environment variable for configuring the LogLevel: SW_APM_LOG_LEVEL
  • Includes a configuration setting to set the location of log files
  • Includes a configuration setting to set the LogType
  • Includes a configuration to enable or disable HttpClient instrumentation

Common APM library updates: Update to liboboe 14.0.0

Fixes

  • HttpClient instrumentation is disabled by default for .NET Framework applications because it can cause an operation runtime exception. A configuration setting has been added to enable HttpClient instrumentation for .NET Framework applications if it’s required.
  • Fixed an issue where ASP.NET Core Instrumentation was not set up during application startup.

2023 updates

5.3.2 - September 6, 2023

Return to top

New features and improvements

  • IIS must be stopped before proceeding with install when IIS instrumentation component(s) are selected.
  • Adds serviceName attribute to the application, applicationPool, and iisSite xml elements in the solarwinds_apm.config file.
  • Gather k8s metadata to correlate the service with Kubernetes entities.

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.

Fixes

  • Add establish connection check to the Windows .NET APM installer and diagnostic tool.
  • Decrease time taken during process startup for setting up automatic instrumentation.

5.3.1 - May 29, 2023

Return to top

New features and improvements

  • Collector endpoint is added to SolarWinds Observability APM library logs and improvements to log messages are added during library startup.
  • Windows installer always sets ServiceKey and APMCollector in solarwinds_apm.config, even if an error occurs during library installation.

Fixes

  • Fixed issue that occurred when upgrading from AppOptics .NET Agent to SolarWinds Observability .NET APM Library.
  • Added exception catching to methods in the CLR Profiler API.
  • Fixed issue with IIS Re-entrant detection that would create an extra IIS entry event.
  • Fixed issue with diagnostic tool registry log messages.

5.3.0 - May 2, 2023

Return to top

New features and improvements

  • The .NET APM Library can be run in a Windows container run in Azure App Services.

Fixes

  • The instrumenter for HttpClientHandler.SendAsync is found in all known situations.

Common APM library updates: update to liboboe 12.2.0

  • AWS and Azure VM metadata is reported for Service and Host correlation.

Support changes

  • arm64 is supported for Linux.

5.2.2 - March 2, 2023

Return to top

Improvements

  • The shutdown time for the .NET Library is decreased.

Fixes

  • Read and writing locks used for internal collector settings is fixed.

5.2.1 - February 9, 2023

Return to top

Improvements

  • Code Signing certificate is updated.
  • .NET 7.0 support.
  • Report service instance ID and Init message updates.

Fixes

  • Fixed issue with ASP.NET instrumentation that could cause the IIS span to not be completed.

2022 updates

5.2.0 - December 7, 2022

Return to top

New features:

  • Support for Alpine x64

5.1.1 - November 7, 2022

Return to top

New features:

  • New configuration option InsertSqlTag added to allow trace context in queries. See InsertSqlTag in Configure the .NET Library.
  • Updated to liboboe 11.0.0 to support using the AppOptics endpoint with default certificates.

Improvements:

  • Updates were made to .NET 6+ async database instrumentation.

5.1.0 - October 17, 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.
  • Added configuration setting ApmCollector to the solarwinds_apm.config file, which can be used to set the SolarWinds APM collector endpoint.
  • Updated the Windows installer to set the ApmCollector configuration value.
  • The diagnostic tool was improved to include better messaging during the installation.
  • The .NET SDK updated to support W3C Trace Context headers. See Migrate .NET from AppOptics to SolarWinds Observability SaaS, SDK Updates for details of the SDK changes.

5.0.1 - July 18, 2022

Return to top

New features:

  • 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 SaaS.
  • Formatting of library logs and logging of configuration settings is improved.
  • Diagnostic tool updates: /Timeout option is now available to configure, environment variables are reported, and registry settings on Windows are reported.

5.0.0 - May 3, 2022

Return to top

  • Initial SolarWinds Observability .NET Library release.

Legal notices

Return to top

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