Install the .NET agent

Requires Administrator rights in your Windows admin group. For more information, see User rights.

Follow the instructions in this doc to install the .NET agent and monitor your app. For more information about compatibility and requirements, see Compatibility and requirements for the .NET agent.

Installing on Azure? Follow these Azure-specific installation procedures.

Standard installation

 

[video link] For an overview of the .NET installation process, watch this New Relic video (approximately 3 minutes). View more videos and tutorials at learn.newrelic.com.

To install the .NET agent:

  1. If possible, stop IIS before installing the agent. Otherwise, you will probably need to restart your system to finish the installation.
  2. Download and run the appropriate install package for your architecture:

  3. When prompted, enter your New Relic license key (accessible from the Account settings page).
  4. Change the default application name to a meaningful name.
  5. Restart IIS to complete the installation process.

As long as your app is receiving traffic, data should appear within a few minutes. If not, see No data appears.

Manual installation via command line

You can also install the agent "silently" via the command line. Use the commands below, or put the commands in a script to fully automate your installation:

Manual install with default agent features

Setting INSTALLLEVEL=1 installs the .NET agent with default options:

  1. Download the appropriate install package for your architecture:

  2. Use the command prompt to install the agent, replacing the path to the install package and inserting your license key:

    32-bit:

    msiexec.exe /i C:\Path\To\NewRelicDotNetAgent_x86.msi /qb NR_LICENSE_KEY=LICENSE_KEY INSTALLLEVEL=1

    64-bit:

    msiexec.exe /i C:\Path\To\NewRelicDotNetAgent_x64.msi /qb NR_LICENSE_KEY=LICENSE_KEY INSTALLLEVEL=1
  3. Restart IIS to complete the installation process.
Manual install with all agent features

Setting INSTALLLEVEL=50 installs the .NET agent with all optional packages:

  1. Download the appropriate install package for your architecture:

  2. Use the command prompt to install the agent, replacing the path to the install package and inserting your license key:

    32-bit:

    msiexec.exe /i C:\Path\To\NewRelicDotNetAgent_x86.msi /qb NR_LICENSE_KEY=LICENSE_KEY INSTALLLEVEL=50

    64-bit:

    msiexec.exe /i C:\Path\To\NewRelicDotNetAgent_x64.msi /qb NR_LICENSE_KEY=LICENSE_KEY INSTALLLEVEL=50
  3. Restart IIS to complete the installation process.
Manual install and customize features

You can customize which agent features to install with the ADDLOCAL option:

  1. Download the appropriate install package for your architecture:

  2. Use the command prompt to install the agent, replacing the path to the install package, inserting your license key, and specifying which features you want to install:

    32-bit:

    msiexec.exe /i C:\Path\To\NewRelicDotNetAgent_x86.msi /qb NR_LICENSE_KEY=LICENSE_KEY ADDLOCAL=Option1,Option2,...

    64-bit:

    msiexec.exe /i C:\Path\To\NewRelicDotNetAgent_x64.msi /qb NR_LICENSE_KEY=LICENSE_KEY ADDLOCAL=Option1,Option2,...
  3. Restart IIS to complete the installation process.

For example:

msiexec.exe /i C:\Path\To\NewRelicDotNetAgent_x64.msi /qb NR_LICENSE_KEY=LICENSE_KEY ADDLOCAL=ProgramsFeature,AllAppsEnvironmentFeature,IISRegistryFeature,ToolsShortcutFeature

Features you can select with the ADDLOCAL option include:

ADDLOCAL Additional features
ProductFeature
  • ApiFeature
  • ProgramsFeature (default)
  • AllAppsEnvironmentFeature
  • IISRegistryFeature (default)
ToolsFeature ToolsShortcutFeature (default)

Stop IIS before installing

After installation finishes, the installer may prompt that a restart is required. New Relic recommends you stop IIS before running the installer. Then, you can start IIS when the installer is complete.

Once IIS has restarted, the New Relic agent will monitor all application requests sent through the server. Data should appear in the New Relic user interface 2 to 3 minutes after the first web request.

For more help

Additional documentation resources include:

Join the discussion about .NET monitoring in the New Relic Online Technical Community! The Technical Community is a public platform to discuss and troubleshoot your New Relic toolset.

If you need additional help, get support at support.newrelic.com.