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_HEADERSandOTEL_DOTNET_AUTO_TRACES_ASPNET_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS, - ASP.NET Core, configurable by
OTEL_DOTNET_AUTO_TRACES_ASPNETCORE_INSTRUMENTATION_CAPTURE_REQUEST_HEADERSandOTEL_DOTNET_AUTO_TRACES_ASPNETCORE_INSTRUMENTATION_CAPTURE_RESPONSE_HEADERS, - HTTP Client, configurable by
OTEL_DOTNET_AUTO_TRACES_HTTP_INSTRUMENTATION_CAPTURE_REQUEST_HEADERSandOTEL_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_METADATAandOTEL_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_TEXTenvironment 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.Kafkaclient instrumentation. See the issue for details. - Do not create consumer spans related to
PartitionEOFevents forConfluent.Kafkaclient 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.HttpListenerfrom1.8.0-rc.1to1.9.0-beta.1,OpenTelemetry.Instrumentation.GrpcNetClientfrom1.8.0-beta.1to1.9.0-beta.1,OpenTelemetry.Instrumentation.Httpfrom1.8.1to1.9.0,OpenTelemetry.Instrumentation.Processfrom0.5.0-beta.5to0.5.0-beta.6,OpenTelemetry.Instrumentation.Quartzfrom1.0.0-beta.2to1.0.0-beta.3,OpenTelemetry.Instrumentation.Runtimefrom1.8.0to1.9.0,OpenTelemetry.Instrumentation.SqlClientfrom1.8.0-beta.1to1.9.0-beta.1,OpenTelemetry.Instrumentation.StackExchangeRedisfrom1.0.0-rc9.14to1.0.0-rc9.15,OpenTelemetry.Instrumentation.Wcffrom1.0.0-rc.16to1.0.0-rc.17,OpenTelemetry.Shims.OpenTracingfrom1.7.0-beta.1to1.9.0-beta.1,OpenTelemetry.Resources.Azurefrom1.0.0-beta.7to1.0.0-beta.8,OpenTelemetry.Resources.Hostfrom0.1.0-beta.1to0.1.0-beta.2.OpenTelemetry.Resources.Processfrom0.1.0-beta.1to0.1.0-beta.2.OpenTelemetry.Resources.ProcessRuntimefrom0.1.0-beta.1to0.1.0-beta.2.
- .NET only, following packages updated
OpenTelemetry.Instrumentation.AspNetCorefrom1.8.1to1.9.0,OpenTelemetry.Instrumentation.EntityFrameworkCorefrom1.0.0-beta.11to1.0.0-beta.12,OpenTelemetry.Resources.Containerfrom1.0.0-beta.7to1.0.0-beta.9.
- .NET Framework only, following packages updated
OpenTelemetry.Instrumentation.AspNetfrom1.8.0-beta.2to1.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.queryor theurl.fullattributes:OpenTelemetry.Instrumentation.Http,OpenTelemetry.Instrumentation.AspNetCore,OpenTelemetry.Instrumentation.AspNet. For example,?key1=value1&key2=value2becomes?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.Httpfrom1.8.0to1.8.1.
- .NET only, following packages updated
Microsoft.Extensions.Configuration.Binderfrom8.0.0to8.0.1,OpenTelemetry.Instrumentation.AspNetCorefrom1.8.0to1.8.1.
- .NET Framework only, following packages updated
OpenTelemetry.Instrumentation.AspNetfrom1.8.0-beta.1to1.8.0-beta.2.
Fixed
- Stop creating
receiveconsumer 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.AutoInstrumentationNuGet package.
Changed
- Changed supported method parameters for plugins
- from
OpenTelemetry.Instrumentation.AspNet.AspNetInstrumentationOptionstoOpenTelemetry.Instrumentation.AspNet.AspNetTraceInstrumentationOptions.
- from
Dependency updates
- Updated Core components:
1.8.0. - Following packages updated
MongoDB.Driver.Core.Extensions.DiagnosticSourcesfrom1.3.0to1.4.0.OpenTelemetry.Exporter.Prometheus.HttpListenerfrom1.7.0-rc.1to1.8.0-rc.1,OpenTelemetry.Instrumentation.Httpfrom1.7.1to1.8.0,OpenTelemetry.Instrumentation.Processfrom0.5.0-beta.4to0.5.0-beta.5,OpenTelemetry.Instrumentation.Quartzfrom1.0.0-beta.1to1.0.0-beta.2,OpenTelemetry.Instrumentation.Runtimefrom1.7.0to1.8.0,OpenTelemetry.Instrumentation.SqlClientfrom1.7.0-beta.1to1.8.0-beta.1,OpenTelemetry.Instrumentation.StackExchangeRedisfrom1.0.0-rc9.13to1.0.0-rc9.14,OpenTelemetry.Instrumentation.Wcffrom1.0.0-rc.15to1.0.0-rc.16,OpenTelemetry.ResourceDetectors.Azurefrom1.0.0-beta.5to1.0.0-beta.6,OpenTelemetry.ResourceDetectors.Hostfrom0.1.0-alpha.2to0.1.0-alpha.3.OpenTelemetry.ResourceDetectors.Processfrom0.1.0-alpha.2to0.1.0-alpha.3.OpenTelemetry.ResourceDetectors.ProcessRuntimefrom0.1.0-alpha.2to0.1.0-alpha.3.
- .NET only, following packages updated
OpenTelemetry.Instrumentation.AspNetCorefrom1.7.1to1.8.0,OpenTelemetry.Instrumentation.EntityFrameworkCorefrom1.0.0-beta.10to1.0.0-beta.11,OpenTelemetry.ResourceDetectors.Containerfrom1.0.0-beta.6to1.0.0-beta.7.
- .NET Framework only, following packages updated
Google.Protobufupdated from3.25.2to3.26.1,Grpc.Core.Apifrom2.60.0to2.62.0,Microsoft.Extensions.DependencyInjection.Abstractionsfrom8.0.0to8.0.1,Microsoft.Extensions.Optionsfrom8.0.1to8.0.2,Microsoft.Extensions.Logging.Abstractionsfrom8.0.0to8.0.1,OpenTelemetry.Instrumentation.AspNetfrom1.7.0-beta.2to1.8.0-beta.1,System.Text.Jsonfrom8.0.1to8.0.3.
Fixed
- Resolved a crash issue caused by
System.IO.FileLoadExceptionfor
Microsoft.Extensions*.dlllibraries. 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_TEXTandOTEL_DOTNET_AUTO_ENTITYFRAMEWORKCORE_SET_DBSTATEMENT_FOR_TEXTenvironment variables which controls whether thedb.statementattribute is set for SQL statements for SQL Client and Entity Framework Core instrumentations. The default value for both environment variables isfalsedue to the risk of leaking sensitive information in the collected database queries.
Changed
- Changed supported method parameters for plugins
- from
OpenTelemetry.Instrumentation.GrpcNetClient.GrpcClientInstrumentationOptionstoOpenTelemetry.Instrumentation.GrpcNetClient.GrpcClientTraceInstrumentationOptions, - from
OpenTelemetry.Instrumentation.SqlClient.SqlClientInstrumentationOptionstoOpenTelemetry.Instrumentation.SqlClient.SqlClientTraceInstrumentationOptions.
- from
Dependency updates
- Following packages updated
OpenTelemetry.ResourceDetectors.Azurefrom1.0.0-beta.4to1.0.0-beta.5,OpenTelemetry.ResourceDetectors.Containerfrom1.0.0-beta.5to1.0.0-beta.6.OpenTelemetry.Instrumentation.Httpfrom1.7.0to1.7.1,OpenTelemetry.Instrumentation.SqlClientfrom1.6.0-beta.3to1.7.0-beta.1,OpenTelemetry.Instrumentation.Wcffrom1.0.0-rc.14to1.0.0-rc.15,
- .NET only, following packages updated
OpenTelemetry.Instrumentation.AspNetCorefrom1.7.0to1.7.1,OpenTelemetry.Instrumentation.EntityFrameworkCorefrom1.0.0-beta.9to1.0.0-beta.10,OpenTelemetry.Instrumentation.GrpcNetClientfrom1.6.0-beta.3to1.7.0-beta.1.
- .NET Framework only, following packages updated
OpenTelemetry.Instrumentation.AspNetfrom1.7.0-beta.1to1.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.AspNetCoreinstead 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.AspNetMetricsInstrumentationOptionsfor plugins. - Support for Confluent.Kafka traces instrumentation from 1.4.0 to 3.0.0 (excluding).
Changed
- Changed minimal supported version of
Microsoft.Extensions.LoggingforILOGGERinstrumentation from6.0.0to8.0.0. - Changed supported method parameters for plugins
- from
OpenTelemetry.Instrumentation.AspNetCore.AspNetCoreInstrumentationOptionstoOpenTelemetry.Instrumentation.AspNetCore.AspNetCoreTraceInstrumentationOptions, - from
OpenTelemetry.Instrumentation.Http.HttpClientInstrumentationOptionstoOpenTelemetry.Instrumentation.Http.HttpClientTraceInstrumentationOptions.
- from
Dependency updates
- Updated Core components:
1.7.0. - Following packages updated
OpenTelemetry.Exporter.Prometheus.HttpListenerfrom1.6.0-rc.1to1.7.0-rc.1,OpenTelemetry.Instrumentation.Httpfrom1.6.0to1.7.0,OpenTelemetry.Instrumentation.Processfrom0.5.0-beta.3to0.5.0-beta.4,OpenTelemetry.Instrumentation.Quartzfrom1.0.0-alpha.3to1.0.0-beta.1,OpenTelemetry.Instrumentation.Runtimefrom1.5.1to1.7.0,OpenTelemetry.Instrumentation.SqlClientfrom1.6.0-beta.2to1.6.0-beta.3,OpenTelemetry.Instrumentation.StackExchangeRedisfrom1.0.0-rc9.12to1.0.0-rc9.13,OpenTelemetry.Instrumentation.Wcffrom1.0.0-rc.13to1.0.0-rc.14,OpenTelemetry.Shims.OpenTracingfrom1.6.0-beta.1to1.7.0-beta.1,OpenTelemetry.ResourceDetectors.Azurefrom1.0.0-beta.3to1.0.0-beta.4,OpenTelemetry.ResourceDetectors.Containerfrom1.0.0-beta.4to1.0.0-beta.5,OpenTelemetry.ResourceDetectors.ProcessRuntimefrom0.1.0-alpha.1to0.1.0-alpha.2.
- .NET only, following packages updated
Google.Protobufupdated from3.19.4to3.22.5.Microsoft.Extensions.Configurationfrom3.1.0to8.0.0,Microsoft.Extensions.Configuration.Abstractionsfrom3.1.0to8.0.0,Microsoft.Extensions.Configuration.Binderfrom3.1.0to8.0.0,Microsoft.Extensions.DependencyInjectionfrom3.1.0to8.0.0,Microsoft.Extensions.DependencyInjection.Abstractionsfrom3.1.0to8.0.0,Microsoft.Extensions.Loggingfrom6.0.0to8.0.0,Microsoft.Extensions.Optionsfrom3.1.0to8.0.0,Microsoft.Extensions.Options.ConfigurationExtensionsfrom3.1.0to8.0.0,Microsoft.Extensions.Primitivesfrom3.1.0to8.0.0,OpenTelemetry.Instrumentation.AspNetCorefrom1.6.0-beta.3to1.7.0,OpenTelemetry.Instrumentation.EntityFrameworkCorefrom1.0.0-beta.8to1.0.0-beta.9.
- .NET Framework only, following packages updated
Google.Protobufupdated from3.25.1to3.25.2,Grpc.Core.Apifrom2.59.0to2.60.0,Microsoft.Extensions.Configuration.Binderfrom8.0.0to8.0.1,Microsoft.Extensions.Optionsfrom8.0.0to8.0.1,OpenTelemetry.Instrumentation.AspNetfrom1.6.0-beta.2to1.7.0-beta.1,System.Text.Jsonfrom8.0.0to8.0.1.
Removed
Removed support for Microsoft.Extensions.Logging for ILOGGER for versions older than 8.0.0.
Fixed
- Set
service.nameresource 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.Apiupdated from2.57.0to2.59.0. - .NET only,
OpenTelemetry.Instrumentation.EntityFrameworkCoreupdated from1.0.0-beta.7to1.0.0-beta.8. - .NET only,
OpenTelemetry.Instrumentation.AspNetCoreupdated from1.5.1-beta.1to1.6.0-beta.3. OpenTelemetry.Instrumentation.GrpcNetClient, andOpenTelemetry.Instrumentation.Httpupdated from1.5.1-beta.1to1.6.0-beta.3.OpenTelemetry.Instrumentation.SqlClientupdated from1.5.1-beta.1to1.6.0-beta.2.- .NET only,
OpenTelemetry.Instrumentation.StackExchangeRedisupdated from1.0.0-rc9.10to1.0.0-rc9.12. - .NET Framework only,
Google.Protobufupdated from3.24.4to3.25.1. - .NET Framework only,
OpenTelemetry.Instrumentation.AspNetandOpenTelemetry.Instrumentation.AspNet.TelemetryHttpModuleupdated from1.6.0-beta.1to1.6.0-beta.2. OpenTelemetry.Instrumentation.Wcfupdated from1.0.0-rc.12to1.0.0-rc.13.- .NET Framework only, following packages updated
Microsoft.Bcl.AsyncInterfacesfrom7.0.0to8.0.0,Microsoft.Extensions.Configurationfrom7.0.0to8.0.0,Microsoft.Extensions.Configuration.Abstractionsfrom7.0.0to8.0.0,Microsoft.Extensions.Configuration.Binderfrom7.0.4to8.0.0,Microsoft.Extensions.DependencyInjectionfrom7.0.0to8.0.0,Microsoft.Extensions.DependencyInjection.Abstractionsfrom7.0.0to8.0.0,Microsoft.Extensions.Loggingfrom7.0.0to8.0.0,Microsoft.Extensions.Optionsfrom7.0.1to8.0.0,Microsoft.Extensions.Options.ConfigurationExtensionsfrom7.0.0to8.0.0,Microsoft.Extensions.Primitivesfrom7.0.0to8.0.0,System.Text.Encodings.Webfrom7.0.0to8.0.0,System.Text.Jsonfrom7.0.3to8.0.0.
- Following packages updated
Microsoft.Extensions.Logging.Abstractionsfrom7.0.1to8.0.0,Microsoft.Extensions.Logging.Configurationfrom7.0.0to8.0.0,System.Diagnostics.DiagnosticSourcefrom7.0.2to8.0.0.
Removed
- Removed support for
OpenTelemetry.Instrumentation.AspNetCore.AspNetCoreMetricsInstrumentationOptionsfor plugins.
v1.1.0
1.1.0
Added
- Added support for
Elastic.Transporttraces instrumentation 0.4.16+.Elastic.Clients.Elasticsearch8.10.0+ traces instrumentation is covered byElastic.Transporttraces instrumentation. - Added
telemetry.distro.nameresource attribute. The value is set toopentelemetry-dotnet-instrumentation.
Changed
- Change telemetry resource attribute name from
telemetry.auto.versiontotelemetry.distro.version.
Dependency updates
- .NET Framework only,
Google.Protobufupdated from3.24.3to3.24.4. - .NET Framework only,
OpenTelemetry.Instrumentation.AspNetandOpenTelemetry.Instrumentation.AspNet.TelemetryHttpModuleupdated from1.0.0-rc9.9to1.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
WebApplicationBuilderwas used.
v1.0.2
v1.0.1
1.0.1
Changed
Dependency updates
- .NET Framework only,
Google.Protobufupdated from3.24.2to3.24.3. OpenTelemetry.ResourceDetectors.Azureupdated from1.0.0-beta.2to1.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
WCFCLIENTinstrumentation 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-shimname instead ofOpenTelemetry.AutoInstrumentation.OpenTracingShim.
Removed
- Removed MySql.Data instrumentation for versions 6.10.7-8.0.33.
- Removed support for
OpenTelemetry.Instrumentation.MySqlData.MySqlDataInstrumentationOptionsfor 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
ILoggerlog instrumentation issue that caused logs to be exported multiple times.