.NETエージェントのインストールリソース

スクリプト可能なインストーラーを使用して.NETFrameworkアプリの.NETエージェントをインストールするには：

1. Windows管理者グループの管理者権限があることを確認してください。詳細については、 権限に関するドキュメントを参照してください。

2. ダウンロードサイトから .NET Framework 用のスクリプト可能なインストーラー パッケージをダウンロードします。これらのパッケージのいずれかをダウンロードまたは使用することにより、ライセンス条項に同意し、同意したことになります。

3. パッケージを解凍します。

4. コマンドシェルを開き、解凍されたパッケージのフォルダーに移動します。

5. オプションのない単純なインストールの場合は、次のコマンドを使用します。

   bash

   コピー

   $
   .\install.cmd -LicenseKey YOUR_LICENSE_KEY

   1つ以上の追加オプションを使用してインストールするには、以下の形式を使用してください。インストールオプションの説明については、以下の表を参照してください。

   bash

   コピー

   $
   install.cmd -LicenseKey YOUR_LICENSE_KEY [-NoIISReset] [-InstrumentAll] [-InstallPath PATH_TO_INSTALL]

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

   インストールオプション	説明
   LicenseKey	必須。 あなたの ライセンスキー.
   NoIISReset	オプション。このオプションを使用して、インストーラーがIISリセットを開始しないようにします。 重要 このオプションを使用する場合は、New RelicがIISでホストされているアプリケーションのインスツルメンテーションを開始する前に、IISを手動でリセットする必要があります。
   InstrumentAll	オプション。既定では、.NETエージェントはIISでホストされているすべてのアプリケーションを計測します。このオプションを使用して、他のタイプの.NETアプリケーションのインストルメンテーションを有効にします。
   InstallPath	オプション。このオプションを使用して、別のインストール場所を選択します。デフォルトのインストール場所はC:\Program Files\New Relicです。

   スクリプト可能なアンインストーラーを使用してエージェントをアンインストールします。

   ヒント

   アンインストールスクリプトにForceオプションを追加して、IISの再起動を求めるプロンプトを表示せずに強制的にアンインストールすることができます。

   次のコマンドを実行して、.NET エージェントをアンインストールします。

   bash

   コピー

   $
   .\uninstall.cmd

スクリプト可能なインストーラーを使用して.NETCoreアプリケーション用の.NETエージェントをインストールするには：

1. Windows管理者グループの管理者権限があることを確認してください。詳細については、 権限に関するドキュメントを参照してください。

2. .NET エージェントのダウンロード サイトから .NET エージェントのスクリプト可能なインストーラー パッケージをダウンロードします。これらのパッケージのいずれかをダウンロードまたは使用することにより、ライセンス条項に同意し、同意したことになります。

3. パッケージを目的の場所で解凍します。

4. コマンドシェルを開き、解凍されたパッケージのフォルダーに移動します。

5. エージェントは、ローカルまたはグローバルにインストールできます。

   ローカルインストール

   オプションのない単純なインストールの場合は、次のコマンドを使用します。

   bash

   コピー

   $
   ./installAgent.ps1 -destination PATH -installType global -licenseKey YOUR_LICENSE_KEY \
   >
       [-appName "YOUR_APPLICATION_NAME" -logDir "PATH_TO_CUSTOM_LOG_LOCATION"]

   1つ以上の追加オプションを指定してインストールするには、必要なオプションを指定して同じコマンドを使用します。オプションの説明については、以下の表を参照してください。

   bash

   コピー

   $
   ./installAgent.ps1 -destination PATH -installType local -licenseKey YOUR_LICENSE_KEY \
   >
       [-appName "YOUR_APPLICATION_NAME" -logDir "PATH_TO_CUSTOM_LOG_LOCATION" -X86 -ResetIIS -Force]

   グローバルインストール

   重要

   グローバルインストールは、システム上のすべての.NETCoreプロセスを計測します。すべての.NETCoreプロセスを監視する場合にのみ、グローバルインストールを選択してください。

   オプションのない単純なインストールの場合は、次のコマンドを使用します。

   bash

   コピー

   $
   ./installAgent.ps1 -destination PATH -installType global -licenseKey YOUR_LICENSE_KEY \
   >
       [-appName "YOUR_APPLICATION_NAME" -logDir "PATH_TO_CUSTOM_LOG_LOCATION"]

   1つ以上の追加オプションを指定してインストールするには、必要なオプションを指定して同じコマンドを使用します。オプションの説明については、以下の表を参照してください。

   bash

   コピー

   $
   ./installAgent.ps1 -destination PATH -installType local -licenseKey YOUR_LICENSE_KEY \
   >
       [-appName "YOUR_APPLICATION_NAME" -logDir "PATH_TO_CUSTOM_LOG_LOCATION" -X86 -ResetIIS -Force]

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

   インストールオプション	説明
   Destination	必須。エージェントがインストールされている場所。これは、絶対パスまたは相対パスにすることができます。引用符のラッピングが必要です。
   InstallType	必須。これがローカル (アプリ固有) またはグローバル (システム全体) のどちらのインストールであるかを決定します。
   LicenseKey	必須。 あなたの ライセンスキー.
   AppName	オプション。エージェントのインストールに関連付けられているデフォルトのアプリケーション名を設定します。
   LogDir	オプション。エージェントのカスタムログの場所を設定します。デフォルトでは、エージェントはログディレクトリをインストールディレクトリに配置します。
   X86	オプション。 64ビットバージョンではなく、32ビットバージョンのエージェントをインストールします。 New Relicは、32ビットバージョンのエージェントをグローバルにインストールすることを推奨していません。
   ResetIIS	オプション。インストール後にiisresetを実行します。 重要 これは、.NETCoreアプリがIISリバースプロキシを介してホストされている場合にのみ使用してください。
   Force	オプション。インストールプロセスに、以前のインストールを上書きするか、既存のフォルダーにインストールするように強制します。 注意 これにより、構成のカスタマイズが上書きされます。 New Relicは、オーバーインストールを強制する前に、構成ファイルとカスタムインストルメンテーションファイルをバックアップすることをお勧めします。
   Help	オプション。このスクリプトの使用情報を表示します。