.NET agent release notesRSS

New Features

• 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. Datastore instance details are captured by default. For more information, visit https://docs.newrelic.com/docs/apm/applications-menu/features/analyze-da...
• SQL trace identifiers now use an 8-byte value instead of a 4-byte value so that Data Loss Prevention monitors do not interpret the value as a 9-digit Social Security Number.

Upgrading

• For upgrade instructions, see Upgrade the .NET agent.
• If you are upgrading from a particularly old agent, see Upgrading legacy .NET agents for a list of major changes to the .NET agent.

New Features

• 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 load time information and the server page serve time for a web application to be considered together rather than separately.
• A new, scriptable, installer is now available for the .NET Agent. This new installer makes it easier to perform unattended installations of the agent. This installer does not require .NET 3.5. If it is used to install the agent on a 64-bit machine, then both the 32-bit and 64-bit applications will be instrumented. The existing MSI installer is still recommended if you prefer an interactive installation process. For details, see: https://docs.newrelic.com/docs/agents/net-agent/installation-configurati....

Fixes

• Fix an issue where the agent imposes a limitation on throughput for applications using datastores for which instance information is not currently supported.
• Fixed a bug where the database name was not being captured from Microsoft SQL Server connections for the purposes of datastore instance reporting.

Upgrading

• For upgrade instructions, see Upgrade the .NET agent.
• If you are upgrading from a particularly old agent, see Upgrading legacy .NET agents for a list of major changes to the .NET agent.

Fixes

• 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 be generated.

Upgrading

• For upgrade instructions, see Upgrade the .NET agent.
• If you are upgrading from a particularly old agent, see Upgrading legacy .NET agents for a list of major changes to the .NET agent.

New Features

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

Fixes

• The enabled attribute of the transactionTracer, when set to false, should disable all transaction trace output. This has been fixed in the .NET agent version 6.2.26.0

Upgrading

• For upgrade instructions, see Upgrade the .NET agent.
• If you are upgrading from a particularly old agent, see Upgrading legacy .NET agents for a list of major changes to the .NET agent.

New Features

• 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 verification.
• Added ability to configure the use of PUT instead of POST (the default) for sending data to New Relic. This can be useful in cases where DLP software requires PUT for verification.

Fixes

• Fixed issue where the Database Queries tab would not appear for relevant transaction traces in APM.

Upgrading

• For upgrade instructions, see Upgrade the .NET agent.
• If you are upgrading from a particularly old agent, see Upgrading legacy .NET agents for a list of major changes to the .NET agent.

New Features

Async support in .NET.

The .NET agent now provides out-of-the-box asynchronous framework instrumentation. With the standard async-await pattern, as introduced in .NET 4.5, calls to async methods can return while work being done in the called method is still in progress. For supported libraries and methods monitored with async custom instrumentation, the .NET agent observes this in-progress asynchronous work and waits for it to complete before recording timings.

To take full advantage of features in this release please see this document.

Fixes

• Fixed method segment naming for transaction traces to ensure consistency. For previous versions of the agent with async mode enabled, some method segments in transaction traces had inconsistent categories and different method formatting. Fixed these to make them consistent in async supported agent. Category: DotNet, Slowest components: Type.Method().

Upgrading

• For upgrade instructions, see Upgrade the .NET agent.
• If you are upgrading from a particularly old agent, see Upgrading legacy .NET agents for a list of major changes to the .NET agent.

New Features

• Minor performance improvement with cross application tracing.

Fixes

• Fixed a spelling error in NewRelic.Providers.Wrapper.WebServices.Instrumentation.xml.
• Removed duplicate instrumentation out of CoreInstrumentation.xml.
• Improved transaction handling for rare cases where a segment cannot be associated with its parent. This scenario can occur in applications with complex threading architectures and would previously cause the entire transaction to be dropped. The transaction will now be retained but the orphaned segment and children will be excluded. A warning log message including specifics will be generated for further troubleshooting.

Upgrading

• For upgrade instructions, see Upgrade the .NET agent.
• If you are upgrading from a particularly old agent, see Upgrading legacy .NET agents for a list of major changes to the .NET agent.

Fixes

• 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 / await is undefined in ASP.NET and could result in intermittent drops of metrics or potential deadlocks. You may stop seeing some async metrics for your application unless you update its web.config file, as documented here: https://docs.newrelic.com/docs/agents/net-agent/troubleshooting/missing-.... For a brief description of this configuration, see the section here: https://blogs.msdn.microsoft.com/webdev/2012/11/19/all-about-httpruntime...
• Async mode: Fixed issue where High-security mode was filtering some attributes that are not sensitive.
• Async mode: Fixed an issue that could lead to missing external segments in some async transactions.
• Async mode: Fixed an issue in .NET 4.0 and older where in certain instances call stacks may not accurately get tracked due to ASP.NET thread agility.
• Async mode: Fixed issue where calling AgentApi.GetBrowserTimingHeader() did not prevent subsequent calls in the same transaction or auto browser injection from injecting duplicate JavaScript.
• Async mode: Fixed issue where setting browser monitoring auto instrument to false would prevent NewRelic.Api.Agent.NewRelic.GetBrowserTimingHeader() from returning the header for manual injection.
• Enhanced the instrumentation for NServiceBus (receive side) so that when a service hosted by NServiceBus throws an unhandled exception while processing a service bus request, the New Relic Agent captures information about the error and generates an error trace.

Upgrading

• For upgrade instructions, see Upgrade the .NET agent.
• If you are upgrading from a particularly old agent, see Upgrading legacy .NET agents for a list of major changes to the .NET agent.

New Features

• 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: WebService/{ServiceClassName}/{MethodName}.
• Async mode: Added OpenRasta support to .NET Async mode. This instrumentation now appropriately names transactions using the {Controller}/{Action} format.
• Moved System.Web.UI.Page.PerformPreInit, System.Web.Compilation.AssemblyBuilder.Compile and System.Web.Compilation.BuildManager.CompileWebFile instrumentation configuration elements from the CoreInstrumentation.xml file to the Asp35.Instrumentation.xml file.

Fixes

• Async mode: Resolved an issue where the agent incorrectly handled HttpClient async requests that timed-out or were manually cancelled. These would show up as wrapper errors.

Upgrading

• For upgrade instructions, see Upgrade the .NET agent.
• If you are upgrading from a particularly old agent, see Upgrading legacy .NET agents for a list of major changes to the .NET agent.