.NET agent release notesRSS

Notice: If using Microsoft.Extensions.Logging as your logging framework of choice, please use .NET agent version 10.1.0 or newer. We encourage you to adopt the newer version due to bug #1230, which we fixed in #1237, that was resolved in .NET agent version 10.1.0.

Fixes

• Adds missing instrumentation for application logging feature when using the MSI installer (#1055)
• Fixes issue on Linux when specifying a non-default profiler log directory with non-existent intermediate directories. (#1051)

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

Notice: For the new application logging features, if you install using the MSI, please update to version 9.7.1 or later.

Notice: If using Microsoft.Extensions.Logging as your logging framework of choice, please use .NET agent version 10.1.0 or newer. We encourage you to adopt the newer version due to bug #1230, which we fixed in #1237, that was resolved in .NET agent version 10.1.0.

New Features

• Adds support for logging metrics which shows the rate of log message by severity in the Logs chart in the APM Summary view for Log4net, Serilog, and Microsoft.Extensions.Logging. This is enabled by default in this release. (#1034)
• Adds support for forwarding application logs to New Relic. This automatically sends enriched application logs for Log4net, Serilog, and Microsoft.Extensions.Logging. This is disabled by default in this release. (#1034)
• Adds support for enriching application logs written to disk or standard out for Log4net, Serilog, Microsoft.Extensions.Logging. This can be used with another log forwarder if in-agent log forwarding is not desired. We recommend enabling either log forwarding or local log decorating, but not both features. This is disabled by default in this release. To learn more about APM logs in context and the configuration options, please see the documentation here. (#1034)
• Adds flexibility to what is accepted to enable/disable boolean environment variables per FR #1008. "0"/"1", and case insensitive "true"/"false" are now accepted. (#1033)

Fixes

• Adds a new environment variable NEW_RELIC_DISABLE_APPDOMAIN_CACHING for customers to try when experiencing #533 high lock contention related to AppDomain.GetData() usage by the agent when profiling .NET Framework applications. (#1033)

Deprecations

• The scriptable installers are now deprecated and will be removed from the download site in a future major release. (Issue: #571)
• The established release installers are now deprecated and will be removed from the download site in a future major release. (Issue: #578)

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.26.630.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 pool allow/deny listing bug introduced in 9.5.0 (#1015)

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

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