• English日本語한국어
  • ログイン今すぐ開始

この機械翻訳は参考用に提供されます。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、こちらのページをご覧ください。

問題を作成する

.NETエージェント9.xから10.xへの移行ガイド

このガイドでは、.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の新しいインストール場所に移行されます。ログファイルやその他のカスタムデータは自動的に移行されません

  1. 安全のため、次の手順に進む前に、 /usr/local/newrelic-netcore20-agent内のすべてのファイルのバックアップコピーを作成する必要があります。

  2. 現在監視されている.NETアプリケーションをすべてシャットダウンします。

  3. Linuxシステムに適したパッケージマネージャーの指示に従ってください。

  4. プロファイリング環境変数を更新します。使用する必要がある正確な構成は、特定の変数に基づいて変更されます。

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"
  1. アプリを起動し、データが表示されるのを待ちます。

移行が成功したことを確認したら、次の手順を実行して、前のnewrelic-netcore20-agentインストールから残っているアーティファクトをクリーンアップします。

  1. Debianベース(apt / dpkg)システムを使用している場合:

    bash
    $
    sudo dpkg -P newrelic-netcore20-agent
  2. /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の両方のインストーラーファイルに適用されます。

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.