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.
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 the APM logs in context documentation. For additional configuration options, see the .NET logs in context documentation. To learn about how to toggle log ingestion on or off by account, see our documentation to disable automatic logging via the UI or API.
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
AllowAllHeadersandAttributesconfiguration settings. See our configuration documentation for more details. #1059 - Introduces environment variables to enable/disable cloud detection to facilitate customer use cases and reduce errors in logs. (#1061)
- New environment variables have been added for all
Proxyconfiguration settings. See our configuration 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 EOLed:
- .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 on the Microsoft documentation for .NET Framework and for .NET Core onward. Our .NET agent support of these framework versions 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.
Checksums
| File | SHA - 256 Hash |
|---|---|
| newrelic-agent-win-9.8.0.0-scriptable-installer.zip | C8B38337C08B4D4D9AF3385FD731E685A27F9813174D8F021B942FFDD08BB010 |
| newrelic-agent-win-x64-9.8.0.0.msi | 5B247617A1B20D52F7FF9B1A3DA2D31A5DDAC321CA0453115007FE665F8FD231 |
| newrelic-agent-win-x64-9.8.0.0.zip | A5C0731D694EF4DC182D057073351706F642DFF28415341B38219D07F4039B0F |
| newrelic-agent-win-x86-9.8.0.0.msi | FFB556903F65380B21686E229A3E8570C2A673EBCC3A514CC416C868FD9E9CBD |
| newrelic-agent-win-x86-9.8.0.0.zip | CB95C49071E808DC78523D5FF366A2FA0CF2B95B2361F201E4E5A6FAE4470295 |
| newrelic-netcore20-agent-9.8.0.0-1.x86_64.rpm | 537F369DB1F97384C46F11AEF88A6862A0CDFE92327325133AC1FBC0E8D05DA5 |
| newrelic-netcore20-agent-win-9.8.0.0-scriptable-installer.zip | 15C04CFDB251AE0C6CB458EFEAFA8151ED66B361846F87E8DC28EB88AD6E03D8 |
| newrelic-netcore20-agent-win-x64-9.8.0.0.zip | 988A41FA46F9088F51FCC5F33FE97A39128BB9FFEC9F827F8DB13D02905CCE10 |
| newrelic-netcore20-agent-win-x86-9.8.0.0.zip | ABBEE303EAD4C1738E2B724542900321584B9298E552D1626F3BA46FBCA0531E |
| newrelic-netcore20-agent_9.8.0.0_amd64.deb | 3BC8F31BE6F4099C4E5AC82BBF27A701E4E801C02A585E661544278662EDC136 |
| newrelic-netcore20-agent_9.8.0.0_amd64.tar.gz | 214ED65181B717AC556860F77C9987ED07FA21CF53C1865DD74DB41AFD75FAE1 |
| newrelic-netcore20-agent_9.8.0.0_arm64.deb | C32185FF50417C25A4E4C2D4AB50D4C16C8D0CF1607494255E4A88E91FBBA47F |
| newrelic-netcore20-agent_9.8.0.0_arm64.tar.gz | B12C81C412892A002DEB40B17949212AA6EA7FC109225380EE0FF5AA12520EEF |
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.28.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.