.NET agent release notesRSS

New Features

• Improved metadata collection for cloud providers. The agent now collects additional metadata when running in AWS, GCP, and Azure. This information is used to provide an enhanced experience when the agent is deployed on those platforms.

Fixes

• Fixed an issue where transactions could be dropped when they included datastore segments and the following exception was logged: NewRelic ERROR: An exception occurred while doing some background work: System.NullReferenceException: Object reference not set to an instance of an object.
• Fixed an issue where SOAP instrumentation would report System.Reflection.TargetInvocationException errors when a more specific error existed. Inner exceptions will now be reported when they exist.

Deprecation Warnings

The follow items are considered deprecated and will be removed with the upcoming 8.x major release:

• Disabling agent HTTPS communication via the service SSL configuration will no longer be allowed starting in 8.x versions of the agent.
• WCF service parameters will no longer be sent as service.request.* attributes starting in 8.x versions of the agent. These parameters will be sent in the form request.parameters.*.

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

• Security Bulletin NR18-04: Fixes issue where error messages were not fully being filtered out of error traces and error events when High-security mode was enabled.

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.

新機能

• モニター対象のアプリケーションを再起動することなく、カスタムインストゥルメンテーションXMLファイルを変更できるようになりました。計装の更新は、実行時に「動的」に適用されます。この機能には、.NET フレームワーク4.5以降で導入された新しいAPIによって提供される機能が必要でしたが、このリリースではこれにも対応しています（以下の「フレームワークサポート」セクションを参照してください）。

修正

• セキュリティ情報 NR18-04：高セキュリティモードが有効になっている場合に、エラーメッセージがエラートレースおよびエラーイベントから完全にフィルタリングされない問題を修正しました。
• スタックオーバーフロー例外を引き起こす可能性のある、自動ブラウザ監視の問題を修正しました。
• カスタムインストゥルメンテーションでは、transactionNamingPriorityを設定しなくても、metricNameパラメーターが適用されます。
• インストレーションファイルへのパスにスペースが含まれている場合でも、スクリプト可能なインストーラが正常にインストールおよびアンインストールされるようになりました。

フレームワークサポート

• このエージェントのリリースでは、バージョン4.5より前の.NET フレームワークバージョンのサポートが削除されています。詳細については、昨年の11月に公開されたこれに関するコミュニティの投稿をご覧ください。
• これは（古い.NETフレームワークをサポートする）6.xエージェントのサポート終了ではありません。引き続き機能し、New Relicに報告します。

アップグレード

• .NET エージェントを更新するには、標準の手順に従ってください。
• 特に古いエージェントからアップグレードする場合は、主な変更点のリストとレガシー.NETエージェントをアップグレードする手順を確認してください。

New Features

• The request URI for a web transaction will now be included as an attribute of transaction events and error events.
• The New Relic .NET Status Monitor has been retired and is no longer included in the install. The replacement tool is New Relic Diagnostics. To download the most recent version, select the link in the New Relic Diagnostics documentation.

Fixes

• Security Bulletin NR17-06: Fixes issue where query parameters were being included in the URL property of transaction trace segments for external calls (uses of System.Net.HttpClient, System.Net.WebRequest, or third-party libraries which are built on top of those). Query parameters will no longer be included in transaction trace segments.
• Transaction names will be rolled up for web transactions resulting in a 400 or 500 level HTTP status code and a higher priority name has not been set. This helps prevent metric grouping issues.
• Fixed error that could result in the one time loss of a metric and/or transaction for an instrumentation point at the start of monitoring an application. "...NewRelic ERROR: Tracer invocation error: System.ArgumentException: An item with the same key has already been added. Key: ..."
• Minor log level adjustments in the profiler logging. Suppresses benign error Failed to tokenize method signature: class System.Reflection.Assembly System.CannotUnloadAppDomainException::LoadAssemblyOrThrow(string)
• [.NET Core 2.0] For .NET Core agent users on Linux, this release fixes a problem with the run.sh convenience script in combination with a custom installation path.
• [.NET Framework] Fixes issue resulting in SerializationExceptions when using .Net Remoting.

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 Relic Agent for .NET Core 2.0 GA

Highlights

• Windows and Linux support, including Azure App Services and Docker
• Automatic instrumentation for ASP.NET Core applications running on Kestrel
• External calls via HttpClient
• Database instrumentation for System.Data.SqlClient, Npgsql, and MySql.Data
• Custom instrumentation via XML and transaction/trace attributes
• NewRelic.Agent.Api support

For a more detailed list, see the compatibility documentation.

The .NET Core 2.0 agent is a separate install and can live side-by-side on the same server as the .NET Framework agent. For installation information, follow the procedures for your operating system as applicable:

• Windows
• Linux
• Docker
• Azure App Services

New Shared Features

• Database instrumentation performance has been improved.
• Explain plans are no longer captured by default for supported database systems: Microsoft SQL Server and MySQL. Explain plans can be enabled via configuration.

Updating the Agent

• 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

• The agent now supports running in FIPS compliance mode.

Fixes

• Fixed an issue that caused some transactions to report start time in the server's local time zone instead of UTC.
• Additional bug fixes to remedy a SerializationException caused by the agent.

Upgrading

• Follow standard procedures to upgrade 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

• Adds support for RestSharp library. The Agent can now instrument async and non-async methods from a RestSharp client. For supported methods, please visit here.
• The application name reported to New Relic APM can now be set by defining the NEW_RELIC_APP_NAME environment variable.

Fixes

• Fixed some situations where SerializationException occurs in the agent log file.
• The injection of Browser Monitor JavaScript directly above the body tag on a page should occur less often.
• Fixes issue where datastore instance information would not be reported for some NpgsqlCommand async calls.
• Fixed remaining cases where 9-digit SQL trace identifiers were generated, failing Data Loss Prevention monitors which interpret the value as a Social Security Number.

Upgrading

• Follow standard procedures to upgrade 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

• Custom instrumentation can now be declared by applying the agent API's new Transaction and Trace attributes to methods. Using the Transaction attribute, transactions can be marked as Web vs. Non-Web. For more information, see Custom instrumentation via attributes.

Fixes

• Fixes bug preventing instrumented apps from shutting down due to Profiler failure to detach.

Upgrading

• Follow standard procedures to upgrade 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.