Skip to content

Releases: open-telemetry/opentelemetry-dotnet-instrumentation

v1.0.0

07 Sep 10:56
v1.0.0
42f1acd
Compare
Choose a tag to compare

1.0.0

This release is built on top of OpenTelemetry .NET:

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 of OpenTelemetry.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.

v1.0.0-rc.2

03 Aug 07:00
v1.0.0-rc.2
2f5e1fc
Compare
Choose a tag to compare
v1.0.0-rc.2 Pre-release
Pre-release

1.0.0-rc.2

Added

  • Support for Azure App Service resource detector.

  • Added BeforeConfigureTracerProvider, BeforeConfigureMeterProvider, TracerProviderInitialized and MeterProviderInitialized for plugins. See plugins documentation for details.

  • Added support for Azure SDK traces instrumentation on .NET.

Changed

  • In plugins ConfigureTracerProvider and ConfigureMeterProvider are changed now to AfterConfigureTracerProvider and AfterConfigureMeterProvider. See plugins documentation for details.
  • Minimal version of Grpc.Net.Client supported on .NET updated to 2.52.0.

Fixed

  • OTEL_DOTNET_AUTO_EXCLUDE_PROCESSES works correctly when .NET CLR Profiler is not enabled.
  • Fixed manual tracing when instrumented project is referencing System.Diagnostics.DiagnosticSource 7.0.2 #2780.

v1.0.0-rc.1

27 Jun 11:26
v1.0.0-rc.1
3f53834
Compare
Choose a tag to compare
v1.0.0-rc.1 Pre-release
Pre-release

1.0.0-rc.1

This release is built on top of OpenTelemetry .NET:

Added

  • The environment variable OTEL_DOTNET_AUTO_FAIL_FAST_ENABLED could be used to enable or disable the failing process when automatic instrumentation cannot be executed.
  • Add support for MySqlConnector traces instrumentation.

Changed

  • Updated Core components: 1.5.1.
  • ASP.NET instrumentation no longer requires manual modification of config files to include TelemetryHttpModule.
  • Parameter for ConfigureTracesOptions extension point for StackExchangeRedis changed type from OpenTelemetry.Instrumentation.StackExchangeRedis.StackExchangeRedisCallsInstrumentationOptions to OpenTelemetry.Instrumentation.StackExchangeRedis.StackExchangeRedisInstrumentationOptions.
  • WCF instrumentation split to WCFCLIENT and WCFSERVICE. Both supported only on .NET Framework.
  • WCFCLIENT and WCFSERVICE no longer requires manual modification of config files to include TelemetryEndpointBehaviorExtensionElement.
  • GraphQL instrumentation is now supported from version 7.5.0 working on .NET.

Removed

  • Removed WCF instrumentation for Core WCF Client working on .NET.
  • Removed GraphQL instrumentation for versions 2.3.0-2.4.*.

Known issues

  • Lack of support for MySql.Data 8.0.33. See #2542.

v0.7.0

25 Apr 04:58
v0.7.0
93157a5
Compare
Choose a tag to compare

0.7.0

Added

  • Stability status added to the documentation.
  • Support OTEL_LOG_LEVEL to configure SDK logging level.
  • Fallback for the service name. If the service name is not configured, the automatic instrumentation uses the entry assembly name instead, only falling back to the process name in case of an error. If the application uses .NET Framework and is hosted on IIS, the service name is determined using SiteName/ApplicationVirtualPath.
  • Add MongoDB instrumentation support for .NET Framework.
  • Added a rule engine to validate potential conflicts and unsupported scenarios, ensuring back off instead of crashing, improving overall stability.
  • The environment variable OTEL_DOTNET_AUTO_RULE_ENGINE_ENABLED could be used to enable or disable the rule engine.
  • Support for Container resource detector.
  • Support for enabling well known resource detectors by using the environment variables
    • OTEL_DOTNET_AUTO_RESOURCE_DETECTOR_ENABLED
    • OTEL_DOTNET_AUTO_{0}_RESOURCE_DETECTOR_ENABLED.

Removed

  • Remove support for enabling debugging mode with OTEL_DOTNET_AUTO_DEBUG.
  • Removed OTEL_DOTNET_AUTO_INTEGRATIONS_FILE as a required environment variable for bytecode instrumentation setup

v0.6.0

01 Mar 06:38
v0.6.0
133037f
Compare
Choose a tag to compare

0.6.0

This release is built on top of OpenTelemetry .NET:

Changed

v0.6.0-beta.2

15 Feb 06:40
v0.6.0-beta.2
2e50a3b
Compare
Choose a tag to compare
v0.6.0-beta.2 Pre-release
Pre-release

This beta release is built on top of OpenTelemetry .NET:

Added

  • Support for systems with glibc versions 2.17-2.29.

Changed

Removed

  • Remove support for plugin method ConfigureMetricsOptions(OpenTelemetry.Instrumentation.Process.ProcessInstrumentationOptions).

Fixed

  • Fix location of OpenTelemetry.AutoInstrumentation.Native.so for linux-musl-x64.
  • Fix issues when instrumenting dotnet CLI #1477.

v0.6.0-beta.1

03 Feb 10:49
v0.6.0-beta.1
908504a
Compare
Choose a tag to compare
v0.6.0-beta.1 Pre-release
Pre-release

This beta release is built on top of OpenTelemetry .NET:

Added

  • Support configuring OTEL_* settings using App.config and Web.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.so to linux-x64 directory in tracer-home for Linux glibc, OpenTelemetry.AutoInstrumentation.Native.so to linux-musl-x64 for Linux musl and OpenTelemetry.AutoInstrumentation.Native.dylib to osx-x64 for 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 AspNet to ASPNETCORE.

Fixed

  • Fix console error messages Log: Exception creating FileSink #1885

v0.5.1-beta.3

05 Jan 07:51
v0.5.1-beta.3
56c0c11
Compare
Choose a tag to compare
v0.5.1-beta.3 Pre-release
Pre-release

This beta release is built on top of OpenTelemetry .NET:

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_ENABLED environment variable. See the additional settings table for details.

Changed

Removed

  • Remove support for Jaeger exporter.

Fixed

  • Fix WCF instrumentation on .NET Framework.

v0.5.1-beta.2

08 Dec 09:23
v0.5.1-beta.2
1ac707e
Compare
Choose a tag to compare
v0.5.1-beta.2 Pre-release
Pre-release

Added

  • Add support for OTEL_TRACES_SAMPLER and OTEL_TRACES_SAMPLER_ARG.
  • Add Initializing plugin extension point
    that is invoked before OpenTelemetry SDK configuration.

0.5.1-beta.1

30 Nov 11:14
v0.5.1-beta.1
73ea672
Compare
Choose a tag to compare
0.5.1-beta.1 Pre-release
Pre-release

This beta release is built on top of OpenTelemetry .NET:

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_LIMIT for otlp exporter.

Changed

  • Updated Core components: 1.4.0-beta.3
  • Updated plugins method signature to overwrite OpenTelemetry .NET SDK exporters' and instrumentations' options. ConfigureOptions changed to ConfigureTracesOptions, ConfigureMetricsOptions or ConfigureLogsOptions.