.NET agent release notesRSS

New Features

• 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 utilization details for AWS hosted instances. 965

Checksums

Support statement

New Relic recommends that you update 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.

Updating

• Follow standard procedures to update the .NET agent.
• If you're using a particularly old agent, review the list of major changes and procedures for updating legacy .NET agents.

Fixes

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

Checksums

Support statement

New Relic recommends that you update 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.

Updating

• Follow standard procedures to update the .NET agent.
• If you're using a particularly old agent, review the list of major changes and procedures for updating legacy .NET agents.

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.