RELEASENOTES.md

Release Notes

This file contains highlights and announcements covering all components. For more details see CHANGELOG.md files maintained in the root source directory of each individual package.

1.10.0

• Bumped the package versions of System.Diagnostic.DiagnosticSource and other Microsoft.Extensions.* packages to 9.0.0.

• Added support for new APIs introduced in System.Diagnostics.DiagnosticSource 9.0.0:

  • InstrumentAdvice<T>

  • Gauge<T>

  • ActivitySource.Tags (supported in OtlpExporter & ConsoleExporter)

• Experimental features promoted to stable:

  • CardinalityLimit can now be managed for individual metrics via the View API. For details see: Changing cardinality limit for a Metric.

  • The overflow attribute (otel.metric.overflow) behavior is now enabled by default. The OTEL_DOTNET_EXPERIMENTAL_METRICS_EMIT_OVERFLOW_ATTRIBUTE environment variable is no longer required. For details see: Cardinality Limits.

• Added OpenTelemetrySdk.Create API for configuring OpenTelemetry .NET signals (logging, tracing, and metrics) via a single builder. This new API simplifies bootstrap and teardown, and supports cross-cutting extensions targeting IOpenTelemetryBuilder.

• Removed out of support net6.0 target and added net9.0 target.

1.9.0

• Exemplars are now part of the stable API! For details see: customizing exemplars collection.

• WithLogging is now part of the stable API! Logging, Metrics, and Tracing can now all be configured using the With style and the builders finally have parity in their APIs.

1.8.0

• TracerProvider sampler can now be configured via the OTEL_TRACES_SAMPLER & OTEL_TRACES_SAMPLER_ARG envvars.

• A new UseOtlpExporter cross-cutting extension has been added to register the OtlpExporter and enable all signals in a single call.

• exception.type, exception.message, exception.stacktrace will now automatically be included by the OtlpLogExporter when logging exceptions. Previously an experimental environment variable had to be set.

1.7.0

• Bumped the package versions of System.Diagnostic.DiagnosticSource and other Microsoft.Extensions.* packages to 8.0.0.

• Added net8.0 targets to all the components.

• OTLP Exporter

  • Updated to use ILogger CategoryName as the instrumentation scope for logs.
  • Added named options support for OTLP Log Exporter.
  • Added support for instrumentation scope attributes in metrics.
  • Added support under an experimental flag to emit log exception attributes.
  • Added support under an experimental flag to emit log eventId and eventName. attributes.

• Added support for the IMetricsBuilder API.

• Added an experimental opt-in metrics feature to reclaim unused MetricPoints which enables a higher number of unique dimension combinations to be emitted. See reclaim unused metric points for more details.