Windows用.NETエージェントのインストール

このドキュメントでは、Windowsシステム上にAPM .NETエージェントをインストールし、有効化する方法について説明します。

インストールの概要

本ドキュメント内のインストール手順は、Windowsへの標準的な.NETエージェントのインストールを対象としています。ただし、以下の一部の設定には特定の警告と手順があるため、最初に読んでください。

• ASP.NET Core
• Azureのインストール
• NuGetのインストール
• Dockerコンテナのインストール
• Windows Communication Foundation（WCF）
• IISでホスティングされていないアプリ

.NETエージェントの最新バージョンは.NET Framework 4.5以上をサポートしています。モニターするレガシーアプリケーションがある場合は、.NET Frameworkバージョン以下のサポートを参照してください。

ガイド付きインストールによるIISアプリケーションのエージェントのインストール

ガイド付きインストールは、Windows IISアプリケーション用の.NETエージェントをダウンロードおよびインストールする環境用の、カスタマイズされたCLIコマンドを作成します。

始める準備はできていますか？ガイド付きインストールボタンをクリックします。アカウントがデータをEUデータセンターでレポートする場合は、EUガイド付きインストールをクリックします。

.NETエージェントに加え、CLIを使用してインフラストラクチャエージェントをインストールおよび使用して、環境内で実行中のその他のアプリケーション、インフラストラクチャおよびログソースを発見し、どれをインストゥルメントする必要があるかを推奨できます。インストールすると、インストゥルメントするために選択する各システムの設定とデプロイメントは自動化されます。

エージェントのダウンロードおよびインストール

.NETエージェントをインストールする場合は、以下の手順に従います。

1. Windows管理者グループの管理者権限を保有していることを確認します。詳細については、アクセス許可のドキュメントを参照してください。

2. システムアーキテクチャに一致するインストーラをダウンロードします。

   • 64ビット版
   • 32ビット版

3. インストールウィザードを実行します。インストールウィザードを使用する際のヒント:

   • プロンプトが表示されたら、New Relicのライセンスキーを入力します。
   • IISでホスティングされているアプリケーションのみをモニターする場合は、すべてのインストゥルメントを無効化した状態にすることを検討します。そうでない場合は、すべてのインストゥルメントを有効化し、追加手順に従ってアプリケーションのエージェントを有効化します。
   • インストールウィザードを使用して既存のインストレーションを変更する場合は、変更オプションを選択します。
   • オプション: コマンドラインまたはスクリプトからインストーラを実行することもできます。この方法はエージェントのインストールを自動化する場合に便利です。

4. モニターする各アプリケーションに、わかりやすい名前を付けます。アプリ名設定に関する情報については、.NETアプリケーションの命名に関する手順を見直してください。

5. アプリケーションの寿命が短い場合は（存続期間が60秒未満）、設定が必要になります。設定しないと、データはレポートされません。

6. 影響を受けるアプリケーションを再起動します。IISを使用している場合は、IISを再起動します。

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

コマンドラインまたはスクリプトからMSIを実行します。

MSIインストールウィザードを使用する代わりに、コマンドラインまたはスクリプトからMSIを実行できます。この方法はエージェントのインストールを自動化する場合に便利です。

これが、MSIインストーラを使用して新しいエージェントのインストールを実行するコマンドです。（既存のインストレーションを変更する場合は、ADDLOCALコマンドを使用します。）ハイライト表示されたセクションを関連値で置き換えます。

msiexec.exe /i C:\PATH_TO\newrelic-agent-win-x86-VERSION.msi /qb NR_LICENSE_KEY=YOUR_LICENSE_KEY INSTALLLEVEL=1

INSTALLLEVELは1または500:です。

• 1: .NETエージェントがデフォルトオプション（下の表で説明）でインストールされます。アプリケーションがIIS上にホスティングされていない、またはリバースプロキシとしてIISを使用する場合は、オプション50を使用する必要があります。
• 50: エージェントがInstrumentAllNETFrameworkでインストールされ、有効化されます（下で説明）。

INSTALLLEVELプリセットを使用する代わりに、下に示すADDLOCALコマンドでどの機能をインストールするかをカスタマイズできます。これは既存のインストレーションの更新に使用するコマンドでもあります。

msiexec.exe /i C:\PATH_TO\newrelic-agent-win-x86-VERSION.msi /qb NR_LICENSE_KEY=YOUR_LICENSE_KEY ADDLOCAL=OPTION_1, OPTION_2

使用可能オプションは、以下のとおりです。

IISにないアプリのエージェントの有効化

モニターするアプリケーションがIISでホスティングされていない場合は、標準インストール手順に従いますが、さらにそのアプリケーションのエージェントを明示的に有効化する必要があります。エージェントの有効化は、.NET Frameworkと.NET Coreアプリケーションでは異なります。

標準インストール手順に従う際は、すべてのインストゥルメントを有効化することを推奨します。

.NET Frameworkの有効化

アプリケーションのエージェントを、以下の方法のいずれかで有効化します。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <appSettings>
    <add key="NewRelic.AgentEnabled" value="true" />
    <add key="NewRelic.AppName" value="DataServices" />
  </appSettings>

<instrumentation>
    <applications>
      <application name="BusinessLogicServices.exe" />
      <application name="DataServices.exe" />
    </applications>
</instrumentation>

.NET Coreの有効化

.NET Coreの場合は、以下の環境変数を設定してアプリケーションがモニターされるように設定する必要があります。

CORECLR_ENABLE_PROFILING=1

インストゥルメントするアプリケーションごとに環境変数を設定することを推奨します。グローバルに設定する場合は、アプリ以外に.NETプロセスをインストゥルメントできます。