New Relic APM for .NET can monitor both .NET Framework and .NET Core applications. This document gets you started with installing the New Relic .NET agent, and provides links to install instructions.
There are two New Relic APM agents for monitoring .NET applications:
- .NET Framework agent
- .NET Core agent
Optional reading before installing the .NET agent:
- Agent compatibility and requirements: .NET Framework agent | .NET Core agent.
- For a high-level explanation of what happens during a .NET install, read the install overview.
Here are install instructions for common setups. If you use Docker or Azure, read those instructions first.
Hosting platform recommendations:
.NET Framework agent:
.NET Core agent:
If you want to install both agents on the same server, see Install both agents.
Other frameworks, or no framework
If your .NET application uses an application framework that is not automatically instrumented, or if the app has no framework (like a console app), after the install you will need to manually set up instrumentation of your app. This process would look like:
Follow the relevant install and enable instructions:
- Custom instrument your application to define what activity is reported to New Relic.
The install instructions will vary depending on your setup but all .NET agent installations have the same underlying steps. Understanding these basic steps may help you troubleshoot or customize your install.
The basic steps in an install are:
Ensure you have read and write permissions for the directory where the .NET agent will be placed.
The New Relic .NET agent is placed on your system.
Environment variables are set. These tell the .NET runtime to load the Microsoft .NET profiler in your .NET application, which in turn reports performance data to the New Relic agent.
- For .NET Framework (not for Core): applications you want to monitor must also be "targeted.”
For installs on fully supported application frameworks (including IIS), steps 3 and 4 will happen automatically.
Install .NET Framework and .NET Core agents on same system
You can install the .NET Core and Framework agents on the same system, with the following requirements:
- Separate directories: The .NET Core and .NET Framework agents must be installed in different directories.