core-1.10.0-rc.1

The following changes are from the previous release 1.10.0-beta.1.

• NuGet: OpenTelemetry v1.10.0-rc.1

  • The experimental APIs previously covered by OTEL1003
    (MetricStreamConfiguration.CardinalityLimit) are now part of the public API
    and supported in stable builds.
    (#5926)

  • Promoted overflow attribute from experimental to stable and removed the
    OTEL_DOTNET_EXPERIMENTAL_METRICS_EMIT_OVERFLOW_ATTRIBUTE environment variable.

    Previous Behavior:
    By default, when the cardinality limit was reached, measurements were dropped,
    and an internal log was emitted the first time this occurred. Users could
    opt-in to experimental overflow attribute feature with
    OTEL_DOTNET_EXPERIMENTAL_METRICS_EMIT_OVERFLOW_ATTRIBUTE=true.
    With this setting, the SDK would use an overflow attribute
    (otel.metric.overflow = true) to aggregate measurements instead of dropping
    measurements. No internal log was emitted in this case.

    New Behavior:
    The SDK now always uses the overflow attribute (otel.metric.overflow = true)
    to aggregate measurements when the cardinality limit is reached. The previous
    approach of dropping measurements has been removed. No internal logs are
    emitted when the limit is hit.

    The default cardinality limit remains 2000 per metric. To set the cardinality
    limit for an individual metric, use the changing cardinality limit for a
    Metric.

    There is NO ability to revert to old behavior.
    (#5909)

  • Exposed a public constructor on Batch<T> which accepts a single instance
    of T to be contained in the batch.
    (#5642)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.10.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.10.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.10.0-rc.1

  • Added direct reference to System.Text.Json for the net8.0 target with
    minimum version of 8.0.5 in response to
    CVE-2024-30105 &
    CVE-2024-43485.
    (#5874,
    #5891)

  • Added support for Instrumentation Scope Attributes (i.e
    ActivitySource.Tags)
    when writing traces to the console.
    (#5935)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.10.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.10.0-rc.1

  • Added support for exporting instrumentation scope attributes from
    ActivitySource.Tags.
    (#5897)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.10.0-rc.1

  • Added direct reference to System.Text.Json for the net8.0 target with
    minimum version of 8.0.5 in response to
    CVE-2024-30105 &
    CVE-2024-43485.
    (#5874,
    #5891)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.10.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.10.0-rc.1

  No notable changes.

  See CHANGELOG for details.

core-1.10.0-beta.1

The following changes are from the previous release 1.9.0.

• NuGet: OpenTelemetry v1.10.0-beta.1

  • 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.
    (#5325)

  • Updated the Microsoft.Extensions.Logging.Configuration and
    Microsoft.Extensions.Diagnostics.Abstractions packages version to
    9.0.0-rc.1.24431.7.
    (#5853)

  • Added support in metrics for histogram bucket boundaries set via the .NET 9
    InstrumentAdvice<T>
    API.

    Note: With this change explicit bucket histogram boundary resolution will
    apply in the following order:

    1. View API
    2. Advice API
    3. SDK defaults

    See #5854
    for details.

  • Added support for collecting metrics emitted via the .NET 9
    Gauge<T>
    API.
    (#5867)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.10.0-beta.1

  • Breaking change: CompositeTextMapPropagator.Fields now returns a
    unioned set of fields from all combined propagators. Previously this always
    returned an empty set.
    (#5745)

  • Optimize performance of TraceContextPropagator.Extract.
    (#5749)

  • Obsoleted the ActivityExtensions.GetStatus and
    ActivityExtensions.SetStatus extension methods. Users should migrate to the
    System.Diagnostics.DiagnosticSource
    Activity.SetStatus
    API for setting the status and
    Activity.Status
    &
    Activity.StatusDescription
    APIs for reading the status of an Activity instance.
    (#5781)

  • Updated System.Diagnostics.DiagnosticSource package version to
    9.0.0-rc.1.24431.7.
    (#5853)

  • Obsoleted the ActivityExtensions.RecordException extension method. Users
    should migrate to the System.Diagnostics.DiagnosticSource
    Activity.AddException
    API for adding exceptions on an Activity instance.
    (#5841)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.10.0-beta.1

  • Updated Microsoft.Extensions.DependencyInjection.Abstractions package
    version to 9.0.0-rc.1.24431.7.
    (#5853)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.10.0-beta.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.10.0-beta.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.10.0-beta.1

  • Breaking change: Non-primitive attribute (logs) and tag (traces) values
    converted using Convert.ToString will now format using
    CultureInfo.InvariantCulture.
    (#5700)

  • Fixed an issue causing NotSupportedExceptions to be thrown on startup when
    AddOtlpExporter registration extensions are called while using custom
    dependency injection containers which automatically create services (Unity,
    Grace, etc.).
    (#5808)

    • Fixed PlatformNotSupportedExceptions being thrown during export when running
      on mobile platforms which caused telemetry to be dropped silently.
      (#5821)

  • Updated Microsoft.Extensions.Hosting.Abstractions package
    version to 9.0.0-rc.1.24431.7.
    (#5853)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.10.0-beta.1

  • Breaking change: Non-primitive tag values converted using
    Convert.ToString will now format using CultureInfo.InvariantCulture.
    (#5700)

  • Fixed PlatformNotSupportedExceptions being thrown during export when running
    on mobile platforms which caused telemetry to be dropped silently.
    (#5821)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.10.0-beta.1

  • Updated Microsoft.Extensions.Hosting.Abstractions package
    version to 9.0.0-rc.1.24431.7.
    (#5853)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.10.0-beta.1

  No notable changes.

  See CHANGELOG for details.

coreunstable-1.9.0-beta.2

• NuGet: OpenTelemetry.Exporter.Prometheus.AspNetCore v1.9.0-beta.2

  • Fixed a bug which lead to empty responses when the internal buffer is resized
    processing a collection request
    (#5676)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Prometheus.HttpListener v1.9.0-beta.2

  • Fixed a bug which lead to empty responses when the internal buffer is resized
    processing a collection request
    (#5676)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Shims.OpenTracing v1.9.0-beta.2

  No notable changes.

  See CHANGELOG for details.

core-1.9.0

For highlights and announcements pertaining to this release see: Release Notes > 1.9.0.

The following changes are from the previous release 1.9.0-rc.1.

• NuGet: OpenTelemetry v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.9.0

  • Breaking change: Revert space character encoding change from + to %20
    for baggage item values from #5303
    (#5687)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.9.0

  No notable changes.

  See CHANGELOG for details.

coreunstable-1.9.0-beta.1

• NuGet: OpenTelemetry.Exporter.Prometheus.AspNetCore v1.9.0-beta.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Prometheus.HttpListener v1.9.0-beta.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Shims.OpenTracing v1.9.0-beta.1

  No notable changes.

  See CHANGELOG for details.

core-1.9.0-rc.1

The following changes are from the previous release 1.9.0-alpha.1.

• NuGet: OpenTelemetry v1.9.0-rc.1

  • The experimental APIs previously covered by OTEL1000
    (LoggerProviderBuilder AddProcessor & ConfigureResource extensions, and
    LoggerProvider ForceFlush & Shutdown extensions) will now be part of the
    public API and supported in stable builds.
    (#5648)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.9.0-rc.1

  • The experimental APIs previously covered by OTEL1000 (LoggerProvider,
    LoggerProviderBuilder, & IDeferredLoggerProviderBuilder) will now be part
    of the public API and supported in stable builds.
    (#5648)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.9.0-rc.1

  • The experimental APIs previously covered by OTEL1000
    (LoggerProviderBuilder AddInstrumentation & ConfigureServices extensions
    and IServiceCollection.ConfigureOpenTelemetryLoggerProvider extension) will
    now be part of the public API and supported in stable builds.
    (#5648)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.9.0-rc.1

  • The experimental APIs previously covered by OTEL1000
    (LoggerProviderBuilder.AddConsoleExporter extension) will now be part of the
    public API and supported in stable builds.
    (#5648)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.9.0-rc.1

  • The experimental APIs previously covered by OTEL1000
    (LoggerProviderBuilder.AddInMemoryExporter extension) will now be part of
    the public API and supported in stable builds.
    (#5648)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.9.0-rc.1

  • The experimental APIs previously covered by OTEL1000
    (LoggerProviderBuilder.AddOtlpExporter extension) will now be part of the
    public API and supported in stable builds.
    (#5648)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.9.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.9.0-rc.1

  • The experimental APIs previously covered by OTEL1000
    (OpenTelemetryBuilder.WithLogging method) will now be part of the public API
    and supported in stable builds.
    (#5648)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.9.0-rc.1

  No notable changes.

  See CHANGELOG for details.

coreunstable-1.9.0-alpha.2

• NuGet: OpenTelemetry.Exporter.Prometheus.AspNetCore v1.9.0-alpha.2

  • Fixed issue with OpenMetrics suffixes for Prometheus
    (#5646)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Prometheus.HttpListener v1.9.0-alpha.2

  • Fixed issue with OpenMetrics suffixes for Prometheus
    (#5646)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Shims.OpenTracing v1.9.0-alpha.2

  No notable changes.

  See CHANGELOG for details.

coreunstable-1.9.0-alpha.1

• NuGet: OpenTelemetry.Exporter.Prometheus.AspNetCore v1.9.0-alpha.1

  • Fixed an issue with corrupted buffers when reading both OpenMetrics and
    plain text formats from Prometheus exporters.
    (#5623)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Prometheus.HttpListener v1.9.0-alpha.1

  • Fixed an issue with corrupted buffers when reading both OpenMetrics and
    plain text formats from Prometheus exporters.
    (#5623)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Shims.OpenTracing v1.9.0-alpha.1

  No notable changes.

  See CHANGELOG for details.

core-1.9.0-alpha.1

• NuGet: OpenTelemetry v1.9.0-alpha.1

  • Experimental (pre-release builds only): Exposed ExemplarReservoir as a
    public API and added support for setting an ExemplarReservoir factory
    function when configuring a view (applies to individual metrics).
    (#5542)

  • Fixed a race condition for the experimental MetricPoint reclaim scenario
    (enabled via OTEL_DOTNET_EXPERIMENTAL_METRICS_RECLAIM_UNUSED_METRIC_POINTS)
    which could have led to a measurement being dropped.
    (#5546)

  • Experimental (pre-release builds only): Exposed
    FixedSizeExemplarReservoir as a public API to support custom implementations
    of ExemplarReservoir which may be configured using the
    ExemplarReservoirFactory property on the View API.
    (#5558)

  • The experimental APIs previously covered by OTEL1002 (Exemplar,
    ExemplarFilterType, MeterProviderBuilder.SetExemplarFilter,
    ReadOnlyExemplarCollection, ReadOnlyFilteredTagCollection, &
    MetricPoint.TryGetExemplars) will now be part of the public API and
    supported in stable builds.
    (#5607)

  • Fixed the nullable annotations for the SamplingResult constructors
    to allow null being supplied as attributes or traceStateString
    which has always been supported.
    (#5614)

  • The ExemplarFilter used by SDK MeterProviders for histogram metrics can
    now be controlled via the experimental
    OTEL_DOTNET_EXPERIMENTAL_METRICS_EXEMPLAR_FILTER_HISTOGRAMS environment
    variable. The supported values are: always_off, always_on, and
    trace_based.
    (#5611)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.9.0-alpha.1

  • Breaking change: Fix space character encoding from + to %20
    for baggage item values when propagating baggage as defined in
    W3C Baggage propagation format specification.
    (#5303)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.9.0-alpha.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.9.0-alpha.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.9.0-alpha.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.9.0-alpha.1

  • User-Agent header format changed from
    OTel-OTLP-Exporter-Dotnet/{NuGet Package Version}+{Commit Hash}
    to OTel-OTLP-Exporter-Dotnet/{NuGet Package Version}.
    (#5528)

  • Implementation of OTLP
    specification
    for propagating Span and SpanLink flags containing W3C trace flags and
    parent_is_remote information.
    (#5563)

  • Introduced experimental support for automatically retrying export to the otlp
    endpoint by storing the telemetry offline during transient network errors.
    Users can enable this feature by setting the
    OTEL_DOTNET_EXPERIMENTAL_OTLP_RETRY environment variable to disk. The
    default path where the telemetry is stored is obtained by calling
    Path.GetTempPath()
    or can be customized by setting
    OTEL_DOTNET_EXPERIMENTAL_OTLP_DISK_RETRY_DIRECTORY_PATH environment
    variable.
    (#5527)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.9.0-alpha.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.9.0-alpha.1

  • Reverted obsoletion of OpenTelemetryBuilder.
    (#5571)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.9.0-alpha.1

  No notable changes.

  See CHANGELOG for details.

core-1.8.1

OpenTelemetry

• Fixed an issue in Logging where unwanted objects (processors, exporters, etc.)
  could be created inside delegates automatically executed by the Options API
  during configuration reload.
  (#5514)

OpenTelemetry.Exporter.OpenTelemetryProtocol

• Fix native AoT warnings in OpenTelemetry.Exporter.OpenTelemetryProtocol.
  (#5520)