.NET agent release notesRSS

New Features

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

Fixes

• Fixed an issue with NuGet package metadata. (#901)

Checksums

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is .NET agent 8.24.244.0.

Upgrading

• Follow standard procedures to update the .NET agent.
• If you are upgrading from a particularly old agent, review the list of major changes and procedures to upgrade legacy .NET agents.

New Features

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

Fixes

• Resolves an issue where GC metrics were not being properly captured for .NET 6 applications (#874)

Checksums

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is .NET agent 8.24.244.0.

Upgrading

• Follow standard procedures to update the .NET agent.
• If you are upgrading from a particularly old agent, review the list of major changes and procedures to upgrade legacy .NET agents.

New Features

• 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 environment variable. The available value options are true and false. (#814)

Fixes

• Fixes issue #36: Total system memory will now be correctly reported on Linux. (#855)
• Fixes an issue in newrelic.config file schema validation that could block agent startup. (#835)

Checksums

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is .NET agent 8.22.181.0.

Upgrading

• Follow standard procedures to update the .NET agent.
• If you are upgrading from a particularly old agent, review the list of major changes and procedures to upgrade legacy .NET agents.

.NET 6 Compatibility

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

New Features

• Adds automatic instrumentation for the Microsoft.Azure.Cosmos client library. (#811)
• Adds additional logging to the Garbage Collection performance metrics to aid in troubleshooting performance counter issues. (#792)
• Feature #800: for .NET Framework apps instrumented with the .NET Framework agent, the value of the ".NET Version" property in the Environment data page will more accurately reflect the version of .NET Framework in use. (#801)

Fixes

• Fixes issue #803: Thread safety issue in access to HTTP headers collection in HttpClient on .NET 6. (#804)

Checksums

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is .NET agent 8.22.181.0.

Upgrading

• Follow standard procedures to update the .NET agent.
• If you are upgrading from a particularly old agent, review the list of major changes and procedures to upgrade legacy .NET agents.

Fixes

• 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. (#788)

Checksums

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is .NET agent 8.13.798.0.

Upgrading

• Follow standard procedures to update the .NET agent.
• If you are upgrading from a particularly old agent, review the list of major changes and procedures to upgrade legacy .NET agents.

New Features

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

Fixes

• Fixes issue #754: Agent could cause applications that use configuration builders from Microsoft.Configuration.ConfigurationBuilders to hang on startup. (#753)

Checksums

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is .NET agent 8.13.798.0.

Upgrading

• Follow standard procedures to update the .NET agent.
• If you are upgrading from a particularly old agent, review the list of major changes and procedures to upgrade legacy .NET agents.

New Features

• 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 events can be configured via the spanEvents.maximumSamplesStored configuration in the newrelic.config or the NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED environment variable.(#701)
• Feature #703: Increases the default maximum number of samples stored for span events from 1000 to 2000.(#705)
• Feature #532: Adds environment variables for log level NEWRELIC_LOG_LEVEL and directory NEWRELIC_LOG_DIRECTORY to allow better control of logs for the agent and the profiler. (#717)

Fixes

• Fixes issue #707: In 8.40.1 SQL explain plans are not being captured for parameterized SQL statements. (#708)
• Fixes issue #502: Agent encountering serialization error (#715)
• Fixes issue #679: Update gRPC libraries from 2.35.0 to 2.40.0 to reduce installation size (#721)

Deprecations/Removed Features

• Cross application tracing is now deprecated, and disabled by default. To continue using it, enable it with crossApplicationTracer.enabled = true and distributedTracing.enabled = false.
• Issue #667, 668, #669: previously deprecated agent configuration options are now disabled. See the migration guide for details.
• Issue #666: previously deprecated agent APIs have been removed, and disabled in the Agent. Disabled APIs will log a warning when invoked by old versions of the .NET agent API. See the migration guide for details. (#687)
• Issue #702 Deprecate instrumentation for Castle.Monorail (#710)

Checksums

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is .NET agent 8.13.798.0.

Upgrading

• Follow standard procedures to update the .NET agent.
• If you are upgrading from a particularly old agent, review the list of major changes and procedures to upgrade legacy .NET agents.

Fixes

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

Checksums

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is .NET Agent 8.13.798.0.

Upgrading

• Follow standard procedures to update the .NET agent.
• If you are upgrading from a particularly old agent, review the list of major changes and procedures to upgrade legacy .NET agents.

New Features

• 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 for capturing stack traces for each instrumented method in a Transaction Trace.
  • This feature is disabled by default.
  • You can enable the capture of stack traces by setting either maxStackTrace to any value greater than 1. This value will only be used to determine if stack traces are captured or not despite the name.
  • The following are the default settings for stack traces. These can be changed using the newrelic.config:
    • A maximum 80 stack frames are reported per stack trace.

Fixes

• Fixes issue #639: RabbitMQ instrumentation can delete user headers from messages. Thank you @witoldsz for finding and reporting this bug. (#648)

Checksums

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is .NET Agent 8.13.798.0.

Upgrading

• Follow standard procedures to update the .NET agent.
• If you are upgrading from a particularly old agent, review the list of major changes and procedures to upgrade legacy .NET agents.