このガイドでは、.NETエージェントの9.xバージョンと10.xバージョン間の主な変更点、アップグレード中に発生する可能性のある問題、およびバージョン9.xに正常に移行する方法について概説します。
主な変更点は以下の通りです。
- .NETエージェントは、サポート終了として指定されたフレームワークをサポートしなくなりました
- 非推奨のスクリプト可能なインストーラーの削除
- 非推奨のインストルメンテーションの削除
- Windowsインストール資産の統合と名前の変更
- Linuxインストーラーパッケージの名前が変更されました
- インストーラーファイル名のバージョン番号が短い
.NETエージェントは、サポート終了として指定されたフレームワークをサポートしなくなりました
Microsoftは、 .NETFramework4.6.1以下および.NETCore3.0以下がサポートの終了に達したと発表しました。古いフレームワークをサポート終了として指定することで、これらのフレームワークの新しいバージョンの改善にリソースを費やすことができます。
サポートされているフレームワークバージョンを使用するようにアプリケーションを移行することをお勧めします。フレームワークの移行が選択できない場合でも、お客様は9.xバージョンの.NETエージェントを使用してアプリケーションをインストルメント化できます。
非推奨のスクリプト可能なインストーラーの削除
v10.x以降、使用率が低いため、ダウンロードサイトからのスクリプト可能なインストーラーの提供を停止します。スクリプト可能なインストーラーを使用して.NETエージェントのインストールプロセスを自動化する場合は、スクリプトでコマンドラインオプションを指定してMSIインストーラーを使用するか、ダウンロードサイトのzipアーカイブ.NETエージェントを使用して独自のインストールスクリプトを作成することを検討してください。
非推奨のインストルメンテーションの削除
v10.x以降、.NETエージェントはCastleMonoRailの計測を停止します。お客様は、古いバージョンの.NETエージェントを引き続き使用して、このライブラリをインストルメント化できます。
Windowsインストール資産の統合と名前の変更
以前のバージョンでは、Windowsに.NETFrameworkおよび.NETCore /.NET5+のエージェントアセットを手動でインストールするための個別のZIPアーカイブを公開していました。これらは、手動のWindowsインストール用に.NETFrameworkと.NETCore / .NET 5+エージェントアセットの両方を含む単一のZIPアーカイブに統合されています（64ビットバージョンと32ビットバージョンの両方が引き続き利用可能です）。これにより、これらの手動ZIPアーカイブは、.NETFrameworkと.NETCore /.NET5+アセットの両方をインストールする既存のMSI自動インストーラーと同様になります。
また、MSIファイルとZIPファイルの名前をすべて同じベースファイル名に変更しました： NewRelicDotNetAgent 。
9.xWindowsインストールアセット名とそれに相当する10.xの表
| 9.xファイル名 | のために使用される | 10.xファイル名 |
|---|---|---|
| newrelic-agent-win-x64-VERSION.msi | .NETFrameworkおよび.NETCore/ .NET（64ビット）の自動インストール | NewRelicDotNetAgent_VERSION_x64.msi |
| newrelic-agent-win-x86-VERSION.msi | .NETFrameworkおよび.NETCore/ .NET（32ビット）の自動インストール | NewRelicDotNetAgent_VERSION_x86.msi |
| newrelic-agent-win-x64-VERSION.zip | .NET Framework専用のエージェントアセットのZIPアーカイブ（64ビット） | NewRelicDotNetAgent_VERSION_x64.zip |
| newrelic-agent-win-x86-VERSION.zip | .NET Framework専用のエージェントアセットのZIPアーカイブ（32ビット） | NewRelicDotNetAgent_VERSION_x86.zip |
| newrelic-netcore20-agent-win-x64-VERSION.zip | .NET Core / .NETのみのエージェントアセットのZIPアーカイブ（64ビット） | NewRelicDotNetAgent_VERSION_x64.zip |
| newrelic-netcore20-agent-win-x86-VERSION.zip | .NET Core / .NETのみのエージェントアセットのZIPアーカイブ（32ビット） | NewRelicDotNetAgent_VERSION_x86.zip |
Linuxインストーラーパッケージの名前が変更されました
v10.x以降、Linux用のエージェントインストールパッケージの名前がnewrelic-netcore20-agentからnewrelic-dotnet-agentに変更されています。リリースされた2.0以降のバージョンの.NETCoreをサポートして以来、名前netcore20は混乱していると感じています。また、エージェントバージョン10.0以降、3.1より古いバージョンの.NETCoreはサポートされなくなりました。
新しいnewrelic-dotnet-agentパッケージは、古いnewrelic-netcore20-agentパッケージと競合して置き換え（DEB）または廃止（RPM）したものとしてマークされます。システムのパッケージマネージャーでは、両方を同時にインストールすることはできません。
newrelic-netcore20-agentからへのアップグレード newrelic-dotnet-agent
重要
アップグレードプロセスにより、 newrelic.configおよびXMLカスタムインストルメンテーションファイルが/usr/local/newrelic-netcore20-agentの以前のエージェントインストールから/usr/local/newrelic-dotnet-agentの新しいインストール場所に移行されます。ログファイルやその他のカスタムデータは自動的に移行されません。
安全のため、次の手順に進む前に、
/usr/local/newrelic-netcore20-agent内のすべてのファイルのバックアップコピーを作成する必要があります。現在監視されている.NETアプリケーションをすべてシャットダウンします。
Linuxシステムに適したパッケージマネージャーの指示に従ってください。
プロファイリング環境変数を更新します。使用する必要がある正確な構成は、特定の変数に基づいて変更されます。
CORECLR_ENABLE_PROFILING="1"CORECLR_PROFILER="{36032161-FFC0-4B61-B559-F6C5D41BAE5A}"CORECLR_NEWRELIC_HOME="/usr/local/newrelic-dotnet-agent"CORECLR_PROFILER_PATH="/usr/local/newrelic-dotnet-agent/libNewRelicProfiler.so"アプリを起動し、データが表示されるのを待ちます。
移行が成功したことを確認したら、次の手順を実行して、前のnewrelic-netcore20-agentインストールから残っているアーティファクトをクリーンアップします。
Debianベース（apt / dpkg）システムを使用している場合：
bash$sudo dpkg -P newrelic-netcore20-agent/usr/local/newrelic-netcore20-agentを削除します（Debianベース（apt / dpkg）とRPMベース（yum / rpm）の両方のシナリオに適用されます）：bash$sudo rm -rf /usr/local/newrelic-netcore20-agent
インストーラーファイル名の短いバージョン番号
New Relic .NETエージェントは、エージェントバージョン8.28.0以降、セマンティックバージョニングを使用しています。SemVerは、メジャー、マイナー、パッチの3つの番号を使用してリリースをバージョン管理します。ただし、インストーラーのファイル名は引き続き4つの数字を使用しており、4番目のバージョン番号は常にゼロです。今後、インストーラーのファイル名にあるバージョン文字列から、この意味のない、混乱を招く可能性のある4番目の数字を削除します。この変更は、WindowsとLinuxの両方のインストーラーファイルに適用されます。