NET Release Notes

Recent .NET agent release notes are listed below. If you would like a release that has been used extensively with a list of known issues, see Established releases (.NET) for download and version information.

Monday, July 22, 2019 - 13:00 Download

Download URLs

Download the appropriate release for your New Relic .NET agent:

https://download.newrelic.com/dot_net_agent/latest_release

New Features

  • This release adds Transaction event attributes that provide context between your Kubernetes cluster and services. For details on the benefits see this blog post.
  • The NewRelic.Agent NuGet package now includes the x86 (32-bit) profiler for Windows. To monitor 32-bit Windows applications using this NuGet package the COR_PROFILER_PATH (.NET Framework) or the CORECLR_PROFILER_PATH (.NET Core) environment variable needs to be set to the path the of the 32-bit profiler DLL (NewRelic.Profiler.x86.dll).
  • For .NET Core applications hosted in Azure App Services, the New Relic Azure Site Extension can now be used to install the agent. This was previously only available for .NET Framework applications. Follow these procedures to install.

Fixes

  • Fixed an issue where the NRQL Extrapolate clause in Insights did not work properly for Transaction Events.
  • Fixed an issue where cross application tracing could cause a metric grouping issue (MGI) for web requests that result in a 300 or higher response status code. Transaction names may now be rolled up by status code.
  • Fixed an issue where browser script injection in ASP.NET applications could cause a metric grouping issue (MGI) for web requests that result in a 30x redirect status code. Transaction names may now be rolled up by status code.

Upgrading

Tuesday, June 11, 2019 - 15:30 Download

Fixes

  • CORS (Cross-Origin Resource Sharing) “pre-flight” requests with the HTTP OPTIONS method were causing extraneous metrics to be generated for ASP.NET Core applications using the CORS middleware. These requests will now be ignored by the agent.
  • Fixes a problem where WCF instrumentation shuts down when WebHttpBinding is used and CAT is enabled.
  • Fixes a problem where an async WCF client call may prevent further data from being captured in a transaction.

New Features

  • Adds database instrumentation for Microsoft.Data.SqlClient.

Upgrading

Monday, April 22, 2019 - 14:30

Fixes

  • Fixes a problem with parsing method signatures that do not align with ECMA-335 that could cause an application to crash.
  • Fixes a problem where third-party libraries that perform assembly-scanning using reflection may encounter TypeLoadExceptions.
  • Fixes a problem where the agent may incorrectly report Response Time when custom instrumentation is applied to methods that are called from within an instrumented framework (such as ASP.Net).
  • Resolves security issue with how SQL Server handles escaping which could lead to a failure to correctly obfuscate SQL statements. See Security Bulletin NR19-03.
  • Resolves issue with not rolling up 30x HTTP response codes which resulted in MGI issues.

New Features

  • Adds improved WCF support
    • WCF client task asynchronous programming model (following the task asynchronous pattern) calls are tracked as external calls.

Upgrading

Monday, April 22, 2019 - 14:30 Download

Download URLs

Download the appropriate release for your New Relic .NET agent:

This is a security-only release for the 6.x agents that support legacy frameworks (.NET version 4.5 and lower). If you are on .NET version 4.5 and higher or .NET Core, the 7.x or later versions of the agent should be used.

Fixes

  • Resolved security issue with how SQL Server handles escaping which could lead to a failure to correctly obfuscate SQL statements. See Security Bulletin NR19-03.

Upgrading

Monday, March 18, 2019 - 16:30

Fixes

  • Fixed issue where transactions may not get reported when custom instrumentation is applied to async methods with a void return type. Instrumenting async void methods is generally not recommended and may result in unexpected segment timing as well as the disruption of downstream instrumentation. Please review async limitations online help for alternative approaches.

New Features

  • [.NET Core] Adds support for .NET Core 3.0 preview 2
  • [.NET Core] Adds support for ASP.NET Core 3.0 preview 2
  • [.NET Framework] Adds support for .NET Framework 4.8 Early Access build 3694
  • Adds official support for Postgres/Npgsql versions 4.0.
    • Supports Sync and Async methods, on .Net Framework and .Net Core running in Windows and Linux.
    • Eliminates duplicate and extraneous datastore metrics and trace segments associated with opening connections to databases (as seen in prior agent versions).
    • Npgsql versions older than 4.0 may also be instrumented, but duplicate and/or missing metrics are possible.
  • Adds improved WCF support
    • WCF client calls are tracked as external calls
    • WCF client synchronous and asynchronous programming model (following the begin/end asynchronous pattern) calls are tracked.

Upgrading

Tuesday, February 12, 2019 - 14:00

Fixes

  • [Framework] Improved support for async workloads in self-hosted OWIN applications.
  • [Framework] Status code only errors are now noticed in self-hosted OWIN applications.

New Features

  • [Framework] Adds support for the following in .Net Framework self-hosted OWIN apps:
    • Microsoft OWIN version 4
    • Distributed tracing
    • Cross application tracing
    • Request parameters capture
    • Request URI capture
    • Introduces single metric creation for HTTP status codes 400 and greater
    • Exception capture from OWIN middleware components

Upgrading

Wednesday, January 9, 2019 - 14:00

Fixes

  • Fixed an issue where the response time of a web transaction could be misreported when making asynchronous external calls whose duration extended beyond the time the web transaction response ended.
  • Fixed an issue when using OpenRasta instrumentation where the full URL could be captured on instrumented requests. This may have resulted in query strings being collected which can contain sensitive information. See security bulletin NR19-01.
  • Fixes an issue with auto-instrumenting RestSharp and Couchbase driver calls involving non-public collection types.

Upgrading

Monday, December 17, 2018 - 14:30

Fixes

  • Fixes an issue where stack traces for custom errors outside a transaction were not visible in the Error Analytics UI page.
  • Fixes an issue with auto-instrumenting MongoDB driver calls involving non-public collection types.
  • Fixes an issue with reporting the same transaction multiple times.

New Features

  • Improved performance when serializing metrics prior to sending to New Relic.
  • Improved SQL-related database instrumentation performance.

Upgrading

Thursday, November 29, 2018 - 16:00

Fixes

  • Fixes a bug in SQL-related database instrumentation that potentially causes a CPU spike. This bug appeared in the agent version 8.9.130.

New Features

  • [.NET Core] Adds support for .NET Core 2.2.
  • Adds support for ASP.NET Core 2.2.
  • Improves the performance of cross application tracing.

Upgrading

Thursday, November 15, 2018 - 10:00

Fixes

Added auto instrumentation to prevent associating Serilog PeriodicBatchingSink activity with an application’s transactions.

New Features

Added API support for manually creating and accepting distributed tracing payloads.

Upgrading

Thursday, October 18, 2018 - 13:30

Fixes

  • Fixes potential memory leak when Distributed Tracing is enabled.
  • Fixes an issue where a NullReferenceException is logged for certain data stores (MongoDB and Couchbase) when distributed tracing is enabled.
  • Fixes an issue where a transaction start time is incorrect when an error has been reported.

Other Information

  • After November 7th, 2018 the Core_20 directory will be removed from the download site. This folder currently contains an outdated version of the .Net Core agent. The most up-to-date version of the .NET Core agent can be found in inlatest_release directory.

Upgrading

Wednesday, October 3, 2018 - 13:30

New Features

Fixes

  • The profiler now honors the log level configuration setting that is set in the app-local newrelic.config file.

Other Information

  • After November 7th, 2018 the Core_20 directory will be removed from the download site. This folder currently contains an outdated version of the .Net Core agent. The most up-to-date version of the .NET Core agent can be found in inlatest_release directory.

Upgrading

Tuesday, August 28, 2018 - 10:00

Download URLs

Download the appropriate release for your New Relic .NET agent:

https://download.newrelic.com/dot_net_agent/latest_release

New Features

  • Distributed tracing lets you see the path that a request takes as it travels through your distributed system. By showing the distributed activity through a unified view, you can troubleshoot and understand a complex system better than ever before. Distributed tracing is available with an APM Pro or equivalent subscription. To see a complete distributed trace, you need to enable the feature on a set of neighboring services. Enabling distributed tracing changes the behavior of some New Relic features, so carefully consult the transition guide before you enable this feature.
  • To enable distributed tracing, see .NET Agent configuration.

Upgrading

Thursday, August 16, 2018 - 15:00

New Features

  • Adds support for capturing request.uri attribute for WCF services when available.
  • [.NET Core] SQL query parameter values can now be captured on Slow SQL Traces on Linux.

Fixes

  • Fixes an issue where errors set to be ignored through configuration were not being ignored.
  • Fixes an issue where running the thread profiler can cause an application to terminate.
  • Fixes an issue where transaction events could be dropped.
  • [.NET Core] Fixes an issue for .NET Core applications running on Linux when serializing slow SQL trace and explain plan data for transmission to New Relic. Previously, the following exception would be seen in the agent logs: NewRelic ERROR: System.PlatformNotSupportedException: Operation is not supported on this platform.

Notes

  • We will be removing the core_20 directory from the download site the week of September 3rd, 2018 as it contains a deprecated version of the .Net Core agent. Please be sure to update any of your scripts that reference this location accordingly.
    • All downloads for the current version of the agent can be found in the latest_release directory on the download site.
    • Historical versions can be found in the previous_releases directory.

Upgrading

Monday, July 30, 2018 - 11:30

Download URLs

Download the appropriate release for your New Relic .NET agent:

https://download.newrelic.com/dot_net_agent/previous_releases

New Features

  • SQL query parameter values can now be captured on Slow SQL Traces. This feature can be enabled with the new configuration option datastoreTracer.queryParameters. The transactionTracer.record_sql configuration option must also be set to raw. See documentation here. This feature should be used with caution as it can lead to the capture of sensitive data. High Security Mode prevents the use of this feature. Windows support only. Linux support coming soon.
  • [.NET Framework] Adds support for tracking async transactions when .ConfigureAwait(false) is used from async controller actions in ASP.NET MVC applications.
  • [.NET Core] Adds support for .NET Core 2.1. Support for .NET Core 2.1 requires at least CLR version 2.1.3 and tiered compilation must not be enabled.

Fixes

  • [.NET Core] Fixes issue where status code based errors would be reported instead of the actual noticed Exception. This most commonly occurred with errors noticed in the ExceptionHandlerMiddleware (app.UseExceptionHandler(...)).
  • Fixes an issue where only the first request parameter is captured when request.parameters.* attributes are added to an include list.

Notes

  • We will be removing the core_20 directory from the download site the week of September 3rd, 2018 as it contains a deprecated version of the .Net Core agent. Please be sure to update any of your scripts that reference this location accordingly.
    • All downloads for the current version of the agent can be found in the latest_release directory on the download site.
    • Historical versions can be found in the previous_releases directory.

Upgrading

Tuesday, June 19, 2018 - 13:50

Download URLs

Download the appropriate release for your New Relic .NET agent:

https://download.newrelic.com/dot_net_agent/previous_releases

New Features

  • Adds automatic capture of datastore information for MongoDB driver versions 2.6.x, 2.5.x, 2.4.x, and 2.3.x.
  • [.NET Core 2.0] Adds thread profiler support for .NET Core applications running on Windows.

Fixes

  • Improved the agent's ability to recover from certain connection related issues without requiring an agent or application restart.

Upgrading

Wednesday, May 16, 2018 - 15:00

Download URLs

Download the appropriate release for your New Relic .NET agent:

https://download.newrelic.com/dot_net_agent/previous_releases

New Features

Fixes

  • [.NET Framework] Fixes issue of recursive directory creation when recovering from a failed upgrade install in the scriptable installer.
  • [.NET Framework] Fixes issue where Thread Profiler fails to resolve types and method names. These would appear as UnknownClass.UnknownMethod(<#>) in a profile.

Upgrading

Tuesday, May 1, 2018 - 15:00

New Features

  • [.NET Framework] The .NET Framework agent now supports instrumenting ASP.NET Core applications that are running on .NET Framework. The .NET Core specific agent is still required for instrumenting applications running on .NET Core.

Fixes

  • Fixed issue where deadlocks could occur in some situations when a ThreadAbortException was thrown within a client application.
  • Fixed issue where only the first transaction name set via API call to SetTransactionName() would be honored. Now, the last call to SetTransactionName() will be the name applied to the transaction.
  • [.NET Core 2.0] Fixed issue with the .NET Core agent on Windows where the CORECLR_PROFILER_PATH environment variable was not being expanded properly in certain deployment scenarios.
  • [.NET Framework] Fixed issue introduced in agent version 8.1.709.0 that caused some .NET Framework applications to throw the following exception: Unhandled Exception: System.IO.FileNotFoundException: Could not load file or assembly 'netstandard, Version=2.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' or one of its dependencies.

Upgrading

Thursday, April 19, 2018 - 16:00

This release has been unpublished. Use version 8.1.712.0 or higher.

This version introduced a bug that could cause crashes for .NET Framework applications manually loading types from assemblies in the application domain. This includes enumerating custom attributes. The encountered error will appear like the following:

Unhandled Exception: System.IO.FileNotFoundException: Could not load file or assembly 'netstandard, Version=2.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' or one of its dependencies. The system cannot find the file specified

New Features

  • [.NET Framework] The .NET Framework agent now supports instrumenting ASP.NET Core applications that are running on .NET Framework. The .NET Core specific agent is still required for instrumenting applications running on .NET Core.

Fixes

  • Fixed issue where deadlocks could occur in some situations when a ThreadAbortException was thrown within a client application.
  • Fixed issue where only the first transaction name set via API call to SetTransactionName() would be honored. Now, the last call to SetTransactionName() will be the name applied to the transaction.
  • [.NET Core 2.0] Fixed issue with the .NET Core agent on Windows where the CORECLR_PROFILER_PATH environment variable was not being expanded properly in certain deployment scenarios.

Upgrading

Wednesday, March 7, 2018 - 14:00

New Features

  • Adds stripExceptionMessages configuration option to the newrelic.config file. When enabled, this will remove error messages from errors that are reported to New Relic. This is the same behavior as having High Security Mode enabled but can be used without High Security Mode. The default value for this setting is false.

Fixes

  • Security Bulletin NR18-07: The agent will no longer run explain plans on MySQL queries that have multiple statements.

Other Changes

  • In order to increase security, disabling agent HTTPS communication via the service SSL configuration is no longer allowed.
  • WCF service parameters are now captured as request.parameters.* attributes and are no longer sent as service.request.* attributes.
  • Minimum version required for use in EU Datacenter.

Upgrading

Pages