Introduction to New Relic for .NET

New Relic's .NET agent monitors your .NET app, giving you an end-to-end view of your app's performance. It works for all .NET compatible languages, such as VB.NET, C#, and C++/CLI. Once installed, you can:

Compatibility and requirements

Before you install the .NET agent, review the system requirements.

Install the agent

After creating your New Relic account, see the installation instructions:

To view agent installation videos, visit

For a list of new features and bug fixes, see the .NET agent release notes.

APM > (selected app) > Monitoring > Overview: After installing the .NET agent, view a summary of your app's performance.

Configure the agent

The most important part of agent configuration is to give your app a descriptive name. New Relic uses this app name to aggregate metrics when you have multiple apps or hosts. The agent also includes a variety of configuration options to further customize your installation.

Extend your instrumentation

After installing the agent, go further and extend the agent's instrumentation:

  • Browser instrumentation: Integrate the .NET agent with New Relic Browser to gain visibility into end-user activity.
  • Custom instrumentation: Instrument transactions not captured as part of our framework instrumentation.
  • Custom transactions: Instrument non-web apps and asynchronous calls.
  • Agent API: Use the agent API to customize the agent's behavior. For example, you can collect custom metrics, flag an error, or ignore a particular transaction entirely.
  • Agent attributes: Customize the attributes attached to transactions. Customizing attributes allows you to avoid sending sensitive attributes, or to collect additional attributes for deeper visibility into your transactions.

Troubleshoot your installation

If you encounter problems, see New Relic's .NET troubleshooting procedures, including:

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