.NET agent release notesRSS

Fixes application pool allow/deny listing bug introduced in 9.5.0 (#1015)

Adds new supportability metrics to track agent endpoint data usage. New metrics will be reported under the Supportability/DotNET/Collector namespace. (#899). Uses IMDSv2 instead of IMDSv1 to gather ut…

Fixes application crashes on Alpine Linux introduced in 9.5.0. (#929)

Internal improvements to runtime detection logic in the profiler component of the agent. (#891)

Allows NewRelicQueryName to be specified for SQL, to implement this suggestion. Thanks to community contributor @kevinpohlmeier for the implementation. (#799)

NServiceBus versions 6 and 7 are now supported in .NET Framework and .NET Core. (#857). Add ability to disable agent support for Server-Configuration with NEW_RELIC_IGNORE_SERVER_SIDE_CONFIG environme…

As of version 9.2.0, the New Relic .NET Core agent supports .NET 6.

Fixes issue #780: Improves management of gRPC channels during connection failure scenarios. (#782). Fixes issue #781: Windows MSI installer was not deploying gRPC libraries for netcore applications. (…

Feature #365: This version adds support for the Linux ARM64/AWS Graviton2 platform using .NET 5.0. (#768)Includes a new Processor Architecture property reported by the Agent with the Environment

Feature #672: This release of the .NET agent enables distributed tracing by default, and deprecates cross application tracing. (#700). Feature #671: The maximum number of samples stored for span event…

Fixes issue #627: Grpc channel shutdown can cause license_key is required error message. (#663). Fixes issue #683: Requested stack trace depth is not always honored. (#684)

Feature #611: Capture HTTP request method on transactions in the AspNetCore, Asp35, Wcf3, and Owin wrappers. Feature #580: Send initial app name and source in environment data. (#653). Adds support fo…

Fixes issue #485: SendDataOnExit configuration setting will prevent Infinite Traces data sending interuption on application exit. (#550). Fixes issue #155: MVC invalid Action for valid Controller can …

Adds Agent support for capturing HTTP Request Headers.Support included for ASP.NET 4.x, ASP.NET Core, Owin, and WCF instrumentation. (#558, #559, #560, #561). To enable this feature, the new allowAllH…

Fixes issue #500: For transactions without errors, the agent should still create the error intrinsics attribute with its value set to false. (#501). Fixes issue #522: When the maxStackTraceLines confi…

Fixes issue #22: Agent causes exception when distributed tracing is enabled in ASP.NET Core applications that use the RequestLocalization middleware in a Linux environment. (#493). Fixes issue #267: O…

This allows sites with a Content-Security-Policy that disables 'unsafe-inline' to emit the inline script with a nonce

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 or higher agent versions.

The agent will now handle having its infinite tracing traffic moved from one backend host to another without losing data or requiring an agent restart. Improved logging of infinite tracing connections

Adds support for .NET Core applications using RabbitMQ.Client. Adds support for RabbitMQ.Client version 6.2.1. Not supported: Distributed Tracing is not supported with the RabbitMQ AMQP 1.0 plugin. Ad…

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

We have validated that this version of the agent is compatible with .NET 5 GA. See the compatibility and requirements for .NET Core page for more details

We have validated that this version of the agent is compatible with .NET 5 Release Candidate 2

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 H…

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 u…

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.

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 healt…

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 t…

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…

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 com…

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 …

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 exa…

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 A…

New method, AddCustomAttribute(string, object) has been added to ITransaction.This new method accepts and supports all data types. Method AddCustomParameter(string, IConvertable) is still available wi…

Event data is now sent to New Relic every five seconds, instead of every minute. As a result, transaction, error, and custom events will now be available in New Relic One and Insights dashboards in ne…

Fixes security vulnerability NR20-01 which may cause SQL parameter values to appear in the agent log file when the logging level is set to Debug or Finest and the calling application supplies SQL para…

Enables ability to migrate to Configurable Security Policies (CSP) on a per agent basis for accounts already using High Security Mode (HSM). When both HSM and CSP are enabled for an account, an agent …

Fixes a problem that could cause some .NET Core 3.0 applications to hang if they were configured with an invalid license key

Improved support for WCF.Support for Task-based (TAP) service calls. Distributed Tracing and CAT are automatically supported for HTTP-based binding types (such as BasicHTTP, WebHTTP, WSHTTP). Non-HTTP…

.NET agent installation procedures have been simplified for Windows environments enabling you to more easily monitor .NET Core applications. Our standard installation procedures use a single MSI insta…

Adds instrumentation for StackExchange.Redis asynchronous methods. Generally, these methods end with the Async suffix (e.g., StringSetAsync). Adds support in the .NET Core Agent for StackExchange.Red…

Resolves security issue where a manually constructed SQL stored procedure invocation may cause sensitive data to be captured in metric names. See Security Bulletin NR19-05.

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 i…

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 r…

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 usin…

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

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 m…

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

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. Fix…

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-pub…

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

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

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 ena…

Users can now set a customized host name to be displayed in the APM UI via the newrelic.config file or an environment variable. For more information, visit https://docs.newrelic.com/docs/agents/net-ag…

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

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

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

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

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

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…

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…

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

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 hav…

Improved metadata collection for cloud providers. The agent now collects additional metadata when running in AWS, GCP, and Azure. This information is used to provide an enhanced experience when the ag…

Security Bulletin NR18-04: Fixes issue where error messages were not fully being filtered out of error traces and error events when High Security Mode was enabled

Modifying custom instrumentation XML files can now be performed without having to restart the monitored application. Instrumentation updates will be applied ‘dynamically’ at runtime. This feature requ…

The request URI for a web transaction will now be included as an attribute of transaction events and error events. The New Relic .NET Status Monitor has been retired and is no longer included in the i…

Highlights

The agent now supports running in FIPS compliance mode

Adds support for RestSharp library. The Agent can now instrument async and non-async methods from a RestSharp client. For supported methods, please visit here. The application name reported to New Rel…

Custom instrumentation can now be declared by applying the agent API's new Transaction and Trace attributes to methods. Using the Transaction attribute, transactions can be marked as Web vs. Non-Web. …

Adds instrumentation for OWIN hosted Web API applications on .NET framework using Microsoft.Owin.Host.HttpListener versions 3.* Instrumentation includes async-await support. Adds async-await support f…

Performance improvements when slowSQL is enabled, particularly for apps with lots of slow SQL queries

Agent overhead is reduced for transactions composed of an unusually large number of small activities

In some cases, the trace breakdown table overreported segment times. This happened when these three conditions were met, 1. instrumentation occurred through custom XML files, 2. the segment name was o…

Fixed an issue preventing injection of a mscorlib reference into every module

The .NET agent no longer supports Windows Server 2003. Applications running on Windows Server 2003 will be required to use .NET agent version 6.11 or lower. For more information, get support at suppor…

A new configuration option to supply a proxy URI path has been added to the newrelic.config file. See proxy-uripath

Fixed issue where "Query plan threshold" from server settings was being incorrectly interpreted. This caused a spike in SQL traces as well as explain plan executions for clients using server configura…

Fixes a bug where a SerializationException message is generated in New Relic log during monitoring of asychronous calls. Resolved issue where newrelic.config changes were not being picked up by the ag…

With this release, the agent reports error analytic events. The event type is called TransactionError, and it powers the Error Analytics in APM feature. The error events are also available through New…

Added instrumentation for RabbitMQ client versions 3.5 and above. For more information on which RabbitMQ operations are instrumented, see: Compatibility and requirements for the .NET agent. Added inst…

Fixes an issue where query string parameters of a request's referrer URL get sent to APM when they should not be. For more information see the security bulletin https://docs.newrelic.com/docs/accounts…

The agent now collects datastore instance information for Microsoft SQL Server, MySQL, PostGreSQL, Oracle, DB2, and Redis. This information is displayed in transaction traces and slow query traces. Da…

Transaction events and PageView events now include a common attribute, nr.tripId, which can be used to correlate between them in data returned by Insights. This allows, for example, the browser page l…

Fixed an issue where the agent was not sending data to New Relic upon exit from a very short running application. Fixed a bug where parameterized SQL queries might cause an incorrect explain plan to b…

Added support for IBM DB2 including slow query support. You'll see relevant breakdowns in the overview chart, entries in the Databases tab, and segments in transaction traces

Added ability to configure the use of Gzip compression instead of Deflate (the default) when sending data to New Relic. This can be useful in cases where DLP software requires Gzip compression for ver…

Async support in .NET.

Minor performance improvement with cross application tracing

Async mode - New Requirement: Await-friendly asynchronous pipeline introduced in ASP.NET 4.5 must be turned on in your web config for the instrumentation of async methods. Without this configuration, …

Async mode: Added System.Web.Script.Services.WebServiceMethodData support to .NET Async mode. All transactions named from this instrumentation will now use the more appropriate naming format of: WebSe…

Async mode: Added support for the metricName and transactionNamingPriority custom instrumentation options when async mode is enabled. Async mode: Added support for Castle MonoRail 2.x when async mode …

Async mode: Instrumentation of NServiceBus is now enabled when the AsyncMode flag is true. Async mode: Added support for Microsoft Message Queue (MSMQ) instrumentation when Async mode is enabled. Asyn…

New Features

Async mode: Custom instrumentation is now supported for both synchronous and asynchronous methods when async mode is enabled, however; the metricName and transactionNamePriority elements will not be r…

Async mode: Added support for SqlCommand method ExecuteReaderAsync, ExecuteScalarAsync, ExecuteNonQueryAsync, and ExecuteXmlReaderAsync. Async Mode: Added support for SQL Traces on slow SQL commands w…

Async Mode: Added Agent API support. Async mode: Instrumentation for synchronous SQL commands is available when the agent is in async mode

Async mode: The .NET agent now reports CPU and Memory usage metrics which will show up on the APM Application Overview page. Async mode: Basic support for Redis and MongoDB are available when the agen…

Async Mode: Added automatic Browser Monitoring support

Async mode: The .NET agent now has an optional async mode which provides a look at the agent's asynchronous framework instrumentation as it becomes available. As of this release, asynchronous instrume…

Fixed a bug where IIS applications using a classic pipeline app pool would sometimes not report transactions. Fixed a bug where clicking on the transaction name from an error trace would not take you …

Fixes an issue where if a customer was using the default proxy and not specifying one in the New Relic configuration for the Agent the default would not be used potentially causing HTTP status code 50…

Fixes a bug where the .NET Agent was not handling exceptions coming from HttpRequest.Path and HttpRequest.Url properties. Because the exception was unhandled users would see a System.Web.HttprequestVa…

Fixed a bug that caused certain frameworks (such as EpiServer CMS) to throw exceptions when trying to resolve a reference to JetBrains. Fixed a bug that caused ASMX web service exceptions to not be no…

Fixed a bug that prevented self-hosted WCF applications from automatically creating Traced Errors

Added StackExchange.Redis framework support. The .Net agent now records time spent making StackExchange.Redis API calls, which will appear as Datastore metrics and Transaction Trace segments in New Re…

Added ServiceStack.Redis v3.x and v4.x framework support. The .Net agent now wraps time spent making ServiceStack.Redis API calls, which will appear as Datastore metrics and Transaction Trace segments…

Fixes a bug which caused the .NET Agent to stop reporting intermittently due to an exception raised within the .NET Framework and caught by the Agent. Fixes an unhandled System.ObjectDisposedException…

Web requests for static resources which are handled by System.Web.Optimization will be named with the requested URL instead of the unmapped route parameters (some previously were named {controller}/{a…

Transactions using MVC attribute routing will show the correct action name instead of "Unknown Action"

Adds an API method for setting the name of the application reported to in New Relic at runtime. Adds a configuration option for stopping the agent from reporting automatically when the agent starts up…

The .NET agent now provides an API for sending custom events to New Relic Insights

Fixed a bug that sometimes caused thread profiles to be empty

Web transaction types (seen in tooltips) should now be more meaningful. When you mouse over a transaction, instead of showing it will show ASP, MVC, WebAPI, WebService, WCF, etc

Non-web transactions can now report Apdex scores. This can be done by marking a non-web transaction as Key Transaction and setting its Apdex threshold to the desired time (in seconds). This allows mon…

Customers who use the MongoDB.Driver for .NET in their applications will start to see MongoDB-based transaction segments. Operations will include data querying, aggregation, index creation/retrieval, …

Fixes a bug that would break WebResources if a response filter was hooked up. This was caused by a bug in AssemblyResourceLoader (part of ASP.NET/WebForms)

Unified view for SQL database and NoSQL datastore products. For more information, see https://docs.newrelic.com/docs/apm/applications-menu/monitoring/databases-slow-queries-dashboard

ASP.NET, MVC, and Web API instrumentation has been greatly improved. We now time each of the lifecycle events to help diagnose problematic areas of the .NET lifecycle such as session state lock conten…

The .Net Agent now reports Insights Transaction Events for transactions that are errors. New queryable attributes: errorType and errorMessage are reported on these events, providing a reliable way to …

Fixes a bug where setting transaction trace threshold from the New Relic UI would cause it to revert to default. Fixes a bug where the cross application map would sometimes show the wrong color (apdex…

The .NET agent now gives you additional information for requests from New Relic Synthetics. More transaction traces and events give you a clearer look into how your application is performing around th…

Added support for agent-side creation of application labels and categories via newrelic.config or the NEW_RELIC_LABELS environment variable.Labeling enables organization of applications with labels an…

Disables automatic instrumentation of Microsoft Azure Websites SCM service site

Adds functionality to the system tray application that will collate information commonly asked for by New Relic support and upload it to S3 when instructed to by the user. Response.status is now repor…

You can now fine tune the attributes the .NET agent sends to New Relic. For more information, see .NET agent attributes

This release enhances cross application tracing with a visualization of the cross application calls that a specific Transaction Trace is involved in. The new visualization helps you spot bottlenecks i…

Provides visibility into Microsoft Message Queue (MSMQ) activity. Within a web transaction, e.g., you can now see whether a message has been sent to a queue, pulled off a queue, peeked at, or if a que…

Agent-Side High Security Configuration

New Features

Improvements

Improvements

Removed unnecessary instrumentation of an ASP.NET pipeline execution method. When automatically inserting the browser monitoring javascript, the agent now assures that a charset meta-tag continues to …

Improvements

Fixes

Improvements

Improvements

Fixes an issue where browser traces were not showing up in New Relic

Improvements

Fixes

Fixes

This is a patch release to address an issue introduced in 2.17.266.0 where resources were not properly disposed, potentially causing a degradation in throughput over time

Fixes

Fixes

Fixes

New Features

Fixes

Fixes

Fixes

Fixes

Fixes

This is an interim release which addresses performance issues by temporarily disabling some features.

Fixes

Fixes

New Features

New Features

New Features

New Features

New Features

New Features

Fixes

Fixes

New Features

New Features

New Features

Fixes

Fixes

Do a better job of exercising some diagnostic print statements. Strip off the generic qualifier (backtick and beyond) in Exception names when comparing names with a list of exception names to ignore. …

Extend the command-line tool NewRelic.DiagnosticTool.exe to try to write to logs, %TMP% and to the registry. Add DiagnosticToolDocumentation.html that describes the DiagnosticTool. Improve error messa…

Fix a bug when profiling functions with non-builtin value types as arguments. such as "KeyValuePair", "Decimal", etc. Make the profiler's interaction with the CLR memory more robust. Improve documenta…