core-1.10.0

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

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

• NuGet: OpenTelemetry v1.10.0

  • Promoted the MetricPoint reclaim feature for Delta aggregation temporality
    from experimental to stable.
    (#5956)

    Previous Behavior:
    The SDK maintained a fixed set of MetricPoints which were assigned on a
    first-come basis based on the tags. MetricPoint reclaim was an experimental
    feature users could opt-into setting the environment variable
    OTEL_DOTNET_EXPERIMENTAL_METRICS_RECLAIM_UNUSED_METRIC_POINTS=true.

    New Behavior:
    MetricPoint reclaim is now enabled by default when Delta aggregation
    temporality is used without the need to set an environment variable. Unused
    MetricPoints will automatically be reclaimed and reused for future
    measurements. There is NO ability to revert to the old behavior.

  • Updated the Microsoft.Extensions.Logging.Configuration and
    Microsoft.Extensions.Diagnostics.Abstractions package versions to
    9.0.0.
    (#5967)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.10.0

  • Updated System.Diagnostics.DiagnosticSource package version to
    9.0.0.
    (#5967)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.10.0

  • Updated Microsoft.Extensions.DependencyInjection.Abstractions package
    version to 9.0.0.
    (#5967)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.10.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.10.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.10.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.10.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.10.0

  • Updated Microsoft.Extensions.Hosting.Abstractions package
    version to 9.0.0.
    (#5967)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.10.0

  No notable changes.

  See CHANGELOG for details.

coreunstable-1.10.0-beta.1

The following changes are from the previous release 1.9.0-beta.2.

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

  • Added meter-level tags to Prometheus exporter
    (#5837)

  • Updated OpenTelemetry core component version(s) to 1.10.0.
    (#5970)

  See CHANGELOG for details.

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

  • Added meter-level tags to Prometheus exporter
    (#5837)

  • Updated OpenTelemetry core component version(s) to 1.10.0.
    (#5970)

  See CHANGELOG for details.

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

  • Fixed an issue causing all tag values added via the ISpanBuilder API to be
    converted to strings on the ISpan started from the builder.
    (#5797)

  • Updated OpenTelemetry core component version(s) to 1.10.0.
    (#5970)

  See CHANGELOG for details.

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.