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:
- Examine everything from a high-level summary of your app, to code-level details such as transaction traces, database queries, and individual errors.
- Get proactive notifications from New Relic's alerting system to ensure your app is up and running smoothly.
- Install New Relic Infrastructure to view the performance of your app's host environment.
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:
- Install the .NET agent: For the self-installer executable, or for "silent" installation via command line.
- Install on Azure: For Azure Cloud Services or Azure Web Sites.
- Upgrade the .NET agent: For upgrading an existing agent. If upgrading from a particularly old agent, see Upgrade legacy agents.
To view agent installation videos, visit learn.newrelic.com.
For a list of new features and bug fixes, see the .NET agent release notes.
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:
- .NET status monitor: An optional utility that monitors your installation, checks for issues, and allows you to view your log file.
- No data appears: Try these steps if you don't see any data in the New Relic UI after installing the agent.
- No event log and CoCreate errors: If you don't see any data, and you see no New Relic event log, you may have a profiler conflict.
- High memory usage with the .NET agent: IF you see increased memory usage after installing the agent.
For more help
Additional documentation resources include: