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, October 12, 2020 - 14:00 Download

Download URLs

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

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

Fixes

  • Fixes #223 so the agent can be compatible with ASP.NET Core 5 RC1.
  • Fixes issue in .NET 5 applications where external calls made with HttpClient may not get instrumented. For example, calls made with HttpClient.GetStringAsync would be missed. (#235)
  • Fixes issue #257 where .NET Standard Libraries that do not reference mscorlib fail to be instrumented in .NET Framework applications.
  • Reduces the performance impact of large amounts of instrumentation. See issue #269 for more information.

Checksums

File SHA-256 Hash
newrelic-agent-win-8.33.0.0-scriptable-installer.zip B9685CE346FBCC1D403E3AFCB032C3050ABEE0EED7CB468387FE6793B78139F4
newrelic-agent-win-x64-8.33.0.0.msi 2C641DE0A6EB1CC81812341219CB8B2D1A7B17D37BC0E10435670DC91F5F03D0
newrelic-agent-win-x64-8.33.0.0.zip 8BA85B43037222C642DCAC1647922267C232BD5ABD67315BD31C27A9ECE49A65
newrelic-agent-win-x86-8.33.0.0.msi 5D6CB7F0BE00969356AB62DFA2DEB028AA8CABD13CD177760E960E29532E33A2
newrelic-agent-win-x86-8.33.0.0.zip E532F3ADFCE4D5D835C1865410F07A74E11C364C9486C89BE19326FC842D7C1F
newrelic-netcore20-agent-8.33.0.0-1.x86_64.rpm EE37954141958D9F5E76ED129CAD5836C0D6F5AD20F8D2C9CD6D7521FEF9AC7A
newrelic-netcore20-agent-win-8.33.0.0-scriptable-installer.zip C7AFFA93D569DB20E0D8D1F6136F002284F7E7FDCF6AB97A33F9A3C1464A605E
newrelic-netcore20-agent-win-x64-8.33.0.0.zip 4CDF06211CAE67ED5393F18424FBD91F884A4EF82B3F5CB639643BE16A8430DF
newrelic-netcore20-agent-win-x86-8.33.0.0.zip EA4B519DFA40615F7877389808DCDD65DC5F9E9F84A5CBD701B6D28814C037DD
newrelic-netcore20-agent_8.33.0.0_amd64.deb CBE01E82D68718254F29A491243766FF759E0295C1559487A466178BE01CBD71
newrelic-netcore20-agent_8.33.0.0_amd64.tar.gz 150FB5A6D122B78457FAD596C842F2B49682680085BF666767B492F37E694EF0

Upgrading

Wednesday, September 16, 2020 - 12:00

New Features

  • Proxy Password Obfuscation Support
    Agent configuration supports the obfuscation of the proxy password. The New Relic Command Line Interface (CLI) may be used to obscure the proxy password. The following documentation describes how to use an obscured proxy password in the .NET Agent configuration.

  • MySqlConnector Support
    The MySqlConnector ADO.NET driver is instrumented by default. Fixes #85 and implements this suggestion.

  • Nullable Reference Type support in the API
    Enables nullable reference types that are part of the C# 8.0 language specification and updates the signatures of API methods accordingly. There should be no required changes in API usage.

  • Improved Support for NetTCP Binding in WCF Instrumentation
    When the NetTCP Binding type is used in Windows Communication Foundation (WCF), the Agent will now send and receive trace context information in support of Distributed Tracing (DT) or Cross Application Tracing (CAT). Implements #209.

Fixes

  • Fixes an issue that may cause InvalidCastException due to an assembly version mismatch in Mvc3 instrumentation.
  • Fixes an async timing issue that can cause the end time of Task-returning methods to be determined incorrectly.

Checksums

File SHA-256 Hash
newrelic-agent-win-8.32.0.0-scriptable-installer.zip 992B077AF9F8966F3F4B7925B6ACB5CE18390EF16115DBE136723EFC3965F3AB
newrelic-agent-win-x64-8.32.0.0.msi A675DA40B522551B3DBBCA49941143940A5253E88DD59F26E5B2C862EF6A48FE
newrelic-agent-win-x64-8.32.0.0.zip 9ABAE87713705DA3C7C3C65BA89DA4A0FE9E05739E00A90152882BF37E3F1679
newrelic-agent-win-x86-8.32.0.0.msi 98D21C44C55663BB5DA762C1FAFA576EAAE24D7A62B6BAAC8337813DF1F0A9BC
newrelic-agent-win-x86-8.32.0.0.zip 846F9B0E36B6F374AE547FD9AD9AB508A47D4D8567E9EAE20F18136F762F5E86
newrelic-netcore20-agent-8.32.0.0-1.x86_64.rpm 6E6148B069E4B55F7E001AA2524EC5B75306E1901005977FA76F8AD3834E5541
newrelic-netcore20-agent-win-8.32.0.0-scriptable-installer.zip 842D04237B478A35E3634A92B1E21C734227B6173CE587F790F66E7209163550
newrelic-netcore20-agent-win-x64-8.32.0.0.zip 81D9ABE4DC782CBDAA0B3F8EF2D3AE9E545DE9DB9A9B3BF2F3FD4AF4AFCA9FA2
newrelic-netcore20-agent-win-x86-8.32.0.0.zip 6A78FD50FF666EFAA65AA97EA0FDE8F97BBEA7223DAEFAB2AC929F43F4A696E9
newrelic-netcore20-agent_8.32.0.0_amd64.deb CE44BF8463B0BFD7AE711ACDB4EB07553CBB8F68066CCFA09FAEFB830D53277C
newrelic-netcore20-agent_8.32.0.0_amd64.tar.gz 695A77EC5693349E8122B59AD1655DE4AA41CB484C7580A2BFAE5726129CE371

Upgrading

Tuesday, September 15, 2020 - 17:00 Download

Notes

The 6.x agent supports legacy frameworks (.NET version 4.5 and lower). If you are on .NET version 4.5 or higher, or if you are on .NET Core, use the 8.x agent versions.

Download URLs

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

New Features

  • The .NET Agent is now open source!
    The New Relic .NET agent is now open source! Now you can view the source code to help with troubleshooting, observe the project roadmap, and file issues directly in this repository. We are now using the Apache 2 license. See our Contributing guide and Code of Conduct for details on contributing!

  • SSL Required
    In order to increase security, disabling agent HTTPS communication via the service SSL configuration is no longer supported. All communication with New Relic services will occur via SSL.

  • EU Data Center Support
    Adds support for communicating with New Relic's EU Data Center. Please review our docs site for further information.

Upgrading

Monday, August 17, 2020 - 12:00

New Features

  • Expected Errors Support
    Certain errors that are expected within the application may be identified so that they will not be counted towards the application's error rate and Apdex Score. Only errors that truly affect the health of the application will be alerted on. Please review the following documentation for details on how to configure Expected Errors.

  • Ignored Errors Enhancements
    Certain errors may be identified in configuration so that they will be ignored. These errors will not be counted towards the application's error rate, Apdex score, and will not be reported by the agent. Please review the following documentation for details on how to configure Ignored Errors.

    • New configuration element <ignoreMessages>supports filtering based on the error message.
    • Please note that the <ignoreErrors> configuration element has been deprecated and replaced by <ignoreClasses>. The .NET Agent continues to support this configuration element, but its support may be removed in the future.

Fixes

  • Garbage Collection Performance Metrics for Windows
    Fixes an issue where Garbage Collection Performance Metrics may not be reported for Windows Applications.

  • Maintaining newrelic.config on Linux package upgrades
    Fixes an issue where newrelic.config was being overwritten when upgrading the agent via either rpm/yum (RedHat/Centos) or dpkg/apt (Debian/Ubuntu).

Checksums

File SHA-256 Hash
newrelic-agent-win-8.31.0.0-scriptable-installer.zip 1A7D11F91E36259BED3C5A99ACB7FDD967BEACE36AC744401CB3D8D1A2FF1D48
newrelic-agent-win-x64-8.31.0.0.msi 4F9AB318FCD3956703E659A3B2C8F4C4F1C51F479F479659B384DEA64A701813
newrelic-agent-win-x64-8.31.0.0.zip D0F4BE582B090B7B6F6EF76B837904A8DA18713E2715E6573145B9AB11603560
newrelic-agent-win-x86-8.31.0.0.msi C28C875482B22A4D929FFDB1E9EC46EF2CA1EDEDAE46360DC5E257CF5BF86E3F
newrelic-agent-win-x86-8.31.0.0.zip B689142C9B5373EB0272D6C3C3759E1A9DD2717A4FE79140BC9B766E8FABF71D
newrelic-netcore20-agent-8.31.0.0-1.x86_64.rpm 4B56330CDD2F8BA7D661A5ECC47E9C53AA52D1295D9F67748BF1F342BA6852EE
newrelic-netcore20-agent-win-8.31.0.0-scriptable-installer.zip 27DB97C3B407115033EAC92DC608567E7C605E5D91297EFD298EA84E78F3BB71
newrelic-netcore20-agent-win-x64-8.31.0.0.zip 3DAFB26542734531311C7963870EA21F43E028BB00EA4044D70DF18A58993484
newrelic-netcore20-agent-win-x86-8.31.0.0.zip 55B3EBEA7298D5DC47A5FC72C81327C6B62EE560445E3595FDA88BE464532898
newrelic-netcore20-agent_8.31.0.0_amd64.deb 14EB3E46E1A540A020433CA83EDAC75076C1DF9D8894C205582A1FE0330B1981
newrelic-netcore20-agent_8.31.0.0_amd64.tar.gz 5EA9620DE0D3EA72859EEC058E3CD811F8BAFCAB6957F005B9D1EFC73A9CB400

Upgrading

Thursday, July 16, 2020 - 17:00

New Features

  • The .NET agent is now open source!
    The New Relic .NET agent is now open source! Now you can view the source code to help with troubleshooting, observe the project roadmap, and file issues directly in this repository. We are now using the Apache 2 license. See our Contributing guide and Code of Conduct for details on contributing!

Fixes

  • Memory usage reporting for Linux
    Fixes issue where applications running on Linux were either reporting no physical memory usage or using VmData to report the physical memory usage of the application. The agent now uses VmRSS through a call to Process.WorkingSet64 to report physical memory usage. See the dotnet runtime discussion and the proc man pages for more details about this change.

  • Infinite Tracing performance
    Fixes issue where the agent may consume too much memory when using Infinite Tracing.

  • .NET 5 support
    Fixes issue with applications running on .NET 5 that prevented instrumentation changes at runtime (either though editing instrumentation XML files or through the Live Instrumentation editor Beta).

Upgrading

Thursday, June 25, 2020 - 17:00

New Features

  • Additional Transaction Information applied to Span Events When Distributed Tracing and/or Infinite Tracing are enabled, the Agent will now incorporate additional information from the Transaction Event on to the root Span Event of the transaction. The following items are affected:

    1. Request Parameters request.parameter.*
    2. Custom Attribute Values applied to the Transaction via API Calls AddCustomParameter and ITransaction.AddCustomAttribute.
    3. request.uri
    4. response.status 5 host.displayName
  • Security Recommendation Review your Transaction Attributes configuration. Any attribute include or exclude settings specific to Transaction Events, should be applied to your Span Attributes configuration or your Global Attributes configuration.

Fixes

  • Fixes issue where updating custom instrumentation while application is running could cause application to crash.

Upgrading

Thursday, June 4, 2020 - 14:00

New Features

Fixes

  • Infinite Tracing
    • Fixes issue with Infinite Tracing where a communication error can result in consuming too much CPU.
    • Fixes issue with Infinite Tracing where a communication error did not clean up its corresponding communication threads.
    • Agent version 8.30 introduces significant performance enhancements to Infinite Tracing. To use Infinite Tracing, please upgrade to version 8.30 or later.

  • Fixes issue in .NET Framework ASP.NET MVC applications where transactions started on one thread would flow to background threads (e.g., started with Task.Run) in some scenarios but not others. Transaction state used to only flow to a background thread if the transaction originated from an async controller action. Transaction state now flows to background threads regardless of whether the controller action is async or not.
  • Fixes issue in .NET Framework ASP.NET MVC applications where agent instrumentation of an MVC controller action could cause an InvalidProgramException.
  • Fixes a problem with the reporting of Errors where Error Events may not appear even though Error Traces are being sent.

Upgrading

Thursday, April 30, 2020 - 16:00 Download

New Features

  • Support for W3C Trace Context, with easy upgrade from New Relic trace context
    • Distributed Tracing now supports W3C Trace Context headers for HTTP when distributed tracing is enabled. Our implementation can accept and emit both W3C trace header format and New Relic trace header format. This simplifies agent upgrades, allowing trace context to be propagated between services with older and newer releases of New Relic agents. W3C trace header format will always be accepted and emitted. New Relic trace header format will be accepted, and you can optionally disable emission of the New Relic trace header format.
    • When distributed tracing is enabled with <distributedTracing enabled="true" />, the .NET agent will now accept W3C's traceparent and tracestate headers when calling Transaction.AcceptDistributedTraceHeaders. When calling Transaction.InsertDistributedTraceHeaders, the .NET agent will include the W3C headers along with the New Relic distributed tracing header, unless the New Relic trace header format is disabled using <distributedTracing enabled="true" excludeNewrelicHeader="true" />.
    • The existing Transaction.AcceptDistributedTracePayload and Transaction.CreateDistributedTracePayload APIs are deprecated in favor of Transaction.AcceptDistributedTraceHeaders and Transaction.InsertDistributedTraceHeaders.

Fixes

  • Fixes issue which prevented Synthetics from working when distributed tracing is enabled.
  • Fixes issue where our RPM package for installing the agent on RPM-based Linux distributions included a 32-bit shared library, which created unnecessary dependencies on 32-bit system libraries.
  • Fixes issue where the TransportDuration metric for distributed traces was always reporting 0.

Upgrading

Monday, April 20, 2020 - 16:00 Download

New Features

  • Infinite Tracing on New Relic Edge

    This release adds support for Infinite Tracing on New Relic Edge. Infinite Tracing observes 100% of your distributed traces and provides visualizations for the most actionable data so you have the examples of errors and long-running traces so you can better diagnose and troubleshoot your systems.

    You configure your agent to send traces to a trace observer in New Relic Edge. You view your distributed traces through the New Relic’s UI. There is no need to install a collector on your network.

    Infinite Tracing is currently available on a sign-up basis. If you would like to participate, please contact your sales representative.

    Agent version 8.30 introduces significant performance enhancements to Infinite Tracing. To use Infinite Tracing, please upgrade to version 8.30 or later.

  • Error attributes now added to each span that exits with an error or exception

    Error attributes error.class and error.message are now included on the span event in which an error or exception was noticed, and, in the case of unhandled exceptions, on any ancestor spans that also exit with an error. The public API method NoticeError now attaches these error attributes to the currently executing span.

    Spans with error details are now highlighted red in the Distributed Tracing UI, and error details will expose the associated error.class and error.message. It is also now possible to see when an exception leaves the boundary of the span, and if it is caught in an ancestor span without reaching the entry span. NOTE: This “bubbling up” of exceptions will impact the error count when compared to prior behavior for the same trace. It is possible to have a trace that now has span errors without the trace level showing an error.

    If multiple errors occur on the same span, only the most recent error information is added to the attributes. Prior errors on the same span are overwritten.

    These span event attributes conform to ignored errors configuration.

Fixes

  • Fixes issue in the MSI installer which prevented the InstrumentAllNETFramework feature selection from working as expected on the command line.
  • Fixes issue for Azure App Service environments running on Linux that caused both the application and its Kudu process to be instrumented by the agent. The Kudu process is no longer instrumented.
  • Fixes issue when using the ignoreErrors configuration. Previously, when an exception contained a inner exception(s), the ignoreErrors config was only applied to the outer-most exception. Now, both the outer-most and inner-most exception type are considered when evaluating the ignoreErrors configuration.
  • Fixes an issue that could cause an exception to occur in the instrumentation for StackExchange Redis. This exception caused the instrumentation to shut down leaving StackExchange Redis uninstrumented.

Upgrading

Wednesday, March 11, 2020 - 16:00 Download

New Features

  • Thread profiling support for Linux

    Thread profiling on Linux will be supported on .NET Core 3.0 or later applications when running .NET agent version 8.23 or later. Triggering a thread profile is done from the Thread profiler page in APM.

  • Accessing Span-Specific information using the .NET Agent API

    New property, CurrentSpan has been added to IAgent and ITransaction. It returns an object implementing ISpan which provides access to span-specific functions within the API.

  • Adding Custom Span Attributes using the .NET Agent API

    New method, AddCustomAttribute(string, object) has been added to ISpan.

Fixes

  • Fixes issue where adding multiple custom attributes on a Transaction using ITransaction.AddCustomAttribute causes the agent to ignore additional attempts to add custom attributes to any transaction.
  • Fixes issue that prevented Custom Events from being sent to New Relic until the agent shuts down.
  • Fixes issue that can cause asynchronous Redis calls in an ASP.NET MVC application to report an inflated duration.

Upgrading

Pages