OpenTelemetry.Instrumentation.AspNetCore

Released 2026-Jun-24

• Avoid duplicative work to add tags to traces when they are already natively supported by ASP.NET Core itself. When using ASP.NET Core 10, performance can be improved by setting the Microsoft.AspNetCore.Hosting.SuppressActivityOpenTelemetryData AppContext switch to false (its default value is true). (#3993)

• Add instrumentation schema URL to traces for netstandard2.0. (#4066)

• Fix enrich methods being called multiple times. (#4015)

• Updated OpenTelemetry core component version(s) to 1.16.0. (#4487)

• Add support for version 1.41.0 of the Semantic Conventions for RPC/gRPC. (#4370)

• Update Semantic Conventions for RPC/gRPC to version 1.42.0. (#4508)

• Fixed gRPC attributes being missing from the exported span when a sibling activity is created because a non-default propagator (e.g. a custom or composite propagator) is configured. (#4508)

Released 2026-Apr-21

• The value of the http.route attribute is now aligned with ASP.NET Core itself. (#3992)

• Fix http.route for the root path for Razor Pages. (#4016)

• Updated OpenTelemetry core component version(s) to 1.15.3. (#4166)

Released 2026-Mar-11

• Breaking Change: For gRPC server spans, span status is now follow the OpenTelemetry Semantic Conventions. Only the following gRPC status codes set span status to Error: UNKNOWN, DEADLINE_EXCEEDED, UNIMPLEMENTED, INTERNAL, UNAVAILABLE, and DATA_LOSS. Previously, all non-OK status codes were treated as errors. (#3902)

Released 2026-Jan-21

• Updated OpenTelemetry core component version(s) to 1.15.0. (#3721)

Released 2025-Nov-13

• Update .NET 10.0 NuGet package versions from 10.0.0-rc.2.25502.107 to 10.0.0. (#3403)

• Updated OpenTelemetry core component version(s) to 1.14.0. (#3403)

Released 2025-Oct-22

• Added support for listening to ASP.NET Core Blazor activities. Configurable with the AspNetCoreTraceInstrumentationOptions.EnableRazorComponentsSupport option which defaults to true. Only applies to .NET 10.0 or greater. (#3012)

• Following metrics will now be enabled by default when targeting .NET10.0 or newer framework:

  • Meter : Microsoft.AspNetCore.MemoryPool
    • aspnetcore.memory_pool.pooled
    • aspnetcore.memory_pool.evicted
    • aspnetcore.memory_pool.allocated
    • aspnetcore.memory_pool.rented
  • Meter : Microsoft.AspNetCore.Authentication
    • aspnetcore.authentication.authenticate.duration
    • aspnetcore.authentication.challenges
    • aspnetcore.authentication.forbids
    • aspnetcore.authentication.sign_ins
    • aspnetcore.authentication.sign_outs
  • Meter : Microsoft.AspNetCore.Authorization
    • aspnetcore.authorization.attempts
  • Meter : Microsoft.AspNetCore.Identity
    • aspnetcore.identity.user.create.duration
    • aspnetcore.identity.user.update.duration
    • aspnetcore.identity.user.delete.duration
    • aspnetcore.identity.user.check_password_attempts
    • aspnetcore.identity.user.generated_tokens
    • aspnetcore.identity.user.verify_token_attempts
    • aspnetcore.identity.sign_in.authenticate.duration
    • aspnetcore.identity.sign_in.check_password_attempts
    • aspnetcore.identity.sign_in.sign_ins
    • aspnetcore.identity.sign_in.sign_outs
    • aspnetcore.identity.sign_in.two_factor_clients_remembered
    • aspnetcore.identity.sign_in.two_factor_clients_forgotten
  • Meter : Microsoft.AspNetCore.Components
    • aspnetcore.components.navigate
    • aspnetcore.components.handle_event.duration
  • Meter : Microsoft.AspNetCore.Components.Lifecycle
    • aspnetcore.components.update_parameters.duration
    • aspnetcore.components.render_diff.duration
    • aspnetcore.components.render_diff.size
  • Meter : Microsoft.AspNetCore.Components.Server.Circuits
    • aspnetcore.components.circuit.active
    • aspnetcore.components.circuit.connected
    • aspnetcore.components.circuit.duration

  For details about each individual metric check ASP.NET Core docs page. (#3012)

• Updated OpenTelemetry core component version(s) to 1.13.1. (#3218)

Released 2025-May-05

• Updated OpenTelemetry core component version(s) to 1.12.0. (#2725)

Released 2025-Mar-05

• Added support for listening to ASP.NET Core SignalR activities. Configurable with the AspNetCoreTraceInstrumentationOptions.EnableAspNetCoreSignalRSupport option which defaults to true. Only applies to .NET 9.0 or greater. (#2539)

• Updated OpenTelemetry core component version(s) to 1.11.2. (#2582)

Released 2025-Jan-27

• The http.server.request.duration histogram (measured in seconds) produced by the metrics instrumentation in this package now uses the Advice API to set default explicit buckets following the OpenTelemetry Specification. (#2430)

• Updated OpenTelemetry core component version(s) to 1.11.1. (#2477)

Released 2024-Dec-10

• Metric support for the .NET Standard target was removed by mistake in 1.10.0. This functionality has been restored. (#2403)

Released 2024-Dec-09

• Drop support for .NET 6 as this target is no longer supported. (#2138)

• Updated OpenTelemetry core component version(s) to 1.10.0. (#2317)

Released 2024-Jun-17

• Updated OpenTelemetry core component version(s) to 1.9.0. (#1888)

Released 2024-Apr-12

• Breaking Change: Fixed tracing instrumentation so that by default any values detected in the query string component of requests are replaced with the text Redacted when building the url.query tag. For example, ?key1=value1&key2=value2 becomes ?key1=Redacted&key2=Redacted. You can disable this redaction by setting the environment variable OTEL_DOTNET_EXPERIMENTAL_ASPNETCORE_DISABLE_URL_QUERY_REDACTION to true. (#5532)

Released 2024-Apr-04

• Fixed an issue for spans when server.port attribute was not set with server.address when it has default values (80 for HTTP and 443 for HTTPS protocol). (#5419)

• Fixed an issue where the http.request.method_original attribute was not set on activity. Now, when http.request.method is set and the original method is converted to its canonical form (e.g., Get is converted to GET), the original value Get will be stored in http.request.method_original. (#5471)

• Fixed the name of spans that have http.request.method attribute set to _OTHER. The span name will be set as HTTP {http.route} as per the specification. (#5484)

Released 2024-Feb-09

• Fixed issue #4466 where the activity instance returned by Activity.Current was different than instance obtained from IHttpActivityFeature.Activity. (#5136)

• Fixed an issue where the http.route attribute was not set on either the Activity or http.server.request.duration metric generated from a request when an exception handling middleware is invoked. One caveat is that this fix does not address the problem for the http.server.request.duration metric when running ASP.NET Core 8. ASP.NET Core 8 contains an equivalent fix which should ship in version 8.0.2 (see: dotnet/aspnetcore#52652). (#5135)

• Fixes scenario when the net6.0 target of this library is loaded into a .NET 7+ process and the instrumentation does not behave as expected. This is an unusual scenario that does not affect users consuming this package normally. This fix is primarily to support the opentelemetry-dotnet-instrumentation project. (#5252)

Released 2023-Dec-13

Released 2023-Dec-13

• Re-introduced support for gRPC instrumentation as an opt-in experimental feature. From now onwards, gRPC can be enabled by setting OTEL_DOTNET_EXPERIMENTAL_ASPNETCORE_ENABLE_GRPC_INSTRUMENTATION flag to True. OTEL_DOTNET_EXPERIMENTAL_ASPNETCORE_ENABLE_GRPC_INSTRUMENTATION can be set as an environment variable or via IConfiguration. The change is introduced in order to support stable release of http instrumentation. Semantic conventions for RPC is still experimental and hence the package will only support it as an opt-in experimental feature. Note that the support was removed in 1.6.0-rc.1 version of the package and versions released before 1.6.0-rc.1 had gRPC instrumentation enabled by default. (#5130)

Released 2022-Feb-02

Released 2021-Oct-08

• Replaced http.path tag on activity with http.target. (#2266)

Released 2021-Jul-12

Released 2021-Jun-25

Released 2021-Jun-09

• Fixes bug #1740: Instrumentation.AspNetCore for gRPC services omits ALL rpc.* attributes under certain conditions (#1879)

Released 2021-Apr-23

• When using OpenTelemetry.Extensions.Hosting you can now bind AspNetCoreInstrumentationOptions from DI. (#1997)

Released 2021-Mar-19

• Leverages added AddLegacySource API from OpenTelemetry SDK to trigger Samplers and ActivityProcessors. Samplers, ActivityProcessor.OnStart will now get the Activity before any enrichment done by the instrumentation. (#1836)

• Performance optimization by leveraging sampling decision and short circuiting activity enrichment. Filter and Enrich are now only called if activity.IsAllDataRequested is true (#1899)

Released 2021-Jan-29

Released 2022-Mar-04