Release v9.8.1

Features

• Adds an internal list of deprecated instrumentation xml files which will cause the profiler to ignore deprecated instrumentation. This feature avoids an issue where orphaned deprecated log forwarding instrumentation could conflict with newer instrumentation. (#1051)

Fixes

• Fixes an issue with log forwarding where an agent could momentarily forward logs even if the feature had been disabled at an account level. (#1051)

Once published, the release artifacts for this release can be found at https://download.newrelic.com/dot_net_agent/latest_release/ or on NuGet.org.

Installation instructions can be found at https://docs.newrelic.com/docs/agents/net-agent/installation/introduction-net-agent-install/

Release v9.8.0

APM logs in context

Automatic application log forwarding is now enabled by default. This version of the agent will automatically send enriched application logs to New Relic. To learn more about about this feature see here, and additional configuration options are available here. To learn about how to toggle log ingestion on or off by account see here.

New Features

• Error messages in error traces and error events now retain up to 1023 characters instead of 255 characters. #1058
• New environment variables have been added for AllowAllHeaders and Attributes configuration settings. See our documentation for more details. #1059
• Introduces environment variables to enabled/disable cloud detection to facilitate customer use cases and reduce errors in logs. (#1061)
• New environment variables have been added for all Proxy configuration settings. See our documentation for more details. #1063
• Introduces a new configuration option to force custom instrumentation to create new transactions in async scenarios versus re-using an existing transaction. #1071

Fixes

• Fixes Agent fails to execute explain plan for parameterized stored procedure. (#1066)
• Fixes getting duplicate logs using log forwarding and Serilog. #1076

Deprecations

Microsoft has officially EOL:

• .NET Framework versions 4.5.1, 4.5.2, and 4.6.1 on Apr 26, 2022.
• .NET Core version 2.0 on October 1, 2018.
• .NET Core version 2.1 on August 21, 2021.
• .NET Core version 2.2 on December 23, 2019.
• .NET Core version 3.0 on March 3, 2020.

The official product lifecycle start and end dates can be found here for .NET Framework and here for .NET Core onward. The .NET agent support of these framework versions is will continue as is with the released versions. In a future major release, we will target .NET Framework 4.6.2 and .NET Core 3.1 onwards.

Once published, the release artifacts for this release can be found at https://download.newrelic.com/dot_net_agent/latest_release/ or on NuGet.org.

Installation instructions can be found at https://docs.newrelic.com/docs/agents/net-agent/installation/introduction-net-agent-install/

Release v9.7.1

Fixes

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

Once published, the release artifacts for this release can be found at https://download.newrelic.com/dot_net_agent/latest_release/ or on NuGet.org.

Installation instructions can be found at https://docs.newrelic.com/docs/agents/net-agent/installation/introduction-net-agent-install/

New Relic Azure Site Extension v1.5.3 Release

Fixes Issue #1005: site extension did not work when the the web app was set to run from a package, and broke after deployment of customer applications in some cases due to the agent being deployed to the site directory. #1021

Release v9.7.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. (#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)

Release v9.6.1

Fixes

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

Once published, the release artifacts for this release can be found at https://download.newrelic.com/dot_net_agent/latest_release/ or on NuGet.org.

Installation instructions can be found at https://docs.newrelic.com/docs/agents/net-agent/installation/introduction-net-agent-install/

Release v9.6.0

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

Once published, the release artifacts for this release can be found at https://download.newrelic.com/dot_net_agent/latest_release/ or on NuGet.org.

Installation instructions can be found at https://docs.newrelic.com/docs/agents/net-agent/installation/introduction-net-agent-install/

Release v9.5.1

Fixes

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

Once published, the release artifacts for this release can be found at https://download.newrelic.com/dot_net_agent/latest_release/ or on NuGet.org.

Installation instructions can be found at https://docs.newrelic.com/docs/agents/net-agent/installation/introduction-net-agent-install/

Release v9.5.0

**WARNING** Do not upgrade to this version if you are using the agent on Alpine Linux; it will crash your applications. See #918 for more details.

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)

Once published, the release artifacts for this release can be found at https://download.newrelic.com/dot_net_agent/latest_release/ or on NuGet.org.

Installation instructions can be found at https://docs.newrelic.com/docs/agents/net-agent/installation/introduction-net-agent-install/

Release v9.4.0

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)

Once published, the release artifacts for this release can be found at https://download.newrelic.com/dot_net_agent/latest_release/ or on NuGet.org.

Installation instructions can be found at https://docs.newrelic.com/docs/agents/net-agent/installation/introduction-net-agent-install/