Documentation forAppOptics

.NET Agent (legacy) Release Notes

AppOptics agents are no longer receiving updates. The new SolarWinds Observability libraries are regularly updated with new features and improvements. If you are still relying on the AppOptics agents and your components are supported by the new libraries, consider migrating to SolarWinds Observability.

SolarWinds Observability Libraries are not compatible with AppOptics agents. Do not use a mix of SolarWinds Observability Libraries and AppOptics agents to instrument applications that are part of a distributed trace.

4.3.3 - January 23, 2023

Return to top

Improvement

  • Updated Code Signing certificate

Fix

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

4.3.2 - May 26, 2022

Return to top

New Features

  • MySql Instrumentation
  • .NET Framework - IIS Request Queue Length reporting

4.3.1 - January 19, 2022

Return to top

New Features

  • .NET 6.0 support
  • Added new configuration for controlling MVC Instrumentation
  • SDK Method EndTrace added optional parameter: hasError
  • Added new SDK Method EndTraceHttpService

4.3.0 - October 20, 2021

Return to top

New Features

  • AppOptics.Agent.Api NuGet package, which contains the SDK assemblies.
  • General availability release for Azure App Service support: .NET Core and Framework

Breaking changes

  • Removed SDK assemblies (AppOptics.Instrumentation.dll and AppOptics.Instrumentation.Core.dll) from the automatic instrumentation installers DotNetAgent.exe and dotnet-agent-package.tgz.
  • The AppOptics.Instrumentation NuGet package is deprecated and new versions will no longer be released, customers should use assemblies from the AppOptics.Agent.Api or AppOptics.Agent packages instead.

4.2.0 - June 1, 2021

Return to top

New Features

  • .NET Core Agent for Linux official (non-beta) release
  • .NET Core Agent Beta Release (-gamma) for Azure App Service
  • Added a configuration setting to enable or disable automatic IIS instrumentation
  • Added a log level setting for the connection between the .NET agent and the AppOptics collector
  • Updated the location of the diagnostic tool

Fixes

  • Mask service key in the installer log files
  • Improved retry support for connecting to the AppOptics collector
  • Fix for the profiler stopping and missing IIS exit event

Breaking changes

  • .NET Core Runtimes 2.0 and 3.0 are no longer supported

4.1.1 - February 8, 2021

Return to top

  • .NET Core Agent for Windows Beta Release
  • Updated with a new code-signing certificate
  • SDK start trace method does not automatically mark span as async

4.1.0 - December 9, 2020

Return to top

  • .NET Core Agent for Linux Beta Release
  • .NET Core SDK compatibility with Agent for Linux

4.0.5 - November 20, 2020

Return to top

  • Fixed assembly loading issue.
  • Fixed inserting empty T-TRACE headers.
  • Check user access rights before initializing the logging subsystem in the profiler.

4.0.4 - October 13, 2020

Return to top

  • Code profiling improvements and fixes.

4.0.3 - August 27, 2020

Return to top

  • Added MaximumQueryLength configuration and increased default maximum query length to 128000 characters.
  • Fixed broken traces when a SOAP request GetRequestStream method fails.
  • Fixed displaying invalid service key message during installation.
  • Improved log messages when COR_PROFILER environment variables aren’t set for IIS applications.

4.0.2 - May 26, 2020

Return to top

  • Added AppOpticsHttpModule configuration
  • Updates and fixes for IIS site configuration

4.0.1 - Apr 14, 2020

Return to top

  • Code profiling improvements and fixes
  • Fix for .NET Core SDK transaction filtering

4.0.0 - Mar 9, 2020

Return to top

  • Added support for proxying agent outbound traffic (gRPC)

3.10.0 - Mar 2, 2020

Return to top

  • Improvement - IIS sites using an integrated mode application pool do not require the AppOptics.Instrumentation HttpModule
  • .NET Core SDK - Fix for referenced packages when using .NET Core 2.0 - 2.2

3.9.7 - Feb 3, 2020

Return to top

  • Fix for profiling of console applications

3.9.6 - Jan 6, 2020

Return to top

  • .NET Core SDK - Added support for .NET Core 3.0 and 3.1
  • Added configuration option to disable backtrace reporting

3.9.5 - Dec 9, 2019

Return to top

  • Improved code profiling feature
  • Fix for setting IIS site configured service name on code profiles
  • Fix for reporting of host MAC and IP addresses

3.9.4 - Nov 20, 2019

Return to top

  • Fix for instrumentation of console applications

3.9.3 - Oct 22, 2019

Return to top

  • .NET Core SDK - Added support for Azure App Service

3.9.2 - Sep 19, 2019

Return to top

  • Fix in .NET Agent installer to allow . in service names

3.9.1 - Sep 17, 2019

Return to top

  • Fix for IIS Hosted WCF applications (.NET Framework 3.5 and lower)
  • Fix for Classic Mode IIS Hosted WCF applications (.NET Framework 4.0 and lower)

3.9.0 - Sep 9, 2019

Return to top

  • Added Trigger Trace feature
  • Add Async flag to spans that are created when a System.Threading.Tasks.Task is running
  • Added installer check to ensure Windows OS version is supported
  • Added configuration option to disable or change the timeout of EC2 instance check
  • Fix to continue .NET Core traces that were started in IIS by the .NET Framework AppOptics Agent
  • Internal upgrades to Visual Studio 2019 and HDR histograms library version 0.9.10

3.8.0 - Jun 18, 2019

Return to top

  • Added trace ID injection into log messages
  • Enhancement: Improve the way we read environment and configuration variables

3.7.3 - May 27, 2019

Return to top

  • Fix for SetTransactionName when used with IIS hosted WCF services

3.7.2 - May 15, 2019

Return to top

  • .NET Core SDK - Added support for new API token format

3.7.1 - May 13, 2019

Return to top

  • Added support for new API token format

3.7.0 - May 2, 2019

Return to top

  • Introduced Code Profiling

3.6.0 - Apr 15, 2019

Return to top

  • Transaction filtering to disable/enable tracing and metrics on particular request URLs

3.5.3 - Mar 11, 2019

Return to top

  • .NET Core SDK Release
  • Include support for Linux platforms

3.5.3 - Feb 22, 2019

Return to top

  • Update Inno Setup to 5.5.9(a) version

3.5.2 - Jan 28, 2019

Return to top

  • Update digital signature certificate

3.5.1 - Dec 17, 2018

Return to top

  • Added service name validation and automatic transformation of invalid service names
  • Updated log files created by the installer to be combined into one log file: AppOptics.NETAgent.Install.<dd-mm-yyyy>.log
  • Added instrumentation for WCF methods that use a one-way contract

3.5.0 - Oct 30, 2018

Return to top

  • Include support on Linux platforms for .NET Core SDK Beta Release

3.4.1 - Oct 2, 2018

Return to top

  • Fixed setting of configuration settings for child processes created by IIS application pools
  • Improved the filtering of re-entry calls for instrumented methods

3.4.0 - Sep 19, 2018

Return to top

  • Added AppOptics configuration to disable or enable AppOptics .NET APM for the server, application pools or non-IIS applications.
  • Expanded metrics reporting to traces started by SDK
  • Added IsAgentAvailable and WaitUntilAgentReady SDK methods to check for agent readiness

3.3.3 - Aug 28, 2018

Return to top

  • Add WCF Service non-IIS instrumentation for WCF binding types: BasicHttpBinding and WSHttpBinding
  • Fixed retrieval of MAC addresses
  • Improved Network Interface detection
  • Improved communication with AppOptics server (better host detection and optimized sending of data)
  • Optimization to speed up retrieval of initial settings
  • Sign all components in the .NET Agent installer
  • Add reporting of container ID for Windows Containers

3.3.2 - Jul 24, 2018

Return to top

  • .NET Core SDK GA Release
  • Added SetTransactionName method to .NET Core SDK
  • Added configuration option to prepend domain name to transaction name for .NET Core SDK middleware

3.3.1 - Jul 17, 2018

Return to top

  • Upgraded OpenSSL version
  • Fix for installer diagnostic check on new installations

3.3.0 - Jul 11, 2018

Return to top

  • Added SetTransactionName method to .NET custom SDK
  • Fix to only tag request metrics as errored when the http status code is 5xx

3.2.0 - Jun 18, 2018

Return to top

  • Added configuration option to prepend domain name to transaction name
  • Added diagnostic tool for testing connection to AppOptics collector
  • Fix for IIS site configuration of WCF sites hosted in IIS
  • Fix for reporting of metric errors for WCF requests through IIS

3.1.1 - May 29, 2018

Return to top

  • Added support to configure service keys for IIS sites
  • For .NET Framework 4.6 and higher added support for context propagation when using the TPL (task parallel library) or the async-await keywords

3.1.0 - Apr 3, 2018

Return to top

  • .NET Core SDK Beta Release

3.0.4 - Feb 26, 2018

Return to top

  • Fix: Avoid segfault related to concurrency in C-Library

3.0.3 - Jan 16, 2018

Return to top

  • Application pool service key configuration
  • Improved detection of network interface devices

3.0.2 - Dec 20, 2017

Return to top

  • WCF Async Context Updates

3.0.1 - Nov 6, 2017

Return to top

  • Add hostname alias config
  • Add instrumentation for Oracle XML stored procedures

3.0.0 - Oct 6, 2017

Return to top

  • Initial AppOptics .NET Agent Release