Released 2024-Jun-18
Released 2024-May-23
- Breaking change The
Enrich
callback option has been removed. For better usability, it has been replaced by three separate options:EnrichWithHttpRequest
,EnrichWithHttpResponse
andEnrichWithException
. Previously, the singleEnrich
callback required the consumer to detect which event triggered the callback to be invoked (e.g., request start, response end, or an exception) and then cast the object received to the appropriate type:HttpRequest
,HttpResponse
, orException
. The separate callbacks make it clear what event triggers them and there is no longer the need to cast the argument to the expected type. (#1824)
Released 2024-Apr-17
- 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 theurl.query
attribute. For example,?key1=value1&key2=value2
becomes?key1=Redacted&key2=Redacted
. You can disable this redaction by setting the environment variableOTEL_DOTNET_EXPERIMENTAL_ASPNET_DISABLE_URL_QUERY_REDACTION
totrue
. (#1656)
Released 2024-Apr-05
- Breaking Change: Renamed
AspNetInstrumentationOptions
toAspNetTraceInstrumentationOptions
. (#1604) - Breaking Change:
server.address
andserver.port
no longer added forhttp.server.request.duration
metric. (#1606) - Breaking change Spans names and attributes
will be set as per HTTP semantic convention v1.24.0:
- span names follows:
{HTTP method} [route name if available]
pattern error.type
added when exception occurred while processing request,http.request.method
replaceshttp.method
,http.request.method_original
added whenhttp.request.method
is not in canonical form,http.response.status_code
replaceshttp.status_code
,network.protocol.version
added with HTTP version value,server.address
andserver.port
replacehttp.host
,url.path
replaceshttp.target
,url.query
added when query url part is not empty,url.scheme
added withhttp
orhttps
value,user_agent.original
replaceshttp.user_agent
. (#1607)
- span names follows:
ActivitySource.Version
is set to NuGet package version. (#1624)
Released 2024-Feb-07
- Fix description for
http.server.request.duration
metric. (#1538)
Released 2023-Dec-20
-
Added enrich functionality to metric instrumentation (#1407).
- New overload of
AddAspNetInstrumentation
now accepts a configuration delegate. - The
Enrich
can be used to add additional metric attributes.
- New overload of
-
BREAKING: HTTP server metrics now follow stable semantic conventions (#1429).
- New metric:
http.server.request.duration
- Unit:
s
(seconds) - Histogram Buckets:
0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
- Unit:
- Old metric:
http.server.duration
- Unit:
ms
(milliseconds) - Histogram Buckets:
0, 5, 10, 25, 50, 75, 100, 250, 500, 750, 1000, 2500, 5000, 7500, 10000
- Unit:
Note that the bucket changes are part of the 1.7.0-rc.1 release of the
OpenTelemetry
SDK.The following metric attributes has been added:
http.request.method
(previouslyhttp.method
)http.response.status_code
(previouslyhttp.status_code
)url.scheme
(previouslyhttp.scheme
)server.address
server.port
network.protocol.version
(1.1
,2
,3
)http.route
- New metric:
Released 2023-Nov-06
- Fixed an issue that caused
http.server.duration
metric value to always be set to0
. The issue exists in1.6.0-beta.1
version. (#1425)
Released 2023-Oct-11
-
Updated
OpenTelemetry.Instrumentation.AspNet.TelemetryHttpModule
dependency to1.6.0-beta.1
which brings in the following changes.:
Released 2023-Jun-09
- Release together with
OpenTelemetry.Instrumentation.AspNet.TelemetryHttpModule
due to updateOpenTelemetry.Api
to1.5.0
. (#1220)
Released 2023-Feb-27
- Removes
AddAspNetInstrumentation
method with default configure parameter. (#942)
Released 2022-Nov-28
Released 2022-Sep-28
- Migrate to native Activity
Status
andStatusDescription
. (#651)
Released 2022-Jun-21
- From this version onwards, the source code for this package would be hosted in the contrib repo. The source code for this package before this version was hosted on the main repo.
Released 2022-Jun-03
Released 2022-Apr-15
- Removes .NET Framework 4.6.1. The minimum .NET Framework version supported is .NET 4.6.2. (#3190)
Released 2022-Apr-12
Released 2022-Mar-30
-
Added ASP.NET metrics instrumentation to collect
http.server.duration
. (#2985) -
Fix: Http server span status is now unset for
400
-499
. (#2904)
Released 2022-Mar-04
Released 2022-Feb-02
Released 2021-Oct-08
-
Removes .NET Framework 4.5.2, .NET 4.6 support. The minimum .NET Framework version supported is .NET 4.6.1. (#2138)
-
Replaced
http.path
tag on activity withhttp.target
. (#2266) -
ASP.NET instrumentation now uses OpenTelemetry.Instrumentation.AspNet.TelemetryHttpModule instead of Microsoft.AspNet.TelemetryCorrelation to listen for incoming http requests to the process. Please see the (Step 2: Modify Web.config)[https://github.com/open-telemetry/opentelemetry-dotnet-contrib/tree/main/src/OpenTelemetry.Instrumentation.AspNet#step-2-modify-webconfig] README section for details on the new HttpModule definition required. (#2222)
-
Added
RecordException
option. Specifytrue
to have unhandled exception details automatically captured on spans. (#2256)
Released 2021-Jul-12
Released 2021-Jun-25
Released 2021-Jun-09
Released 2021-Apr-23
- Sanitize
http.url
attribute. (#1961)
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. (#1903)
Released 2021-Jan-29
Released 2020-Nov-17
- AspNetInstrumentation sets ActivitySource to activities created outside ActivitySource. (#1515)
Released 2020-Nov-5
- Renamed TextMapPropagator to TraceContextPropagator, CompositePropagator to CompositeTextMapPropagator. IPropagator is renamed to TextMapPropagator and changed from interface to abstract class. (#1427)
- Propagators.DefaultTextMapPropagator will be used as the default Propagator. (#1427)
- Removed Propagator from Instrumentation Options. Instrumentation now always respect the Propagator.DefaultTextMapPropagator. (#1448)
Released 2020-Oct-16
- Instrumentation no longer store raw objects like
HttpRequest
in Activity.CustomProperty. To enrich activity, use the Enrich action on the instrumentation. (#1261) - Span Status is populated as per new spec (#1313)
Released 2020-Sep-15
Released 2020-08-28
-
Added Filter public API on AspNetInstrumentationOptions to allow filtering of instrumentation based on HttpContext.
-
Asp.Net Instrumentation automatically populates HttpRequest, HttpResponse in Activity custom property
-
Changed the default propagation to support W3C Baggage (#1048)
- The default ITextFormat is now
CompositePropagator(TraceContextFormat, BaggageFormat)
. Baggage sent via the W3C Baggage header will now be parsed and set on incoming Http spans.
- The default ITextFormat is now
-
Renamed
ITextPropagator
toIPropagator
(#1190)
Released 2020-07-24
- First beta release
Released 2020-07-23
- Initial release