NuGetによる.NETエージェントのインストール

このドキュメントでは、NuGetを使用して.NETエージェントをインストールする方法を説明します。

NuGetによるエージェントのインストール

NewRelic.Agent NuGet パッケージ は、New Relic エージェントをアプリケーションのビルド出力ディレクトリに配置し、エージェントがアプリケーションと共にデプロイされるようにします。

NuGetを使用してエージェントをインストールする前に、以下の重要なポイントを理解してください。

• 環境変数やディレクトリのパーミッションを設定するには、アプリケーションをデプロイするシステムへのアクセス権が必要です。
• NuGetを使用して既存の.NETエージェントを更新している場合、これにより、以前にnewrelic.configに加えられた変更が上書きされます。変更を保持するには、最初に構成ファイルをプロジェクトの外部に保存し、更新後に復元します。

ここでは、Visual Studioを介してNuGetを使用し、.NETエージェントをインストールする例を紹介します。

1. Visual Studio ソリューションを開くか、 File> New> Project を選択して新しいソリューションを作成します。マルチプロジェクト・ソリューションの場合は、必ず正しいプロジェクトを選択してください（例えば、特定のWebサイト・プロジェクトなど）。

2. Package Managerコンソール を選択して開きます。 Tools> Library Package Manager> Package Managerコンソール.あなたのプロジェクトをデフォルトのプロジェクトとして設定します。

3. パッケージマネージャーのコマンドプロンプトで、 Install-Package NewRelic.Agentと入力し、 Enterキーを押します。プロジェクトをビルドすると、.NETエージェントフォルダーがビルド出力ディレクトリにコピーされます。

4. 環境変数の設定（下記）、その他必要な設定を行います。その方法は、お使いの環境やシステムによって異なります。

   .NET Frameworkアプリケーションを監視するための環境変数

   COR_ENABLE_PROFILING=1
   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

   の ライセンスキーアプリ名は必須の環境変数ではありません。 他の方法で設定できます。

   Windowsで.NET Coreアプリケーションを監視するための環境変数

   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

   の ライセンスキーアプリ名は必須の環境変数ではありません。 他の方法で設定できます。

   Linuxで.NET Coreアプリケーションを監視するための環境変数

   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 エージェントの環境変数について」を参照してください。

アプリケーションがトラフィックを受信している場合、データは数分以内に表示されます。そうでない場合は、「データが表示されない」を参照してください。