• EnglishEspañol日本語한국어Português
  • Log inStart now

.NET agent: compatibility and requirements

New Relic's .NET agent supports both .NET Framework and .NET Core. This document describes compatibility and support for .NET runtimes, frameworks and libraries.

The agent includes built-in instrumentation for some of the most popular parts of the .NET ecosystem, including frameworks, databases, and message queuing systems. After you download and install the agent, it runs within the monitored process. The agent doesn't create a separate process or service.

For frameworks and libraries that aren't automatically instrumented, you can extend the agent with .NET custom instrumentation.

Want to try out our .NET agent? Create a New Relic account for free! No credit card required.

Requirements

Before you install the New Relic .NET agent on Windows or Linux, make sure your system meets these requirements:

Automatic instrumentation

If your application is hosted in ASP.NET Core, the agent automatically creates and instruments transactions. The .NET agent automatically instruments your application after install. If your app is not automatically instrumented, or if you want to add instrumentation, use custom instrumentation.

Unavailable features

The following features are not available for the .NET agent:

  • The .NET agent does not support trim self-contained deployments and executables, because the compiler can potentially trim assemblies that the agent depends on.

  • Infinite Tracing is not supported on Alpine Linux due to a GRPC compatibility issue. See this agent issue for more information.

  • The .NET agent doesn't support Native Ahead of Time (AOT) deployment for .NET applications because just-in-time (JIT) compilation is required for the agent to function properly.

    Connect the agent to other New Relic products

    In addition to APM, the .NET agent integrates with other New Relic products to give you end-to-end visibility:

    Product

    Integration

    Browser monitoring

    For ASP.NET Core v6.0 and later web applications (MVC, Razor and Blazor), the .NET agent (starting with version 10.19.0) automatically injects the browser JavaScript agent when you enable auto-instrumentation.

    For other types of web applications, you can inject the agent by using the .NET agent API or the browser agent's copy/paste method.

    After enabling browser injection, you can view browser data in the APM Summary page and quickly switch between the APM and browser data for a particular app. For configuration options and manual instrumentation, see Browser monitoring and the .NET agent.

    Infrastructure monitoring

    When you install the infrastructure and APM agents on the same host, they automatically detect one another. You can then view a list of hosts in the APM UI, and filter your infrastructure hosts by APM app in our infrastructure UI. For more information, see APM data in the infrastructure UI.

    Dashboards

    The .NET agent sends default events and attributes for NRQL queries. You can also record custom events for advanced analysis.

Requirements

Before you install New Relic's .NET agent, make sure your system meets these requirements:

Automatic instrumentation

If your application is hosted in ASP.NET or another fully supported framework, the .NET agent will automatically instrument your application after install. If your app isn't automatically instrumented, or if you want to add instrumentation, use custom instrumentation.

The .NET agent doesn't directly monitor datastore processes. Also, by default the .NET SQL parameter capture in a query trace doesn't list parameters for a parameterized query or a stored procedure. Collection of the SQL query parameters can be enabled in the agent configuration.

Unavailable features

Just-in-time (JIT) compilation is a requirement for .NET agent functionality, so native images created with Native Image Generator (NGEN) aren't supported by the .NET agent.

Connect the agent to other New Relic products

In addition to APM, the agent integrates with other New Relic products to give you end-to-end visibility:

Product

Integration

Browser monitoring

For ASP.NET web applications, the .NET agent automatically injects the browser JavaScript agent when you enable auto-instrumentation.

After enabling browser injection, you can view browser data in the APM Summary page and quickly switch between the and data for a particular app. For configuration options and manual instrumentation, see Browser monitoring and the .NET agent.

Infrastructure monitoring

When you install the infrastructure and APM agents on the same host, they automatically detect one another. You can then view a list of hosts in the APM UI, and filter your hosts by APM app in our infrastructure UI. For more information, see APM data in infrastructure UI.

Dashboards

The .NET agent sends default events and attributes for NRQL queries. You can also record custom events for advanced analysis.

Synthetic monitoring

Synthetic transaction traces connect requests from synthetic monitors to the underlying APM transaction.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.