---
title: Set up ASP.NET Core instrumentation
description: How to set up the Elastic APM .NET Agent to trace ASP.NET Core applications using the AddAllElasticApm extension method.
url: https://www.elastic.co/elastic/docs-builder/docs/3406/reference/apm/agents/dotnet/setup-asp-net-core
products:
  - APM .NET Agent
  - APM Agent
applies_to:
  - Serverless Observability projects: Generally available
  - Elastic Stack: Generally available
  - Application Performance Monitoring Agent for .NET: Generally available
---

# Set up ASP.NET Core instrumentation
## Supported versions


| Framework    | Supported versions |
|--------------|--------------------|
| ASP.NET Core | ≥8.0.0 ≤10.0.x     |

For the full compatibility matrix including supported installation methods, refer to [Web frameworks](/elastic/docs-builder/docs/3406/reference/apm/agents/dotnet/supported-technologies#supported-web-frameworks).

## Quick start

For ASP.NET Core, once you reference the [`Elastic.Apm.NetCoreAll`](https://www.nuget.org/packages/Elastic.Apm.NetCoreAll) package, you can enable every agent component by calling the `AddAllElasticApm()` extension method on the `IServiceCollection` in the `Program.cs` file.
<note>
  The following code sample assumes the instrumentation of an ASP.NET Core 8 application, using [top-level statements](https://learn.microsoft.com/en-us/dotnet/csharp/tutorials/top-level-statements).
</note>

```csharp
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddAllElasticApm();

var app = builder.Build();

// Configure the HTTP request pipeline.

app.Run();
```

With this you enable every agent component including ASP.NET Core tracing, monitoring of outgoing HTTP request, Entity Framework Core database tracing, and so on.
In case you only reference the [`Elastic.Apm.AspNetCore`](https://www.nuget.org/packages/Elastic.Apm.AspNetCore) package, you won’t find the `AddAllElasticApm`. Instead you need to use the `AddElasticApmForAspNetCore()` method. This method turns on ASP.NET Core tracing, and gives you the opportunity to manually turn on other components. By default it will only trace ASP.NET Core requests - No HTTP request tracing, database call tracing or any other tracing component will be turned on.
In case you would like to turn on specific tracing components you can pass those to the `AddElasticApm` method.
For example:
```csharp
using Elastic.Apm.DiagnosticSource;    
using Elastic.Apm.EntityFrameworkCore; 

builder.Services.AddElasticApm(
    new HttpDiagnosticsSubscriber(),  /* Enable tracing of outgoing HTTP requests */
    new EfCoreDiagnosticsSubscriber()); /* Enable tracing of database calls through EF Core*/
```

In case you only want to use the [*Public API*](https://www.elastic.co/elastic/docs-builder/docs/3406/reference/apm/agents/dotnet/public-api), you don’t need to do any initialization, you can start using the API and the agent will send the data to the APM Server.

## Configure the agent

After adding the agent, configure it to connect to your APM Server. The fastest way is through environment variables or `appsettings.json`. See [Minimum configuration](/elastic/docs-builder/docs/3406/reference/apm/agents/dotnet/configuration#minimum-configuration) for the three settings every deployment needs.
To set configuration values programmatically, for example to derive the APM service name or environment from other application configuration, see [Overriding configuration values programmatically](/elastic/docs-builder/docs/3406/reference/apm/agents/dotnet/configuration-on-asp-net-core#asp-net-core-programmatic-config).