このドキュメントでは、NuGetを使用して.NETエージェントをインストールする方法を説明します。
NuGetによるエージェントのインストール
NewRelic.Agent NuGet パッケージ は、New Relic エージェントをアプリケーションのビルド出力ディレクトリに配置し、エージェントがアプリケーションと共にデプロイされるようにします。
NuGetを使用してエージェントをインストールする前に、以下の重要なポイントを理解してください。
- 環境変数やディレクトリのパーミッションを設定するには、アプリケーションをデプロイするシステムへのアクセス権が必要です。
- NuGetを使用して既存の.NETエージェントを更新している場合、これにより、以前に
newrelic.config
に加えられた変更が上書きされます。変更を保持するには、最初に構成ファイルをプロジェクトの外部に保存し、更新後に復元します。
重要
エージェントのlogs
フォルダーは、アプリケーションのビルド/公開出力ディレクトリにあるnewrelic
フォルダーのサブフォルダーとして作成されます。logs
フォルダーはデフォルトの権限で作成されます。つまり、アプリをビルド/公開したユーザーとは別のユーザーがアプリを実行している場合、エージェントはこのフォルダーを書き込みできない可能性があります。アプリを実行しているユーザーがlogs
フォルダーに書き込めるようにしてください。
ここでは、Visual Studioを介してNuGetを使用し、.NETエージェントをインストールする例を紹介します。
Visual Studio ソリューションを開くか、 File> New> Project を選択して新しいソリューションを作成します。マルチプロジェクト・ソリューションの場合は、必ず正しいプロジェクトを選択してください(例えば、特定のWebサイト・プロジェクトなど)。
Package Managerコンソール を選択して開きます。 Tools> Library Package Manager> Package Managerコンソール.あなたのプロジェクトをデフォルトのプロジェクトとして設定します。
パッケージマネージャーのコマンドプロンプトで、 Install-Package NewRelic.Agent
と入力し、 Enterキーを押します。プロジェクトをビルドすると、.NETエージェントフォルダーがビルド出力ディレクトリにコピーされます。
環境変数の設定(下記)、その他必要な設定を行います。その方法は、お使いの環境やシステムによって異なります。
COR_PROFILER={71DA0A04-7777-4EC6-9643-7D28B46A8A41}
COR_PROFILER_PATH=APP_DEPLOYMENT_DIRECTORY\newrelic\NewRelic.Profiler.dll
NEWRELIC_HOME=APP_DEPLOYMENT_DIRECTORY\newrelic
NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY
NEW_RELIC_APP_NAME=YOUR_APP_NAME
重要
32 ビット アプリケーションを監視するには、 COR_PROFILER_PATH
を次のように設定する必要があります。 APP_DEPLOYMENT_DIRECTORY\newrelic\x86\NewRelic.Profiler.dll
の アプリ名は必須の環境変数ではありません。 他の方法で設定できます。
CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_PROFILER_PATH=APP_DEPLOYMENT_DIRECTORY\newrelic\NewRelic.Profiler.dll
CORECLR_NEWRELIC_HOME=APP_DEPLOYMENT_DIRECTORY\newrelic
NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY
NEW_RELIC_APP_NAME=YOUR_APP_NAME
重要
32 ビット アプリケーションを監視するには、 CORECLR_PROFILER_PATH
を次のように設定する必要があります。 APP_DEPLOYMENT_DIRECTORY\newrelic\x86\NewRelic.Profiler.dll
の アプリ名は必須の環境変数ではありません。 他の方法で設定できます。
CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_PROFILER_PATH=APP_DEPLOYMENT_DIRECTORY/newrelic/libNewRelicProfiler.so
CORECLR_NEWRELIC_HOME=APP_DEPLOYMENT_DIRECTORY/newrelic
NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY
NEW_RELIC_APP_NAME=YOUR_APP_NAME
重要
arm64 システムでアプリケーションを監視するには、 CORECLR_PROFILER_PATH
を次のように設定する必要があります APP_DEPLOYMENT_DIRECTORY/newrelic/linux-arm64/libNewRelicProfiler.so
の アプリ名は必須の環境変数ではありません。 他の方法で設定できます。
これらの変数の詳細、およびその他のインストール シナリオの正しい値については、 「.NET エージェントの環境変数について」を参照してください。
アプリケーションがトラフィックを受信している場合、データは数分以内に表示されます。そうでない場合は、「データが表示されない」を参照してください。