Releases: open-telemetry/opentelemetry-dotnet-instrumentation
Releases · open-telemetry/opentelemetry-dotnet-instrumentation
v1.7.0
1.7.0
- Core components:
1.9.0
System.Diagnostics.DiagnosticSource
:8.0.0
Added
- Support for capturing HTTP headers for following traces instrumentations:
- ASP.NET, configurable by
OTEL_DOTNET_AUTO_TRACES_ASPNET_INSTRUMENTATION_CAPTURE_REQUEST_HEADERS
andOTEL_DOTNET_AUTO_TRACES_ASPNET_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS
, - ASP.NET Core, configurable by
OTEL_DOTNET_AUTO_TRACES_ASPNETCORE_INSTRUMENTATION_CAPTURE_REQUEST_HEADERS
andOTEL_DOTNET_AUTO_TRACES_ASPNETCORE_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS
, - HTTP Client, configurable by
OTEL_DOTNET_AUTO_TRACES_HTTP_INSTRUMENTATION_CAPTURE_REQUEST_HEADERS
andOTEL_DOTNET_AUTO_TRACES_HTTP_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS
.
- ASP.NET, configurable by
- Support for capturing gRPC metadata for Grpc.Net.Client traces instrumentation.
It can by configured byOTEL_DOTNET_AUTO_TRACES_GRPCNETCLIENT_INSTRUMENTATION_CAPTURE_REQUEST_METADATA
andOTEL_DOTNET_AUTO_TRACES_GRPCNETCLIENT_INSTRUMENTATION_CAPTURE_RESPONSE_METADATA
. - Support for Oracle.ManagedDataAccess.Core and Oracle.ManagedDataAccess traces instrumentation from 23.4.0 together with support for
OTEL_DOTNET_AUTO_ORACLEMDA_SET_DBSTATEMENT_FOR_TEXT
environment variable. ARM64 platform is not supported. - Add support for NServiceBus 9.x metrics and traces instrumentations.
Changed
- Musl-based (Alpine) libraries are compiled on Alpine v3.19.
- Do not use message creation context as a parent for consumer spans for
Confluent.Kafka
client instrumentation. See the issue for details. - Do not create consumer spans related to
PartitionEOF
events forConfluent.Kafka
client instrumentation. - Following properties can be set before calling plugins:
OpenTelemetry.Instrumentation.AspNetCore.AspNetCoreTraceInstrumentationOptions.EnrichWithHttpRequest
,OpenTelemetry.Instrumentation.AspNetCore.AspNetCoreTraceInstrumentationOptions.EnrichWithHttpResponse
,OpenTelemetry.Instrumentation.AspNet.AspNetTraceInstrumentationOptions.EnrichWithHttpRequest
,OpenTelemetry.Instrumentation.AspNet.AspNetTraceInstrumentationOptions.EnrichWithHttpResponse
,OpenTelemetry.Instrumentation.GrpcNetClient.GrpcClientTraceInstrumentationOptions.EnrichWithHttpRequestMessage
,OpenTelemetry.Instrumentation.GrpcNetClient.GrpcClientTraceInstrumentationOptions.EnrichWithHttpResponseMessage
,OpenTelemetry.Instrumentation.Http.HttpClientTraceInstrumentationOptions.EnrichWithHttpRequestMessage
,OpenTelemetry.Instrumentation.Http.HttpClientTraceInstrumentationOptions.EnrichWithHttpWebRequest
,OpenTelemetry.Instrumentation.Http.HttpClientTraceInstrumentationOptions.EnrichWithHttpResponseMessage
,OpenTelemetry.Instrumentation.Http.HttpClientTraceInstrumentationOptions.EnrichWithHttpWebResponse
.
Dependency updates
- Updated Core components:
1.9.0
. - Following packages updated
OpenTelemetry.Exporter.Prometheus.HttpListener
from1.8.0-rc.1
to1.9.0-beta.1
,OpenTelemetry.Instrumentation.GrpcNetClient
from1.8.0-beta.1
to1.9.0-beta.1
,OpenTelemetry.Instrumentation.Http
from1.8.1
to1.9.0
,OpenTelemetry.Instrumentation.Process
from0.5.0-beta.5
to0.5.0-beta.6
,OpenTelemetry.Instrumentation.Quartz
from1.0.0-beta.2
to1.0.0-beta.3
,OpenTelemetry.Instrumentation.Runtime
from1.8.0
to1.9.0
,OpenTelemetry.Instrumentation.SqlClient
from1.8.0-beta.1
to1.9.0-beta.1
,OpenTelemetry.Instrumentation.StackExchangeRedis
from1.0.0-rc9.14
to1.0.0-rc9.15
,OpenTelemetry.Instrumentation.Wcf
from1.0.0-rc.16
to1.0.0-rc.17
,OpenTelemetry.Shims.OpenTracing
from1.7.0-beta.1
to1.9.0-beta.1
,OpenTelemetry.Resources.Azure
from1.0.0-beta.7
to1.0.0-beta.8
,OpenTelemetry.Resources.Host
from0.1.0-beta.1
to0.1.0-beta.2
.OpenTelemetry.Resources.Process
from0.1.0-beta.1
to0.1.0-beta.2
.OpenTelemetry.Resources.ProcessRuntime
from0.1.0-beta.1
to0.1.0-beta.2
.
- .NET only, following packages updated
OpenTelemetry.Instrumentation.AspNetCore
from1.8.1
to1.9.0
,OpenTelemetry.Instrumentation.EntityFrameworkCore
from1.0.0-beta.11
to1.0.0-beta.12
,OpenTelemetry.Resources.Container
from1.0.0-beta.7
to1.0.0-beta.9
.
- .NET Framework only, following packages updated
OpenTelemetry.Instrumentation.AspNet
from1.8.0-beta.2
to1.9.0-beta.1
.
Deprecated
- Support for macOS Big Sur 11 x64. All further releases will be supporting macOS Monterey 12 x64 and newer.
v1.6.0
1.6.0
- Core components:
1.8.1
System.Diagnostics.DiagnosticSource
:8.0.0
Changed
- To prevent sensitive information from leaking through query strings, the following instrumentations redact by default any value detected in query string components when building the
url.query
or theurl.full
attributes:OpenTelemetry.Instrumentation.Http
,OpenTelemetry.Instrumentation.AspNetCore
,OpenTelemetry.Instrumentation.AspNet
. For example,?key1=value1&key2=value2
becomes?key1=Redacted&key2=Redacted
. You can customize this behavior through the environment variables. See the instrumentation options table for details.
Dependency updates
- Following packages updated
OpenTelemetry.Instrumentation.Http
from1.8.0
to1.8.1
.
- .NET only, following packages updated
Microsoft.Extensions.Configuration.Binder
from8.0.0
to8.0.1
,OpenTelemetry.Instrumentation.AspNetCore
from1.8.0
to1.8.1
.
- .NET Framework only, following packages updated
OpenTelemetry.Instrumentation.AspNet
from1.8.0-beta.1
to1.8.0-beta.2
.
Fixed
- Stop creating
receive
consumer spans for consume attempts that returned no message. For details, see #3367
v1.5.0
1.5.0
- Core components:
1.8.0
System.Diagnostics.DiagnosticSource
:8.0.0
Added
- .NET only, warning in logs about End of Support date and upcoming End of Support date for .NET version.
- Experimental support for ARM64 on Ubuntu, Alpine and Debian based images.
- Experimental ARM64 support for the
OpenTelemetry.AutoInstrumentation
NuGet package.
Changed
- Changed supported method parameters for plugins
- from
OpenTelemetry.Instrumentation.AspNet.AspNetInstrumentationOptions
toOpenTelemetry.Instrumentation.AspNet.AspNetTraceInstrumentationOptions
.
- from
Dependency updates
- Updated Core components:
1.8.0
. - Following packages updated
MongoDB.Driver.Core.Extensions.DiagnosticSources
from1.3.0
to1.4.0
.OpenTelemetry.Exporter.Prometheus.HttpListener
from1.7.0-rc.1
to1.8.0-rc.1
,OpenTelemetry.Instrumentation.Http
from1.7.1
to1.8.0
,OpenTelemetry.Instrumentation.Process
from0.5.0-beta.4
to0.5.0-beta.5
,OpenTelemetry.Instrumentation.Quartz
from1.0.0-beta.1
to1.0.0-beta.2
,OpenTelemetry.Instrumentation.Runtime
from1.7.0
to1.8.0
,OpenTelemetry.Instrumentation.SqlClient
from1.7.0-beta.1
to1.8.0-beta.1
,OpenTelemetry.Instrumentation.StackExchangeRedis
from1.0.0-rc9.13
to1.0.0-rc9.14
,OpenTelemetry.Instrumentation.Wcf
from1.0.0-rc.15
to1.0.0-rc.16
,OpenTelemetry.ResourceDetectors.Azure
from1.0.0-beta.5
to1.0.0-beta.6
,OpenTelemetry.ResourceDetectors.Host
from0.1.0-alpha.2
to0.1.0-alpha.3
.OpenTelemetry.ResourceDetectors.Process
from0.1.0-alpha.2
to0.1.0-alpha.3
.OpenTelemetry.ResourceDetectors.ProcessRuntime
from0.1.0-alpha.2
to0.1.0-alpha.3
.
- .NET only, following packages updated
OpenTelemetry.Instrumentation.AspNetCore
from1.7.1
to1.8.0
,OpenTelemetry.Instrumentation.EntityFrameworkCore
from1.0.0-beta.10
to1.0.0-beta.11
,OpenTelemetry.ResourceDetectors.Container
from1.0.0-beta.6
to1.0.0-beta.7
.
- .NET Framework only, following packages updated
Google.Protobuf
updated from3.25.2
to3.26.1
,Grpc.Core.Api
from2.60.0
to2.62.0
,Microsoft.Extensions.DependencyInjection.Abstractions
from8.0.0
to8.0.1
,Microsoft.Extensions.Options
from8.0.1
to8.0.2
,Microsoft.Extensions.Logging.Abstractions
from8.0.0
to8.0.1
,OpenTelemetry.Instrumentation.AspNet
from1.7.0-beta.2
to1.8.0-beta.1
,System.Text.Json
from8.0.1
to8.0.3
.
Fixed
- Resolved a crash issue caused by
System.IO.FileLoadException
for
Microsoft.Extensions*.dll
libraries. This issue was due to a conflict with
runtime store libraries, impacting applications with mismatched dependency
versions. This fix enhances stability by addressing the underlying
compatibility concerns. For details see:
(#3075,
#3075)
v1.4.0
1.4.0
Added
- Support for
OTEL_DOTNET_AUTO_SQLCLIENT_SET_DBSTATEMENT_FOR_TEXT
andOTEL_DOTNET_AUTO_ENTITYFRAMEWORKCORE_SET_DBSTATEMENT_FOR_TEXT
environment variables which controls whether thedb.statement
attribute is set for SQL statements for SQL Client and Entity Framework Core instrumentations. The default value for both environment variables isfalse
due to the risk of leaking sensitive information in the collected database queries.
Changed
- Changed supported method parameters for plugins
- from
OpenTelemetry.Instrumentation.GrpcNetClient.GrpcClientInstrumentationOptions
toOpenTelemetry.Instrumentation.GrpcNetClient.GrpcClientTraceInstrumentationOptions
, - from
OpenTelemetry.Instrumentation.SqlClient.SqlClientInstrumentationOptions
toOpenTelemetry.Instrumentation.SqlClient.SqlClientTraceInstrumentationOptions
.
- from
Dependency updates
- Following packages updated
OpenTelemetry.ResourceDetectors.Azure
from1.0.0-beta.4
to1.0.0-beta.5
,OpenTelemetry.ResourceDetectors.Container
from1.0.0-beta.5
to1.0.0-beta.6
.OpenTelemetry.Instrumentation.Http
from1.7.0
to1.7.1
,OpenTelemetry.Instrumentation.SqlClient
from1.6.0-beta.3
to1.7.0-beta.1
,OpenTelemetry.Instrumentation.Wcf
from1.0.0-rc.14
to1.0.0-rc.15
,
- .NET only, following packages updated
OpenTelemetry.Instrumentation.AspNetCore
from1.7.0
to1.7.1
,OpenTelemetry.Instrumentation.EntityFrameworkCore
from1.0.0-beta.9
to1.0.0-beta.10
,OpenTelemetry.Instrumentation.GrpcNetClient
from1.6.0-beta.3
to1.7.0-beta.1
.
- .NET Framework only, following packages updated
OpenTelemetry.Instrumentation.AspNet
from1.7.0-beta.1
to1.7.0-beta.2
.
Removed
- Container resource detector will be not executed on .NET Framework. It was not giving any results before changes.
Fixed
- Fix ASP.NET Core traces instrumentation for .NET7. It is now using native support by
Microsoft.AspNetCore
instead ofOpenTelemetry.Instrumentation.AspNetCore
.
v1.3.0
1.3.0
- Core components:
1.7.0
System.Diagnostics.DiagnosticSource
:8.0.0
Added
- Support for Host, Process, and Process Runtime resource detectors.
- Support for
OpenTelemetry.Instrumentation.AspNet.AspNetMetricsInstrumentationOptions
for plugins. - Support for Confluent.Kafka traces instrumentation from 1.4.0 to 3.0.0 (excluding).
Changed
- Changed minimal supported version of
Microsoft.Extensions.Logging
forILOGGER
instrumentation from6.0.0
to8.0.0
. - Changed supported method parameters for plugins
- from
OpenTelemetry.Instrumentation.AspNetCore.AspNetCoreInstrumentationOptions
toOpenTelemetry.Instrumentation.AspNetCore.AspNetCoreTraceInstrumentationOptions
, - from
OpenTelemetry.Instrumentation.Http.HttpClientInstrumentationOptions
toOpenTelemetry.Instrumentation.Http.HttpClientTraceInstrumentationOptions
.
- from
Dependency updates
- Updated Core components:
1.7.0
. - Following packages updated
OpenTelemetry.Exporter.Prometheus.HttpListener
from1.6.0-rc.1
to1.7.0-rc.1
,OpenTelemetry.Instrumentation.Http
from1.6.0
to1.7.0
,OpenTelemetry.Instrumentation.Process
from0.5.0-beta.3
to0.5.0-beta.4
,OpenTelemetry.Instrumentation.Quartz
from1.0.0-alpha.3
to1.0.0-beta.1
,OpenTelemetry.Instrumentation.Runtime
from1.5.1
to1.7.0
,OpenTelemetry.Instrumentation.SqlClient
from1.6.0-beta.2
to1.6.0-beta.3
,OpenTelemetry.Instrumentation.StackExchangeRedis
from1.0.0-rc9.12
to1.0.0-rc9.13
,OpenTelemetry.Instrumentation.Wcf
from1.0.0-rc.13
to1.0.0-rc.14
,OpenTelemetry.Shims.OpenTracing
from1.6.0-beta.1
to1.7.0-beta.1
,OpenTelemetry.ResourceDetectors.Azure
from1.0.0-beta.3
to1.0.0-beta.4
,OpenTelemetry.ResourceDetectors.Container
from1.0.0-beta.4
to1.0.0-beta.5
,OpenTelemetry.ResourceDetectors.ProcessRuntime
from0.1.0-alpha.1
to0.1.0-alpha.2
.
- .NET only, following packages updated
Google.Protobuf
updated from3.19.4
to3.22.5
.Microsoft.Extensions.Configuration
from3.1.0
to8.0.0
,Microsoft.Extensions.Configuration.Abstractions
from3.1.0
to8.0.0
,Microsoft.Extensions.Configuration.Binder
from3.1.0
to8.0.0
,Microsoft.Extensions.DependencyInjection
from3.1.0
to8.0.0
,Microsoft.Extensions.DependencyInjection.Abstractions
from3.1.0
to8.0.0
,Microsoft.Extensions.Logging
from6.0.0
to8.0.0
,Microsoft.Extensions.Options
from3.1.0
to8.0.0
,Microsoft.Extensions.Options.ConfigurationExtensions
from3.1.0
to8.0.0
,Microsoft.Extensions.Primitives
from3.1.0
to8.0.0
,OpenTelemetry.Instrumentation.AspNetCore
from1.6.0-beta.3
to1.7.0
,OpenTelemetry.Instrumentation.EntityFrameworkCore
from1.0.0-beta.8
to1.0.0-beta.9
.
- .NET Framework only, following packages updated
Google.Protobuf
updated from3.25.1
to3.25.2
,Grpc.Core.Api
from2.59.0
to2.60.0
,Microsoft.Extensions.Configuration.Binder
from8.0.0
to8.0.1
,Microsoft.Extensions.Options
from8.0.0
to8.0.1
,OpenTelemetry.Instrumentation.AspNet
from1.6.0-beta.2
to1.7.0-beta.1
,System.Text.Json
from8.0.0
to8.0.1
.
Removed
Removed support for Microsoft.Extensions.Logging
for ILOGGER
for versions older than 8.0.0
.
Fixed
- Set
service.name
resource attribute before invoking the plugin.
v1.2.0
1.2.0
- Core components:
1.6.0
System.Diagnostics.DiagnosticSource
:8.0.0
Added
- Add support for .NET 8.
- Added support for System.Data.SqlClient (NuGet package) traces instrumentation from
4.8.5
. - Ability to update installation via PS module (
OpenTelemetry.DotNet.Auto.psm1
).
Changed
Dependency updates
- .NET Framework only,
Grpc.Core.Api
updated from2.57.0
to2.59.0
. - .NET only,
OpenTelemetry.Instrumentation.EntityFrameworkCore
updated from1.0.0-beta.7
to1.0.0-beta.8
. - .NET only,
OpenTelemetry.Instrumentation.AspNetCore
updated from1.5.1-beta.1
to1.6.0-beta.3
. OpenTelemetry.Instrumentation.GrpcNetClient
, andOpenTelemetry.Instrumentation.Http
updated from1.5.1-beta.1
to1.6.0-beta.3
.OpenTelemetry.Instrumentation.SqlClient
updated from1.5.1-beta.1
to1.6.0-beta.2
.- .NET only,
OpenTelemetry.Instrumentation.StackExchangeRedis
updated from1.0.0-rc9.10
to1.0.0-rc9.12
. - .NET Framework only,
Google.Protobuf
updated from3.24.4
to3.25.1
. - .NET Framework only,
OpenTelemetry.Instrumentation.AspNet
andOpenTelemetry.Instrumentation.AspNet.TelemetryHttpModule
updated from1.6.0-beta.1
to1.6.0-beta.2
. OpenTelemetry.Instrumentation.Wcf
updated from1.0.0-rc.12
to1.0.0-rc.13
.- .NET Framework only, following packages updated
Microsoft.Bcl.AsyncInterfaces
from7.0.0
to8.0.0
,Microsoft.Extensions.Configuration
from7.0.0
to8.0.0
,Microsoft.Extensions.Configuration.Abstractions
from7.0.0
to8.0.0
,Microsoft.Extensions.Configuration.Binder
from7.0.4
to8.0.0
,Microsoft.Extensions.DependencyInjection
from7.0.0
to8.0.0
,Microsoft.Extensions.DependencyInjection.Abstractions
from7.0.0
to8.0.0
,Microsoft.Extensions.Logging
from7.0.0
to8.0.0
,Microsoft.Extensions.Options
from7.0.1
to8.0.0
,Microsoft.Extensions.Options.ConfigurationExtensions
from7.0.0
to8.0.0
,Microsoft.Extensions.Primitives
from7.0.0
to8.0.0
,System.Text.Encodings.Web
from7.0.0
to8.0.0
,System.Text.Json
from7.0.3
to8.0.0
.
- Following packages updated
Microsoft.Extensions.Logging.Abstractions
from7.0.1
to8.0.0
,Microsoft.Extensions.Logging.Configuration
from7.0.0
to8.0.0
,System.Diagnostics.DiagnosticSource
from7.0.2
to8.0.0
.
Removed
- Removed support for
OpenTelemetry.Instrumentation.AspNetCore.AspNetCoreMetricsInstrumentationOptions
for plugins.
v1.1.0
1.1.0
Added
- Added support for
Elastic.Transport
traces instrumentation 0.4.16+.Elastic.Clients.Elasticsearch
8.10.0+ traces instrumentation is covered byElastic.Transport
traces instrumentation. - Added
telemetry.distro.name
resource attribute. The value is set toopentelemetry-dotnet-instrumentation
.
Changed
- Change telemetry resource attribute name from
telemetry.auto.version
totelemetry.distro.version
.
Dependency updates
- .NET Framework only,
Google.Protobuf
updated from3.24.3
to3.24.4
. - .NET Framework only,
OpenTelemetry.Instrumentation.AspNet
andOpenTelemetry.Instrumentation.AspNet.TelemetryHttpModule
updated from1.0.0-rc9.9
to1.6.0-beta.1
.
Fixed
- Fixed log emission issue which resulted in same logs being exported multiple times for ASP.NET Core 6.0 apps when bytecode instrumentation was enabled and
WebApplicationBuilder
was used.
v1.0.2
v1.0.1
1.0.1
Changed
Dependency updates
- .NET Framework only,
Google.Protobuf
updated from3.24.2
to3.24.3
. OpenTelemetry.ResourceDetectors.Azure
updated from1.0.0-beta.2
to1.0.0-beta.3
.
Fixed
- Fixed Rule checking System.Diagnostics.DiagnosticSource version for net7.0 failing on correct configuration #2950.
v1.0.0
1.0.0
This release is built on top of OpenTelemetry .NET:
- Core components:
1.6.0
System.Diagnostics.DiagnosticSource
:7.0.2
Added
- Added support for Azure SDK traces instrumentation on .NET Framework.
- Added support for
WCFCLIENT
instrumentation on .NET.
Changed
- Updated Core components:
1.6.0
. - MySql.Data instrumentation is now supported from version 8.1.0 working on .NET.
- OpenTracing spans are registered under
opentracing-shim
name instead ofOpenTelemetry.AutoInstrumentation.OpenTracingShim
.
Removed
- Removed MySql.Data instrumentation for versions 6.10.7-8.0.33.
- Removed support for
OpenTelemetry.Instrumentation.MySqlData.MySqlDataInstrumentationOptions
for plugins.
Fixed
- Fixed instrumentation loading issue where delayed instrumentation initialization could not bootstrap both traces and metrics. Affected scope: ASP.NET Core and HttpClient instrumentations.
- Fixed
ILogger
log instrumentation issue that caused logs to be exported multiple times.