New Relic's .NET agent monitors your .NET app, giving you an end-to-end view of your app's performance. Once you install the .NET agent, you can:
- Use New Relic APM to examine everything from a high-level overview of your app, to code-level details such as transaction traces, database queries, and individual errors.
- Get proactive notifications from New Relic Alerts to ensure your app is up and running smoothly.
- Install New Relic Infrastructure to view the performance of your app's host environment.
- Depending on your New Relic APM subscription, use New Relic Insights to sample and search your data, run SQL-like queries of your data with New Relic Query Language (NRQL), and visualize your app's data with custom dashboards.
New Relic's .NET Framework agent works with all .NET compatible languages, such as VB.NET, C#, and CLI. The .NET Core 2.0 agent takes advantage of the compatibility, speed, expanded API features, and cross-platform capabilities available as of Microsoft's .NET Core version 2.0. The .NET Core 2.0 agent does not support Microsoft .NET Core versions earlier than 2.0.
With New Relic's .NET Core 2.0 agent, you can easily monitor your apps in dynamic or distributed environments, such as:
- Cloud-managed server VM images
- On-host VM servers
- Microsoft Azure App Services
- Self-hosted Windows and Linux systems
- Amazon AWS EC2 VMs
The .NET Core 2.0 agent instruments Microsoft .NET Core 2.0 or higher processes to monitor apps on both Linux and Windows operating systems, including auto-instrumentation of web and external calls, Kestrel web transactions, and more.
Install the agent
Before you install the .NET agent, create your New Relic account. Then, review the .NET Framework agent system requirements or the .NET Core 2.0 agent system requirements and follow the installation procedures:
- Install the .NET agent on Windows (.NET Core 2.0 and .NET Framework): For the self-installer executable, or for "silent" installation via command line.
- Install the .NET Core 2.0 agent on Linux: For the installer packages and tarballs.
- Install on Azure: For Azure Cloud Services or Azure Web App Services.
- Update the .NET agent: For upgrading an existing .NET Framework or .NET Core 2.0 agent. If upgrading from a particularly old .NET Framework agent, see Upgrade legacy agents.
To stay up to date with new features and bug fixes, see the .NET agent release notes.
After you install the agent and wait a few minutes to generate traffic for your app, data will appear in the New Relic APM Overview page. If no data appears, or if you encounter other problems, see New Relic's .NET troubleshooting procedures.
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 .NET agent, extend the agent's instrumentation further. For example:
Integrate the .NET agent with New Relic Browser to gain visibility into end-user activity.
|Custom instrumentation||Instrument transactions not captured as part of New Relic's automatic framework instrumentation.|
|Agent API||Refer to the .NET agent API guide to learn how 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.|