Releases: open-telemetry/opentelemetry-dotnet-instrumentation
v0.6.0
0.6.0
This release is built on top of OpenTelemetry .NET:
- Core components:
1.4.0 System.Diagnostics.DiagnosticSource:7.0.0
Changed
- Updated Core components:
1.4.0.
v0.6.0-beta.2
This beta release is built on top of OpenTelemetry .NET:
- Core components:
1.4.0-rc.4 System.Diagnostics.DiagnosticSource:7.0.0
Added
- Support for systems with glibc versions 2.17-2.29.
Changed
- Updated Core components:
1.4.0-rc.4. - Replace
OTEL_DOTNET_AUTO_LEGACY_SOURCESwithOTEL_DOTNET_AUTO_TRACES_ADDITIONAL_LEGACY_SOURCES. - Updated the shared store to correctly support framework roll-forward from
net6.0tonet7.0.
Removed
- Remove support for plugin method
ConfigureMetricsOptions(OpenTelemetry.Instrumentation.Process.ProcessInstrumentationOptions).
Fixed
- Fix location of
OpenTelemetry.AutoInstrumentation.Native.soforlinux-musl-x64. - Fix issues when instrumenting
dotnetCLI #1477.
v0.6.0-beta.1
This beta release is built on top of OpenTelemetry .NET:
- Core components:
1.4.0-rc.3 System.Diagnostics.DiagnosticSource:7.0.0
Added
- Support configuring
OTEL_*settings usingApp.configandWeb.config. - Add support for Quartz traces instrumentation.
- Add support for EntityFrameworkCore traces instrumentations.
- Add plugin support for
ResourceBuilder ConfigureResource(ResourceBuilder builder).
Changed
-
Updated Core components:
1.4.0-rc.3 -
Move
OpenTelemetry.AutoInstrumentation.Native.sotolinux-x64directory intracer-homefor Linux glibc,OpenTelemetry.AutoInstrumentation.Native.sotolinux-musl-x64for Linux musl andOpenTelemetry.AutoInstrumentation.Native.dylibtoosx-x64for MacOS. -
Change the way to manage enabled instrumentations. The following environmental variables:
OTEL_DOTNET_AUTO_TRACES_ENABLED_INSTRUMENTATIONS,OTEL_DOTNET_AUTO_TRACES_DISABLED_INSTRUMENTATIONS,OTEL_DOTNET_AUTO_METRICS_ENABLED_INSTRUMENTATIONS,OTEL_DOTNET_AUTO_METRICS_DISABLED_INSTRUMENTATIONS,OTEL_DOTNET_AUTO_LOGS_ENABLED_INSTRUMENTATIONS,OTEL_DOTNET_AUTO_LOGS_DISABLED_INSTRUMENTATIONS
are replaced by:
OTEL_DOTNET_AUTO_INSTRUMENTATION_ENABLED,OTEL_DOTNET_AUTO_TRACES_INSTRUMENTATION_ENABLED,OTEL_DOTNET_AUTO_TRACES_{0}_INSTRUMENTATION_ENABLED,OTEL_DOTNET_AUTO_METRICS_INSTRUMENTATION_ENABLED,OTEL_DOTNET_AUTO_METRICS_{0}_INSTRUMENTATION_ENABLED,OTEL_DOTNET_AUTO_LOGS_INSTRUMENTATION_ENABLED,OTEL_DOTNET_AUTO_LOGS_{0}_INSTRUMENTATION_ENABLED.
-
Change instrumentation id for ASP.NET Core traces and metrics instrumentation from
AspNettoASPNETCORE.
Fixed
- Fix console error messages
Log: Exception creating FileSink#1885
v0.5.1-beta.3
This beta release is built on top of OpenTelemetry .NET:
- Core components:
1.4.0-rc.1 System.Diagnostics.DiagnosticSource:7.0.0
Added
- Add support for NServiceBus metrics and traces instrumentations.
- Add support for Elasticsearch traces instrumentations.
- Add plugin support for
ConfigureTracesOptions(StackExchangeRedisCallsInstrumentationOptions options). - Add plugin support for
ConfigureMetricsOptions(AspNetCoreMetricsInstrumentationOptions options). - Add automatic assembly redirection for .NET Framework applications. The redirection can be enabled or disabled via the
OTEL_DOTNET_AUTO_NETFX_REDIRECT_ENABLEDenvironment variable. See the additional settings table for details.
Changed
- Updated Core components:
1.4.0-rc.1
Removed
- Remove support for Jaeger exporter.
Fixed
- Fix WCF instrumentation on .NET Framework.
v0.5.1-beta.2
Added
- Add support for
OTEL_TRACES_SAMPLERandOTEL_TRACES_SAMPLER_ARG. - Add
Initializingplugin extension point
that is invoked before OpenTelemetry SDK configuration.
0.5.1-beta.1
This beta release is built on top of OpenTelemetry .NET:
- Core components:
1.4.0-beta.3 System.Diagnostics.DiagnosticSource:7.0.0
Added
- Add support for
OTEL_BSP_SCHEDULE_DELAY,OTEL_BSP_EXPORT_TIMEOUT,OTEL_BSP_MAX_QUEUE_SIZE,OTEL_BSP_MAX_EXPORT_BATCH_SIZE. - Add support for
OTEL_METRIC_EXPORT_TIMEOUT. - Add support for
OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT,OTEL_ATTRIBUTE_COUNT_LIMIT,OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT,OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT,OTEL_SPAN_EVENT_COUNT_LIMIT,OTEL_SPAN_LINK_COUNT_LIMIT,OTEL_EVENT_ATTRIBUTE_COUNT_LIMIT,OTEL_LINK_ATTRIBUTE_COUNT_LIMITforotlpexporter.
Changed
- Updated Core components:
1.4.0-beta.3 - Updated plugins method signature to overwrite OpenTelemetry .NET SDK exporters' and instrumentations' options.
ConfigureOptionschanged toConfigureTracesOptions,ConfigureMetricsOptionsorConfigureLogsOptions.
v0.5.0
The is the first production-ready (non-beta) release. It is not stable yet.
Added
- Add support for .NET 7.
- Add support for
OTEL_DOTNET_AUTO_LOGS_ENABLED. - Add error log if bytecode instrumentation type is missing all instrumentation methods.
- Plugins can overwrite OpenTelemetry .NET SDK exporters' and instrumentations' options.
Changed
- Replace
OTEL_DOTNET_AUTO_LOAD_TRACER_AT_STARTUPwithOTEL_DOTNET_AUTO_TRACES_ENABLEDandOTEL_DOTNET_AUTO_LOAD_METER_AT_STARTUPwithOTEL_DOTNET_AUTO_METRICS_ENABLED. - Disable OpenTracing by default. OpenTracing can be re-enabled via
OTEL_DOTNET_AUTO_OPENTRACING_ENABLED. - GraphQL exceptions are recorded as OTel events.
DOTNET_STARTUP_HOOKSrequired value changed to$INSTALL_DIR/net/OpenTelemetry.AutoInstrumentation.StartupHook.dll.
Removed
- Remove support for .NET Core 3.1.
- Remove support for
OTEL_DOTNET_AUTO_HTTP2UNENCRYPTEDSUPPORT_ENABLED. - Remove support for
OTEL_DOTNET_AUTO_ENABLED. UseCORECLR_ENABLE_PROFILINGorCOR_ENABLE_PROFILINGinstead. - Remove support for
OTEL_DOTNET_AUTO_INCLUDE_PROCESSES.
Fixed
- Fix the IIS registration in the PowerShell script module for Windows Server 2016.
- Fix the IIS unregistration in the PowerShell script module.
- Get rid of unnecessary service restarts during the IIS unregistration, in the PowerShell script module.
OTEL_DOTNET_AUTO_TRACES_ENABLEDis also respected by bytecode instrumentations.
v0.4.0-beta.1
Added
- Add WCF traces instrumentation (server-side for .NET Framework, client-side for both .NET Core and .NET Framework).
- Support ASP.NET Core OpenTelemetry Log exporter related environment variables:
OTEL_LOGS_EXPORTER,OTEL_DOTNET_AUTO_LOGS_CONSOLE_EXPORTER_ENABLED,OTEL_DOTNET_AUTO_LOGS_ENABLED_INSTRUMENTATIONS,OTEL_DOTNET_AUTO_LOGS_DISABLED_INSTRUMENTATIONS,OTEL_DOTNET_AUTO_LOGS_INCLUDE_FORMATTED_MESSAGE.
- Support
OTEL_DOTNET_AUTO_GRAPHQL_SET_DOCUMENT(default value:false) environment variable which controls whethergraphql.documentattribute is set. - Add ILogger logging instrumentation for .NET Core 3.1+.
- Add telemetry resource attributes.
- Add support for the
b3propagator. - Add MassTransit traces instrumentation.
- Add
OpenTelemetry.AutoInstrumentationNuget package. - Support for Process metrics collection using the
OpenTelemetry.Instrumentation.Processpackage. - Add Shell scripts for downloading and installing OpenTelemetry .NET Automatic Instrumentation and instrumenting .NET applications.
- Add PowerShell script module for downloading and installing OpenTelemetry .NET Automatic Instrumentation and instrumenting .NET applications.
Changed
- Replaced
OTEL_DOTNET_AUTO_TRACES_PLUGINSandOTEL_DOTNET_AUTO_METRICS_PLUGINSwith new environment variableOTEL_DOTNET_AUTO_PLUGINS. - Adjusted tags for MongoDB integration. See pull request for more details.
- Extend MySql.Data traces instrumentation for versions 8.0.31+. Versions 8.0.31+ require bytecode instrumentation.
Removed
- Removed support for MongoDB integration for MongoDB.Driver.Core prior to 2.13.3.
Fixed
- Log folder structure is fully created on Linux.
- Update GraphQL instrumentation to follow the OpenTelemetry semantic conventions.
- Fixed the race between requesting ReJIT of methods targeted for bytecode instrumentation and their first execution. The race allowed, in rare occasions, for the first few executions of the method to not be instrumented. See issue #1242.
- Span kind for GraphQL instrumentation is set as span property instead of attribute.
v0.3.1-beta.1
This release is built on top of OpenTelemetry .NET:
- Core components:
1.3.1 System.Diagnostics.DiagnosticSource:6.0.0
Added
- Add support for Alpine.
- Add strong name signature to the OpenTelemetry.AutoInstrumentation assembly used
on the .NET Framework.
Changed
- Extend StackExchange.Redis traces instrumentation for versions 2.6.66+.
- Updated Core components:
1.3.1
v0.3.0-beta.1
This release add various new instrumentations and more propagation options.
Added
- Add Grpc.Net.Client traces instrumentation.
- Add MySql.Data traces instrumentation.
- Add Npgsql traces instrumentation.
- Add StackExchange.Redis traces instrumentation.
- Add configuration option
nonetoOTEL_DOTNET_AUTO_TRACES_ENABLED_INSTRUMENTATIONS
andOTEL_DOTNET_AUTO_METRICS_ENABLED_INSTRUMENTATIONS. - Add support for the
b3multipropagator. - Add support for the
OTEL_PROPAGATORSenvironment variable.
Supported configuration options areb3multi,baggage,tracecontext.
Default istracecontext,baggage.
Changed
- Renamed
OTEL_DOTNET_AUTO_TRACES_ENABLEDtoOTEL_DOTNET_AUTO_ENABLEDsince it
controls enabling or disabling the CLR profiler independent of the signal type. OTEL_DOTNET_AUTO_TRACES_ENABLED_INSTRUMENTATIONSdefault value is changed to
include all of the available instrumentations.OTEL_DOTNET_AUTO_METRICS_ENABLED_INSTRUMENTATIONSdefault value is changed to
include all of the available instrumentations.- Changed Tracing sampler from
always_ontoparentbased_always_on.
See the OpenTelemetry specification
for more details.
Removed
- Remove
OTEL_DOTNET_AUTO_DOMAIN_NEUTRAL_INSTRUMENTATIONconfiguration
as it is not needed. - Remove
OTEL_DOTNET_AUTO_{0}_ENABLEDconfiguration,
useOTEL_DOTNET_AUTO_[TRACES/METRICS]_[ENABLED/DISABLED]_INSTRUMENTATIONS
instead. - Remove
OTEL_DOTNET_AUTO_METRICS_ENABLEDconfiguration as it is not needed.