Install the .NET agent

New Relic supports the most popular .NET application implementations. Once installed, our .NET APM agent monitors your app's performance and gives you insight into that performance. Want more context? See Introduction to APM.

A screenshot of example .NET APM dashboards

Installation options

The New Relic .NET agent has installation options for Linux, Windows, AWS elastic beanstalk, WCF, Nuget, and Azure cloud, web, and service fabric. Select your installation path using the form below for installation instructions based on your environment!

Tell us about your .NET app

Install with NuGet

Here's an example of using NuGet via Visual Studio to install the .NET agent: (You can also find a similar example in our .NET agent samples repository).

  1. Open your Visual Studio solution, or create a new one by selecting File > New > Project. For multi-project solutions, be sure to select the correct project (for example, a specific website project).

  2. Open the Package Manager console by selecting Tools > Library Package Manager > Package Manager Console. Set your project as the default project.

  3. From the Package Manager command prompt, type Install-Package NewRelic.Agent and press Enter. When you build your project, the .NET agent folder will be copied to your build output directory.

  4. Set environment variables (below) and any other necessary configuration. How to do this will vary, depending on your environment and system.

    For more details on these variables, as well as correct values for other installation scenarios, please see understanding .NET agent environment variables.

If your application is receiving traffic, data should appear within a few minutes. If it doesn't, see No data appears.

Did this doc help with your installation?

What's next?


Look for your app data in the UI

Look for your app data on the APM Summary page (it can take a few minutes).

Read the APM docs

For example, read about the Summary page, the Errors page, and the Transactions page.

Still not seeing data?

Follow our troubleshooting steps.